๐จ Customization Guide¶
You customize the look and feel of the loading screen by editing the config.json file located in the html directory of the package. Each area has its own focused page: start here, then jump to the section you want.
๐ Remember: Place any images, videos or audio files inside the
html/assets/folder so they load correctly in the UI.
Quicker in the Config Builder
The Config Builder sets all of this with a live preview, and Build with AI can set it up from a plain description. Every field with its type and default is in the Config reference: selectedColor.
Overall Theme Color¶
Customize the main highlight UI color used across the screen:
"selectedColor": "#ff007b"
Color Format
Accepts hex (#ff007b) and rgb(), rgba(), hsl() or hsla() values. Anything else falls back to the default color.
What You Can Customize¶
| Area | Page |
|---|---|
| ๐ฅ Background (image / video / playlist) | Background |
| ๐ท๏ธ Watermark (server name + logo) | Watermark |
| โจ Title animation | Title Animation |
| ๐งท Social headers & custom icons | Social Headers |
| ๐ Rules panel | Rules Panel |
| ๐ฅ Team panel | Team Panel |
| ๐ผ๏ธ Gallery grid | Gallery Grid |
| ๐งฉ Custom panel | Custom Panel |
| โจ๏ธ Keyboard overlay | Keyboard Overlay |
| ๐ต Music player | Music Player |
YouTube embed requirements & error handling¶
YouTube backgrounds work in FiveM (since v1.3.0). If one will not play, the video owner's settings usually block it: it needs embedding allowed, no age restriction, no region blocks and public or unlisted visibility. When a video fails, the screen moves on to your next video or your music, and falls back to your background image if every video fails.
Full details are on the Background page, and step-by-step fixes in Troubleshooting.