AGN Troubleshooter
FiveM · GTA V support

← Error library

critical confirmed Resource / UI · AGN-KB-RES-0001

Failed to load script — a Lua parse error in a resource file

The message

Failed to load script

One of AGN's scripts has a typo and will not start. Staff have to fix the file.

What you see

  • A whole resource fails to start after a change
  • The console shows the failing file, usually with a line number
  • Everything that resource provides is missing for every player

What usually causes it

  • A syntax error in a hand-edited config file — a missing comma, quote or `end` is the usual one
  • A file saved with a broken encoding
  • A merge that left conflict markers in the file

Worth checking first

  • Read the Lua error: it names the file and the line
  • Check what was edited most recently in that resource
  • Expect more than one — a config edited by hand often has several

Safe steps, one at a time

  • Player-side: nothing; report it if you are the first to notice
  • Staff: fix the named line, then re-check the whole file rather than stopping at the first error
  • Staff: there is no lua binary on this box — use the luaparse-based checker rather than eyeballing it

These are suggestions, not instructions. Do only what you are comfortable with, back up anything important first, and stop if a step does not match what is on your screen. Advice, risk and responsibility.

When to stop and ask staff

Always staff, immediately: a resource that will not load is down for everybody.

Looks like

AGN resource / QBCore

What staff will need

  • Exact console error with file and line
  • Resource name
  • What was changed and when

Last reviewed Fri Sep 18.

Source documentation