How to actually find what is crashing your server
Crashes feel random and almost never are. There are four questions that identify the cause in nearly every case, and asking them in order is much faster than reinstalling things until it stops.
#Client crash or server crash?
They look the same to players and have nothing in common. If everyone is disconnected at once and the server console stops, the server crashed. If one person gets the FiveM crash dialog while everyone else keeps playing, that is a client crash.
| Evidence | Conclusion |
|---|---|
| Everyone disconnects simultaneously | Server process died — check the console tail |
| One player, FiveM error dialog | Client crash — usually a streamed asset |
| Everyone at the same place on the map | A specific MLO or streamed model |
| Everyone doing the same action | A script — find it by what the action triggers |
| Random, one player, always the same player | Their GTA install or their mods, not your server |
#The client crash dialog
FiveM shows a crash reason and a dump id. The reason is often more useful than people assume, even when it looks like noise.
- A crash naming a .ytd or a .ydr is a streamed asset. The name is usually in the message — that is your answer.
- A crash in gta-core or citizen-resources with no asset name is more often a pool exhaustion or a script doing something invalid.
- Repeated crashes at the same coordinates point at map content, not scripts.
- "Failed to load" during connection is a download or cache problem, not a crash at all.
#Bisection: finding the resource
When you cannot tell which resource is responsible, stop guessing and bisect. With 64 resources this takes six restarts, not sixty-four.
- 01 Confirm you can reproduce it
If you cannot make it happen on demand, you cannot test a fix. Find the trigger first.
- 02 Halve the resource list
Comment out half your ensure lines. Restart. Reproduce.
- 03 Follow the crash
Crash still happens: the cause is in the running half. It stops: the cause is in the half you removed.
- 04 Repeat on that half
Six iterations covers 64 resources.
- 05 Verify
Start the suspect on its own with the framework and confirm the crash returns.
#Server crashes
The server writes the reason to the console immediately before dying. If you run it in a window that closes, you never see it — which is why running under txAdmin, systemd or tmux is not optional on a real server.
- An unhandled Lua error will not usually kill the server; it kills the resource. If the whole process dies, look for native misuse or a memory problem.
- Out of memory on a 32-bit-limited component shows as an abrupt exit with no Lua error at all.
- A stack overflow from infinite recursion in a script does take the process down.
- Repeated crashes at a fixed interval point at a timer — something on a schedule.
# keep the last 2000 lines when it dies
FXServer.exe +exec server.cfg > server.log 2>&1
# then read the end of it
tail -n 200 server.log#The usual causes, ranked
| Cause | How it presents |
|---|---|
| Duplicate streamed file names | Random client crashes near specific content |
| A corrupt or badly converted model | Consistent crash on spawning one vehicle or entering one interior |
| Game build too low for the content | Missing models, then a crash when something references them |
| Pool exhaustion | Crash after the server has been up a while, worse with more players |
| A resource looping without Wait | Client freeze rather than a clean crash |
| Stale client cache after an update | Only affects players who have played before, not new ones |
#What crash dumps can and cannot tell you
A minidump contains the call stack at the moment of the crash. That reliably identifies the subsystem — streaming, script runtime, rendering — and it identifies a named asset when one is involved.
It does not tell you which resource shipped that asset, and it cannot tell you which Lua line was responsible, because the Lua runtime is several frames below the native crash. Use the dump to narrow the area, then bisect for the resource.
Questions
Only one player crashes. Is it my server?
The server crashes every few hours with no error. What now?
Can a minimap resource crash the game?
Ready to pick a map?
Twelve themes on three base map styles, $8 each, instant download.