FearlessStudios
FiveM Scripts

Troubleshoot a Script

Find out whether a problem is with startup, player permissions, or a script feature.

Which part failed?

FiveM can’t start the resource

  1. Open the resource folder. Its fxmanifest.lua should be in that folder, not in another folder inside it.
  2. Check that the folder name matches the ensure line in the active server.cfg. Open the script’s guide to check its required dependencies and start order.
  3. After adding a new resource, run refresh in the server console. Start the dependencies first, then the resource. Test on a development server: ensure restarts a resource if it is already running.
  4. If startup still fails, use the first error for that resource. Errors that appear later may only be side effects.

See FiveM’s server commands for the behavior of refresh and ensure.

A command is denied

Find the permission for the exact command or action in the script’s guide. If it uses ACE permissions, granting an ACE to a group does not put a player in that group. Check both the rule and the player’s group assignment. Retest with a staff account and a regular player account; the staff account should pass without opening access to everyone.

FS-Lib reports a version error

These messages come from FS-Lib’s version checker. They tell you about the version check, not whether the other parts of the script work.

Server console saysWhat to do
Current version: Missing or invalid format in fxmanifestThe checker could not read a valid installed version and skipped the lookup. Check that you installed the built resource from the right package. Re-extract that release rather than adding an invented version to the manifest.
Latest version: Failed to fetchThe installed version was readable, but the checker couldn’t look up a release. Note the status or error from the same block. Retest startup and check the release source separately; this message doesn’t prove your installed script is broken or out of date.
The resource is outdatedCompare the installed and latest versions printed above the message. Follow the download link shown in the log, then back up and update the resource.

The resource starts but something fails in-game

Open your script’s guide and choose Troubleshoot. Repeat the smallest possible test. For example, check one pump, one command, or one sign before changing a full config. Check the FiveM F8 console for client errors and the server console for server errors.

Ask for help

In the FearlessStudios Discord, include:

  • The script version, server framework, and integrations involved.
  • The steps that trigger the issue, what you expected, and what happened.
  • The first relevant error and which console it came from.
  • Whether this is a new install or started after an update.

Remove license keys, passwords, tokens, and webhook URLs before sharing logs or configs.