Configuration

Configuration lives in two places: plugins/Thorium/config.yml on the server, and per-network settings in the dashboard.

config.yml

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

Key	Default	Meaning
gateway-url	wss://gateway.thorium.ac	Gateway endpoint
server-token	—	Network token from the dashboard, shared by every backend
server-name	—	The dashboard server this backend belongs to
enforce	true	Apply automatic punishments. false observes only. Kicks and bans staff make from the dashboard, API or Discord bot always apply
ban-command	empty	Run this console command to ban instead of the server’s own ban list. %player%, %reason% and %check% are filled in
unban-command	empty	Run this console command when a player is unbanned in the dashboard, e.g. unban %player%. Set it whenever ban-command is set; empty removes them from the server’s own ban list
alert-format		The in-game staff alert line
kick-format		The kick message, unless the dashboard sets one

IP sharing, the kick and ban messages and /report are set per network in the dashboard and override config.yml once the server connects.

Network settings

In Settings, per network:

• Detections — switch individual checks on or off, and set confidence thresholds. See detections.
• Punishment ladders — what happens at each detection count. See ladders.
• Alerts — Discord channel routing and the accuracy threshold below which detections are recorded but not announced.
• Player reports — turn /report on or off, and where reports go. See player reports.
• Kicks and bans — under Settings → Kicks and bans: the Automatic kicks and Automatic bans switches (both off by default, see ladders) and the kick and ban messages, prefilled with the defaults. Use %player%, %check%, %reason%, %vl% and & colour codes.
• Advanced Analytics — logs each player’s blocks mined and placed, kills, deaths, shots and items used, per session, shown under Activity on the player page. Kept indefinitely; how far back you can read follows your plan’s history window. Chat and commands are never recorded.
• IP Heuristic Analysis — on by default. Sends player IPs for alt and ban-evasion detection.

Observation mode

Setting enforce: false is the recommended way to introduce Thorium to an established server. Detections are recorded and visible in the dashboard, but nothing is kicked or banned automatically, so you can calibrate thresholds against your own player base before acting on them. Kicks and bans your staff issue by hand still take effect.