Wrong version or unsupported server software

Which server software and game versions each agent supports, and what to do when your version is not listed.

TroubleshootingUpdated 2 min read

Each agent is built for specific server software and versions. The authoritative list, with what each build was tested on, is Agent versions: see the Works with and Verified on columns.

Common mismatches

  • Minecraft Java plugin: needs Paper, Purpur or Folia on Minecraft 1.21.4 or newer, or 26.x, and Java 21 or newer. Plain Spigot and CraftBukkit will not load it. Velocity is supported for proxies; BungeeCord and Waterfall are not.
  • Modded Minecraft: the build must match your Minecraft version and loader. There are separate builds for Minecraft 26.2 (Fabric and NeoForge), 1.21.1 (Fabric and NeoForge) and 1.20.1 (Fabric and Forge), each with its own Java requirement (25, 21 and 17). They run on dedicated servers only.
  • Bedrock: the Endstone plugin, not a Java plugin.
  • Hytale: built against the Hytale server API 0.6.8 and needs Java 25. The API is pre-1.0 and changes between releases.
  • FiveM and RedM: the same resource, but pick the right game when creating the server.
  • Rust: Oxide or Carbon must already be installed.

"Verified on" is not a guarantee

An entry marked "Not yet verified" has not been run against that setup. It may work, but we have not confirmed it. If it does not, write to [email protected] with the server software, its version and the status output.

If your version is not supported

Use basic mode for player counts and uptime in the meantime, and watch the changelog and Agent versions for a new build.

Related

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.Getting startedInstall the agent for your gameWhich install route each game uses (plugin, mod, sidecar or basic mode) and where the step-by-step guide is.TroubleshootingTroubleshoot by gameThe status command, config file and usual cause for Minecraft, FiveM and RedM, Rust, Hytale and sidecar games.
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.