Skip to content

๐ŸŽจ 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.