Troubleshooting

Common errors

Match the console error to the fix.

• You lack the required entitlement
  the server's license key was made on a different Cfx.re account than the purchase. Generate the key on the buying account at portal.cfx.re and restart. Also appears right after buying until the server is restarted.
• Failed to verify protected resource
  the encrypted .fxap file is corrupt or was modified. Re-upload in binary mode (or SFTP), or delete the folder and re-download a fresh copy from the portal.
• attempt to index a nil value (global 'exports') / No such export
  a dependency is missing, started too late, or a resource folder was renamed. Check server.cfg order and folder names against the install section.
• Database errors on start
  oxmysql is not started before the resource, the mysql_connection_string is wrong, or the SQL from the resource's install.sql was never imported.
• Items unusable or cards/items stack
  the item definitions from install/ were not merged into your inventory, or the server was not fully restarted after merging them.
• UI does not open or shows black
  an old server artifact or a client cache problem. Update to a recent recommended artifact and have the player clear their FiveM cache.

Start with logs

Collect the server console output and client F8 errors before opening a ticket — the exact error text is the fastest path to a fix.

Support request checklist

A complete support message gets solved faster.

1. Script name and version.
2. Framework and inventory.
3. Exact error text from the console or F8.
4. Steps to reproduce.
5. Relevant config snippet with secrets removed.