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
2 Dec 29, 2021
3 Sep 03, 2021
0 Oct 02, 2022
7 Oct 25, 2022
2 Dec 13, 2021
5 Nov 09, 2022
112 Dec 29, 2022
3.1k Jan 04, 2023
1 Nov 19, 2021
5 Apr 27, 2022
2 Jul 22, 2022
2 Jun 10, 2022
10 Oct 05, 2022
4 Nov 29, 2021
2 Nov 09, 2022
98 Dec 27, 2022
1 May 23, 2022
1 Feb 01, 2022
8 Feb 28, 2022