Server Activation

Every server needs its own RazeScripts activation, even when access was granted manually or as a complimentary copy. Manual access skips Stripe billing; it does not skip server licensing.

1. Create a one-time code

Sign in to RazeScripts and open:

Account → Server Activations

Choose Raze_NPCAI, enter a name for the server, and create an activation code. The code expires after a short time and works once.

2. Put the code on the server

Either add this above ensure Raze_NPCAI in server.cfg:

set raze_npcai_activation_code "RZ-XXXX-XXXX-XXXX"

or put it in config/server_config.json under:

RazeScriptsLicense → ActivationCode

3. Start the resource

On the first successful start, Raze_NPCAI exchanges the one-time code for a server-bound activation token. The token is saved in:

config/license_state.json

After that, normal restarts do not need a new code. The original one-time code is already spent, so you can remove it from server.cfg or clear ActivationCode after you see:

[Raze_NPCAI] License established.

Do not share license_state.json. The activation is also tied to the FiveM server fingerprint and, when enabled by RazeScripts, the public server IP.

Heartbeats and revocation

The resource checks RazeScripts regularly. If the subscription/manual entitlement expires or the server activation is revoked, new NPC voice sessions are blocked and an active conversation is closed on the next license check.

A short offline grace exists for a temporary RazeScripts/API outage. A real 4xx denial such as a revoked activation, expired entitlement or wrong server binding is not hidden behind that grace period.

Moving the resource to another server

If you move to a different VPS, Cfx.re license key or public IP, open Server Activations, revoke the old server and create a new code for the new server. Do not copy the old license_state.json to a different server and expect it to authorize.