WatonAPI
Python API for WatonPlugin
WatonAPI is an API used to connect to spigot servers with the WatonPlugin to communicate. You can send messages to the server and read messages, making it useful for cross-chat programs.
Some examples of possible use cases are:
- Minecraft Chat CLI
- Cross Chat Discord Bot
And many more
Installation
WatonAPI is available on PyPi, so you can install it with pip
pip install watonapi
How to use
Documentation will be released soon
WatonAPI is an async library, meaning that it has to be run with asyncio. You can look in the examples directory to find example programs using the WatonAPI.
CLI Example
{packet['content']}") elif packet["type"] == "player_join": print(f"{packet['user']} joined the game!") elif packet["type"] == "player_leave": print(f"{packet['user']} left the game!") input_handler.cancel() # If it gets to here, the connection was lost print("Lost Connection") server = Server(server_ip) # Create a server object using the server ip asyncio.run(main(server)) # Run the main function ">
from watonapi.server import * import asyncio server_ip = "" token = "" async def async_input(): return await asyncio.get_event_loop().run_in_executor(None, input) async def take_input(server): while True: msg = await async_input() await server.send_msg('Waton CLI', msg) # When input is received, send it to the server async def main(server): await server.add_listener("minecraft_msg") # Begin listening for a "minecraft_msg" packet await server.add_listener("player_join") # Begin listening for a "player_join" packet await server.add_listener("player_leave") # Begin listening for a "player_leave" packet authorized = False try: # If this doesn't fail, the token was correct and the connection authorized authorized = await server.connect(token) except Exception as e: print(f"Couldn't connect to server ( ERROR: {e} )") if authorized: input_handler = asyncio.create_task(take_input(server)) # Start an async task to get user input async for packet in server.get_listeners(): # Get all of the packets that we are listening for if packet["type"] == "minecraft_msg": print(f"<{packet['user']}> {packet['content']}") elif packet["type"] == "player_join": print(f"{packet['user']} joined the game!") elif packet["type"] == "player_leave": print(f"{packet['user']} left the game!") input_handler.cancel() # If it gets to here, the connection was lost print("Lost Connection") server = Server(server_ip) # Create a server object using the server ip asyncio.run(main(server)) # Run the main function
12 Dec 24, 2022
3 Apr 28, 2022
145 Dec 30, 2022
11 Dec 17, 2022
47 Dec 19, 2022
20 Dec 30, 2022
3 Nov 28, 2021
157 May 24, 2022
2 Nov 4, 2021
16 Nov 30, 2022
1 Dec 31, 2021
1 Oct 29, 2021
3 May 19, 2022
3 Sep 14, 2021
6 Nov 04, 2022
127 Dec 23, 2022
1 Jan 21, 2022
320 Dec 22, 2022
1 Oct 26, 2021
4 Mar 29, 2022
6 Oct 21, 2022
1 Dec 12, 2021
39 Oct 30, 2022
428 Jan 08, 2023
26 May 01, 2022
0 Jun 25, 2022
21 Dec 25, 2022
70 Jan 02, 2023
61 Dec 10, 2022