Installation

Troubleshooting

The most common errors when installing or using Codeon Shield and how to fix them.

"No license key found in the .license file"

The .license file is empty or still contains PASTE_YOUR_LICENSE_HERE. Paste your key on a line without # in front and run cs reload.

"License rejected: ..."

  • Bound to another IP: the license is already bound to another host. Ask on our Discord for an IP reset. It binds again on the next start.
  • Expired, suspended or revoked: check the status in Home → My servers or in the General section of your server. Monthly licenses stop working when they expire.
  • Wrong key: make sure you copied the whole key (CS-XXXXXXXX-XXXXXXXX-XXXXXXXX).

"Could not reach the license server"

The server cannot connect to the Codeon Shield API (firewall, network outage...). If it was already authenticated, it keeps working with the last configuration and retries on its own.

"OneSync is disabled"

Add set onesync on to your server.cfg (or enable it in txAdmin). Without OneSync the entity, position and health detections do not work.

Dashboard changes are not applied

The server synchronizes the configuration every 2 minutes. To apply it instantly run cs reload in the console. Also make sure you pressed Save configuration.

/csmenu does nothing

  • Check that the Permission system is enabled for your server in the Dashboard.
  • Check that your identifier is in Staff identifiers (or that you belong to one of the Framework groups) and save.
  • Run cs reload and try again. Players without permissions get no answer from the command, on purpose.

A resource starts again on its own

That is the anti-stop protection: no resource can be stopped while Codeon Shield is running. To apply changes use restart name instead of stop, or stop the server.

Spectate stays on "Connecting..."

The player needs a few seconds to send the first image. If none arrives, the player may have a very slow connection or be on a loading screen. Close the window and try again.

The server shows "Not responding"

The server is online but CodeonShield does not answer: someone stopped it or it failed to start. Check the console and run ensure CodeonShield. The other resources start it again on their own within a few seconds.

A player cannot join: "A valid Rockstar license is required"

The player has no license: identifier (FiveM did not validate their Rockstar account). They have to restart FiveM and try again.