| Old loading screen still appears | Another loading-screen resource is still ensured. Only one can be active — remove or comment out the old one in server.cfg and restart the server. |
| Loading screen is blank / no UI | Resource didn’t start. From F8: lua print(GetResourceState('nex_loadingscreen')) should print started. If not, fix server.cfg and restart. Also check the server console for boot errors. |
| Player count / uptime never updates from the placeholder | The stats panel is fed by nex:stats from server.lua. Confirm the resource is started server-side and Config.Stats.enabled = true. The first push can take up to Config.Stats.poll ms (default 5s). |
| Music doesn’t play | Browsers (and FiveM’s NUI) block audio until the user interacts. Tracks autoplay where possible, but if a player joins on a muted device it will look silent. Files must exist at the path in Config.Songs[].song — paths are relative to html/. |
| A song shows “no cover art” | The image path is wrong or the file is missing. Drop the cover under html/assets/images/ and reference it as ./assets/images/name.png. |
| Video background doesn’t play | If using a remote URL, make sure it’s a direct .mp4 link (not an embed/HTML page) and the host returns CORS-friendly headers. Local ./assets/videos/foo.mp4 always works. |
| Theme color change didn’t apply | You restarted the resource, but the player is still mid-load with the old screen. The new theme takes effect the next time a player connects — restart again, or rejoin yourself. |
| Logo / cover art / song change didn’t apply | Same as theme — these are baked into the config payload at connect time. Restart the resource and reconnect. |
| Player gets stuck on “Enter Server” | The playerSpawned event never fired (game crashed during spawn, or something blocked it). Have them disconnect and reconnect. If it’s repeatable, check the F8 console on their machine. |
| Loading screen never shuts down | Config.RequireClick = true requires a click. Set Config.RequireClick = false if you’d rather auto-dismiss. If even auto-dismiss hangs, something is keeping playerSpawned from firing — usually another resource crashing during spawn. |
| F8 console shows “SendLoadingScreenMessage called while the loading screen was shut down” | Cosmetic warning, safely ignored — client.lua guards every NUI write behind a shutdown flag specifically for this, but a single warning can still slip through under unusual timing. |
