Troubleshoot by game

The status command, config file and usual cause for Minecraft, FiveM and RedM, Rust, Hytale and sidecar games.

TroubleshootingUpdated 2 min read

GameStatus commandConfig fileUsual cause when it does not connect
Minecraft: Paper, Purpur, Foliaserverstats status in the consoleplugins/ServerStats/config.ymlHost blocks outbound 443; code typed in the config but the server not restarted
Minecraft: Velocityserverstats statusplugins/serverstats/config.ymlThe proxy needs its own claim code, separate from the backends
Hytale/serverstats statusmods/ServerStats_ServerStats/config.ymlOutbound 443 blocked; plugin failed to load after a Hytale update
FiveM, RedMserverstats status in the server console (not in-game chat)server.cfg lines set serverstats_claim and ensure serverstatsUsed sets or setr instead of set; resource folder not named serverstats
Rust: Carbon, Oxideserverstats.status in console or RCONcarbon/configs/ServerStats.json or oxide/config/ServerStats.jsonPlugin did not compile (framework out of date); status shows Paused
Sidecar gamesserverstats-sidecar check -c /etc/serverstats/serverstats-sidecar.ymlserverstats-sidecar.ymlGame API disabled or password file unreadable by the serverstats user

Minecraft

  • Spigot and CraftBukkit are not supported; the plugin uses Paper-only APIs. BungeeCord and Waterfall are not supported either; Velocity is.
  • Use a normal restart, not /reload or a plugin manager.
  • On Folia there are no per-tick lag spikes; that is expected.

FiveM and RedM

  • Pick the right game when creating the server; they have separate metric sets.
  • Framework metrics need the standard resource names (qbx_core, qb-core, es_extended, vorp_core, rsg-core, ox_inventory). serverstats status lists what it detected.
  • A refused claim is not retried. Put a new code in serverstats_claim and run ensure serverstats, or run serverstats claim with it.

Rust

  • If the plugin does not compile, update Carbon or Oxide first, especially after a forced Rust update.
  • If a wipe script deletes carbon/data or oxide/data, it deletes the agent's key; claim again.
  • If a typo breaks the JSON, the plugin runs on defaults and does not overwrite your file.

Hytale

  • Skipping pack at ServerStats_ServerStats: missing or invalid manifest.json at startup is harmless.
  • The plugin targets Hytale server API 0.6.8; after a Hytale update, check Agent versions for a newer build.

Sidecar games

  • The sidecar runs on the same Linux machine as the game server and only reads local interfaces. A game API on a non-loopback address is refused unless allow_remote_api: true.
  • Palworld: enable the REST API and set an admin password, and keep port 8212 closed in your firewall.
  • A new claim code on a running sidecar is picked up within 5 seconds: sudo -u serverstats serverstats-sidecar claim SS-XXXX-XXXX-XXXX -c /etc/serverstats/serverstats-sidecar.yml.
  • A panel-only host with no shell cannot run the sidecar; use basic mode.

Per-game install pages with the full steps: install by game.

Related

TroubleshootingThe agent is not sending dataA step-by-step check when the dashboard says waiting, offline or no data: status command, outbound HTTPS, claim, key and plan limits.TroubleshootingClaim code invalid, expired or already usedClaim codes work once and last 30 minutes. How to get a new one, and what wrong_game and a key rejected after moving hosts mean.TroubleshootingUpdate available: how to update an agentWhat the update notices mean, how to update safely and keep the server enrolled, and the alert for outdated agents.
Still stuck? Email [email protected] with the server name and what you see. For a rejected claim code or no data, include the output of the agent’s status command.