> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nexdev.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Fixes for common NEX Loading Screen issues.

| Problem                                                                                   | Fix                                                                                                                                                                                                                                                  |
| ----------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 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 — the resource guards every UI write behind a shutdown flag specifically for this, but a single warning can still slip through under unusual timing.                                                                |

## Before opening a support ticket

Please include:

1. Your FiveM artifact build number.
2. F8 console output filtered for `[nex_loadingscreen]` (or any errors mentioning it).
3. Whether the issue is reproducible from a fresh resource start.
4. If audio/video-related: the file paths from `Config.Songs` and a `dir html/assets/audio` listing so we can confirm the files exist.

See [Support & contact](/general/support) for how to reach us.