Minecraft RPC

A gRPC interface for Minecraft

Install Java 1.8 (You can check your version with java -version)
- unix: sudo apt-get install openjdk-8-jre
- osx: mkyong.com/java/how-to-install-java-on-mac-osx
Create a folder minecraft-rpc
Download the latest stable spongevanilla 1.12.2 into minecraft-rpc
Download the latest minecraft-rpc jar into minecraft-rpc/mods
Your minecraft-rpc should look like (where xxx are version numbers)

minecraft-rpc/
    spongevanilla-1.12.2-xxx.jar
    mods/
        minecraft-rpc-xxx.jar

Start the server with java -jar spongevanilla-1.12.2-xxx.jar
The first time you start the server you must accept the Minecraft EULA by modifying eula.txt
You should see a bunch of output including [... INFO] [minecraft_rpc]: Listening on 5001. This means it's working and the server is ready for commands on port 5001.

The interface is defined using gRPC. Read the definition at src/main/proto/minecraft.proto

See clients for generated clients and examples

Using the interface definition file you can generate clients for (almost) any programming language you like. See https://grpc.io/docs/languages/

Provide feedback