PROMO Get 10% off any server with code: START Limited-time offer
Ctrl K
DocumentationFiveMTroubleshooting

FiveM — troubleshooting

Typical FiveM server errors and how to fix them.

⏱ 1 min read✏️ Report an issue with this page
On this page

Startup errors

MessageCause and fix
Invalid license keyWrong or inactive Cfx.re key. Generate a new key and enter it under “Startup”.
Couldn't find resourceThe name in ensure differs from the folder name, or the resource is outside resources/.
[oxmysql] … ECONNREFUSED / Access deniedWrong details in mysql_connection_string. Copy them again from the Databases tab.
SCRIPT ERROR: … attempt to index a nil valueA script bug or wrong load order. Make sure the framework starts before the resources that use it.

Player connection problems

  • Server not showing in the list — check sv_hostname and sets tags; the list refreshes with a delay. connect IP:PORT works directly.
  • Long loading / dropping while downloading — streamed assets are too large. Optimize textures (YTD) and split packs up.
  • “Server didn't respond” — the server is off or restarting; check the console and txAdmin.

Performance

In game press F8 and type resmon 1 to see which scripts use the most CPU time. Scripts that stay above ~0.5 ms are worth optimizing or replacing.