Players are stuck on the loading screen
If the loading screen never disappears, loadscreen_manual_shutdown is set but nothing ever calls the shutdown. Either remove that directive so FiveM closes the screen automatically, or make sure the resource that was meant to close it is actually running.
The screen shows but never goes away, or players hang at a percentage. This is usually the shutdown directive or a script error — not the design itself.
Work through these in order
- 01
Check loadscreen_manual_shutdown
With manual shutdown enabled, FiveM waits for an explicit shutdown call instead of closing the screen when the session is ready. If nothing calls it, players sit on the screen forever. Remove the directive unless you specifically need manual control.
-- fxmanifest.lua loadscreen 'https://fivemloadingscreen.pro/s/your-slug' loadscreen_manual_shutdown 'yes' -- remove this line if players get stuck - 02
Separate “stuck on the screen” from “stuck joining”
If the progress bar reaches the end and the screen stays, it is the loading screen. If players hang partway with the console still streaming, the server is still loading resources and the screen is only what they happen to be looking at — look at your resource load times instead.
- 03
Look for client-side script errors
Press F8 on the client while stuck. A red error from a resource that runs during connect can stall the join sequence. Fix that resource — the loading screen is a symptom, not the cause.
- 04
Rule out a heavy background
A very large video background or a slow external URL can make the screen appear frozen on lower-end machines. Try a plain colour or gradient background temporarily; if the problem disappears, compress the video or switch to a hosted YouTube background.
Common questions
The loading bar finishes but nothing happens — what now?
That points squarely at loadscreen_manual_shutdown with no shutdown call. Remove the directive and restart.
Is a big video background making people stuck?
It can make joining feel much slower on weak hardware. Keep videos under roughly 10 MB, or use a YouTube background which streams instead of downloading in one go.
Want a loading screen you never have to debug?
Build it in the browser, export once, and edit it whenever — no HTML, no re-uploads.
Start free