Loading Screen — Common Errors & FAQ
Have a question or encounter an issue while running fs_loadingscreen? Check the common questions and error solutions below.
❓ Q: Hosted background video is not playing or shows a black screen?
Cause
This usually happens if the video link is invalid, not direct, or if LocalVideo = true is set while using an external URL.
Solution
- Open
fs_loadingscreen/config/config.lua. - Ensure
LocalVideo = falsewhen using hosted video links. - Check
Video.Type(use"fivemanage"or"streamable"). - Verify that the video link in
Video.Linksis a direct link ending in.mp4or.webm.
❓ Q: Local video is not displaying on the loading screen?
Cause
FiveM browser runtime only supports .webm format for local video assets. .mp4, .avi, or .mov files will not render locally.
Solution
- Convert your local video from
.mp4to.webmformat. You can convert your video online for free using Clideo MP4 to WEBM Converter. - Place the
.webmfile insidefs_loadingscreen/web/videos/. - Set
LocalVideo = trueand updateFile = "web/videos/yourvideo.webm"inconfig.lua.
❓ Q: Audio tracks are not playing sound?
Cause
The audio file path in Audio array does not match the actual file name or is not in .mp3 format.
Solution
- Place
.mp3audio files insidefs_loadingscreen/web/audio/. - Ensure
File = "web/audio/song.mp3"matches the exact filename inconfig.lua.
💬 Need More Help?
If your issue or question isn't listed here, feel free to open a ticket in our official Discord community:
