Lightweight Python webserver that provides a REST API for Minecraft servers.
Communicates with Minecraft server by piping stdin.
Pipes stdout and stderr to minecraft-stdout.log and minecraft-stderr.log in the working directory.
python3 mcsw.py [daemonize|stop pidfile] [--auth=auth-file]
- the auth file should contain two lines with the username and password for HTTP basic auth
- if no auth file is specified, no authentication will be performed (e.g. for development)
It is recommended you create a "minecraft" folder (will be ignored by git), put a minecraft_server-run.[jar|sh], and run the wrapper there (cd minecraft, python3 ../mcsw.py [args...]).
There is a client for Gamocosm servers in bin/mcsw-client which is just a helper script for curling the wrapper.
It expects the auth file to be in /opt/gamocosm/mcsw-auth.txt; if it cannot find it, it will use a blank password.
You can read it or modify it for different setups (it is just a shell script).
Examples:
bin/mcsw-client start '{ "ram": "1024M" }'
bin/mcsw-client stop
bin/mcsw-client exec '{ "command": "say hi" }'
- the service file is from Gamocosm; you can tweak it if you're using this separately
- can view its logs with
journalctl -u mcsw
- Flask