Skip to main content

Common Errors

Before diving into specific errors, ensure your server artifacts are up-to-date and that you’ve recently restarted your server, as these steps can resolve many common issues.
If you see this message in your client (F8 console) or server console, it means there’s an issue with your FiveM server license key and its link to the purchased resource on the Cfx.re Keymaster.Cause: All official FiveM resources utilize the FiveM Tebex Escrow System. This system binds purchased assets to the Cfx.re account that bought them. The scripts can only be used on a FiveM server that is using a license key associated with that same Cfx.re account.Solution:
1

Verify Account

Ensure that the FiveM server license key you are using in your server.cfg is generated from, or assigned to, the same Cfx.re account from which the resource was purchased.
2

Check License Key

Double-check that the license key in your server.cfg is correct and active.
3

Confirm Server Authorization

If you are not the server owner, confirm with the person who purchased the script that they have authorized your server (via the license key) to use the asset through the Cfx.re Keymaster.
4

Restart Server

After making any changes to your license key or Keymaster settings, always restart your FiveM server for the changes to take effect.
5

Update Server Software

Ensure your FiveM server artifacts (server software) are up to date. Older versions might have compatibility issues with the escrow system.
These errors usually appear in the client (F8) console or server console and can indicate a few things:Causes & Solutions:

Outdated Server Artifacts

Ensure your FiveM server is running artifacts version 5181 or later. You can download the latest server artifacts from the FiveM documentation (or Linux equivalent).

Corrupted Files During Transfer

  • FTP Client Issues: Some FTP clients (like FileZilla, in some configurations) can corrupt script files during transfer, especially if they alter line endings or don’t transfer hidden files correctly. It’s often recommended to use WinSCP if you’re on Windows and transferring to a Linux server.
  • Best Practice: Transfer the entire resource ZIP file to the server and then extract it directly on the server. Avoid dragging and dropping individual files or folders.
To minimize file corruption risks, always transfer the complete ZIP archive to your server and perform the extraction there. This is generally more reliable than transferring unzipped folders and files, especially with some FTP clients.

Missing .fxap File

Protected resources (escrowed scripts) contain a hidden .fxap file inside their folder (e.g., resourcename/.fxap). If this file is missing or was not transferred, the script will fail to load. Ensure your file transfer method includes hidden files.

Incorrect Resource Naming

Ensure the folder name in your resources directory matches exactly the name you used in your ensure [resource_name] line in server.cfg. Case sensitivity can matter, especially on Linux servers.
This specific syntax error can often be linked to:Causes & Solutions:

File Transfer Issues

As mentioned above, tools like FileZilla can sometimes corrupt script structures. Try re-uploading the resource using WinSCP or by transferring the ZIP and extracting it on the server.

Outdated Server Version

Your server must be running at least FiveM artifacts version 4752 or higher. Ideally, use 5181+ as mentioned before.
This error indicates that files may have been corrupted during transfer, or essential parts of the protected resource are missing.Causes & Solutions:

Hidden Files Not Transferred

The primary culprit is often the .fxap file (a hidden file) inside the resource folder not being transferred. Double-check your FTP client settings to show and transfer hidden files.

File Corruption

Files might have been altered or corrupted. Re-download the resource from Keymaster and re-upload it to your server, preferably as a ZIP file which you then extract on the server.
If you continue to experience issues after trying these solutions, please gather any error messages from your server and client consoles and contact us for support on our Discord server.

Additional Resources