Pickaxx

A standalone web console for managing a Minecraft server instance.

Warning

• This project is archived.
• The code demonstrates a method of safely managing the lifecycle of an external process (in this case, managing Minecraft server instances running as Java processes).
• It can start an existing server and send/receive output through a chat-like interface.
• Authentication is not supported, limiting it to running on a local network only.

The goals of this project were as follows:

• Minimal configuration, sane defaults (drop a server into the tool and go)
• Single binary, small memory footprint
• Basic authentication

1. Install gowatch, packr2 and goreleaser

GO111MODULE=off go get -u github.com/silenceper/gowatch
GO111MODULE=off go get -u github.com/gobuffalo/packr/v2/packr2
wget -O /tmp/goreleaser_amd64.deb https://github.com/goreleaser/goreleaser/releases/download/v0.154.0/goreleaser_amd64.deb
sudo dpkg -i /tmp/goreleaser_amd64.deb

2. Until this tool can bootstrap new Minecraft instances on it's own, manually download server.jar from Minecraft's site (see below), and copy this into the path testserver/server.jar.
3. Run tests (or use make test).
4. Run make which will start the server. Load http://localhost:8080

• This project uses go-watch to run/restart the server.
• Compatible Java runtime (tested on OpenJDK 15.0.1).
• Minecraft server (tested on 1.16.4).