AGN Troubleshooter
FiveM · GTA V support

← All issues

I cannot join AGN

You can start FiveM but cannot get into the server.

●Nothing is sent to AGN unless you choose Submit Report.

What gets checked, and why

  • DNS resolution
  • Latency, jitter and packet loss
  • Reachability of AGN’s published endpoints
  • Adapter type and connection state
  • VPN detection

These checks read information. They change nothing on your computer. Repairs are offered separately, one action at a time, and only after you confirm each one.

Worth answering before you ask for help

  • Do other FiveM servers work right now?
  • What exactly does the message say?
  • Are you on Wi-Fi, a cable, or a VPN?

Known issues in this area (30)

This needs a person, not a diagnostic tool. Please open a ticket and a staff member will pick it up.

If everything else works and only AGN does not, the problem is most likely something we added. Please do not reinstall anything yet — send us the report first.

high Could not find game executable FiveM client
Could not find game executable

FiveM launches the copy of GTA V you already own, and it cannot find that copy.

Error loading component

One of FiveM's own parts would not load. Its list of cached components is stale and needs clearing.

Opening database (privcache:/) failed: IO error: could not lock file

FiveM keeps a small local database. Something else still has hold of it, so FiveM cannot open it.

Starting FiveM, we're getting there

FiveM is being held up during startup, almost always by security software inspecting it.

Stuck on a rotating splash screen

FiveM's saved Rockstar sign-in has gone bad. Clearing those two items makes it sign in fresh.

FiveM uninstalls itself after running it

Something on your PC is removing FiveM after it runs — nearly always security software.

The fastest way to tell whose problem this is: join any other FiveM server for two minutes. If that is fine and AGN is not, it is ours to look at and you should not start reinstalling things.

Archetype registration failed (FreeCount=0)

This one is not your computer. The server ran out of room for the number of different models it was trying to load at once. Your report is genuinely useful because it tells the developers where and when it happened - but there is no setting on your side that will fix it, and you have not done anything wrong.

libcef.dll

This one is not your computer, and there is no setting you can change to avoid it. AGN has televisions and screens placed around the world, and one of them was showing a live stream that the version of the browser built into FiveM cannot play. When your game got close enough to draw that screen, the browser inside FiveM stopped working and took the game with it. Telling staff roughly where you were, or where you spawn, is the single most useful thing you can do, because that is what identifies which screen it was.

FiveM keeps a small database of downloaded server files. Something else is holding that file open, so FiveM cannot use it.

FiveM is made of several files that load at startup. One of them is missing or has been altered — most often by antivirus software being cautious.

high FiveM crashes with a crash ID FiveM client

A crash ID is FiveM's reference for what went wrong. On its own it is not enough — what you were doing when it happened is the other half.

A loading screen that never finishes is usually still working — waiting on files, a slow disk, or a scan — rather than truly frozen.

Your PC tried to reach the AGN server and gave up waiting. That can be your connection or ours — the checks tell us which.

The first time you join, FiveM downloads everything AGN streams. A stall here is usually space, connection, or one specific file.

Being dropped mid-session can be your line, your router, or the server. The timing pattern usually tells us which.

Your game is being sent more information than it can take in at once while it loads. AGN streams a great deal of its own content - vehicles, clothing, interiors - so joining here asks more of your computer and your connection than most servers do. Two settings make this much worse and are worth changing first: Extended Distance Scaling, and High Detail Streaming While Flying. Clearing the FiveM cache also helps, because a half-downloaded asset is read every time you join.

medium Game storage outdated FiveM client
Game storage outdated

FiveM keeps its own copy of some game data. Yours is out of step with the game that is installed.

failed (err = 32)

FiveM tried to replace one of its own files during an update and Windows said the file was in use.

FiveM downloads its own updates from the FiveM project's servers. This step failed, which is usually the connection rather than your game.

FiveM saves server files so you do not download them every time. Occasionally a saved copy goes out of date and needs clearing.

Your PC turns names like agnstaff.com into addresses using a DNS server. That lookup is failing.

The server that hands out AGN's files answered with an error. This one is almost certainly on our side.

The tool pings three things: your own router, your DNS server, and AGN. Reading them together tells you where the trouble begins - inside your house, on your line, or beyond it. A bad reading at your router means there is no point looking further out yet.

This number is the speed between your computer and AGN's server, over one connection. It is not the same as a speedtest.net result and will usually be lower - that is expected, not a fault. What it tells you is whether your connection can pull server content at a sensible rate.

Good news first: to play on AGN you do not need fast internet, and your 4 Mbps upload is fine. What a game needs is a steady, low-delay connection - low ping, little jitter, no dropped packets. Speed only really matters for the first join, when several GB of AGN content download once. The thing that hurts most is delay and instability, and the two biggest causes are satellite delay and WiFi. If you can, plug in an ethernet cable - it is the single biggest fix and usually solves rubber-banding on its own. If a cable cannot reach, a powerline or MoCA adapter (which uses your home wiring) is the next best thing, then 5 GHz WiFi close to the router. On satellite, the type matters: Starlink is usually fine to play on; older dish satellite (Viasat, HughesNet) adds so much delay that gaming will always rubber-band, and the real answer there is a different connection. When you call your ISP, do not just ask for 'faster' - say this: 'I play online games and need the lowest-latency, most stable connection you offer at my address. Is fibre or cable available here? What is the ping and packet loss on my line? Are there data caps I should know about? And I need a setup I can plug into with an ethernet cable.' That tells them exactly what you need. A faster plan on the same delayed or WiFi connection will not fix the lag - low latency and a wired link will. There is also a picture guide for all of this - it shows what an ethernet cable looks like and includes the ISP script to copy - linked on this page under "Source documentation".

The script probably did what you asked but could not tell you so.

Your last session did not shut down fully, so the new one refuses to start alongside it.

Run this on your PC

The Support Assistant runs these same checks locally and writes a report you review before anything leaves your machine.

Download the tool

Already have a report?

Submit it to AGN

Need a person?

Open a ticket