Troubleshooting

Note

More entries will be added as alpha feedback comes in. If your error is not listed, email support@rookhelm.com with the relevant lines from your server log.

Plugin will not load

Log line: [SM] Unable to load plugin "rookhelm.smx"

Check that:

• SourceMod 1.12 or 1.13 is installed at addons/sourcemod/. Older versions are not supported.
• You extracted the whole bundle so its addons/ folder merged with your SourceMod install - the extension (addons/sourcemod/extensions/rookhelm.ext.so) and the companion plugin (addons/sourcemod/plugins/rookhelm.smx) must both be present.
• The files are not corrupted. Re-download the bundle from your dashboard and verify it against SHA256SUMS.

Server does not appear as pending after a restart

After you drop the bundle in and restart, the server should show under Pending servers on your dashboard within about a minute. If it does not:

1. Confirm the two settings are present. If you used the dashboard bundle they are already filled in cfg/sourcemod/rookhelm.cfg, which the plugin loads automatically; if you configured manually, check rookhelm_api_url and rookhelm_enrollment_token are both set and non-empty in server.cfg.
2. Confirm the values match your Servers page. Re-downloading the bundle is the simplest way to get a correct, pre-filled config.
3. Confirm the server can reach RookHelm. The server opens an outbound secure WebSocket to rookhelm_api_url; a firewall that blocks outbound 443 will stop enrollment. Most hosts allow this by default.
4. Check the server log around startup for a RookHelm line describing why the connection was refused (for example, an unknown enrollment token).

If the token was rotated from the dashboard, an old bundle’s token no longer works - download a fresh bundle.

The server is pending but will not come online

A pending server has announced itself but is not yet trusted. Open the Servers page and click Adopt on its card. Only admins and owners can adopt. Adopting delivers the server’s signing key automatically - there is nothing to copy.

The name and address on a pending card are self-reported by the server and are not verified until you adopt, so confirm the address matches the server you expect before adopting.

An adopted server shows offline

What you see: the server was online, and now its status is offline (no heartbeat for more than two minutes).

The server reconnects on its own and re-proves its key after a restart, map change, or network blip, so a brief offline blip usually clears itself. If it stays offline:

• Confirm the game server process is running and reachable.
• Confirm outbound 443 is still open (see above).
• If the server’s signing key was lost or the box was rebuilt, open the server’s page and use Reissue keys. The new key reaches the server on its next reconnect - you never copy it by hand.