Install the plugin

The plugin runs on Spigot, Paper and Folia, from Minecraft 1.8 through the current release, on Java 8 or newer.

1. Register the server

In the dashboard, open Networks, pick the network you want the server to join, and choose Add Server. Registering the server issues the token the plugin authenticates with.

Note

Your plan includes a fixed number of servers. If Add Server reports a plan limit, see plans and billing.

2. Download the jar

Download the latest release from GitHub releases and drop it in your server’s plugins/ folder.

3. Configure it

Start the server once to generate plugins/Thorium/config.yml, or create it yourself. The dashboard’s Set up plugin dialog shows this snippet already filled in with your server’s token:

gateway-url: "wss://gateway.thorium.ac"
server-token: "your-server-token"
enforce: true

Key	Meaning
gateway-url	Where the plugin connects. Leave as the default unless you have been given a different endpoint.
server-token	Identifies this server. Treat it like a password — anyone holding it can report telemetry as your server.
enforce	When true, configured punishments are applied. Set false to observe detections without acting on them.

Caution

Do not commit config.yml to a public repository, and do not reuse one server’s token on another. Rotate a leaked token by deleting the server in the dashboard and adding it again.

4. Restart

Restart the server. On startup the plugin connects to the gateway and logs the result.

5. Confirm

Run /thorium status in game or from console. See verify it is working for what a healthy result looks like and what to do when it is not.