Free script · v1.0.0
KD Loadingscreen
A clean, cinematic loading screen for FiveM. Smooth transitions, a progress bar that follows the game's real loading, and everything set up in one file. The first thing your players see should look good.
ZIP from GitHub · MIT license
Like the script? Give it a ⭐ on GitHub. It costs nothing and helps other people find it.
- ESX
- QBCore
- Qbox
- Standalone
- 1080p → 4K
- Lua 5.4
- 4transitions
- 1config file
- 0dependencies
- 4Kand ultrawide
Try it live
This is the real loading screen running in your browser with a simulated load. Click the dots, use the arrow keys and watch the transitions change.
In the game, the progress and status come from FiveM's own loading events, and the name is the player's own.
What you get
Everything that makes the first seconds on your server feel polished.
-
Cinematic slideshow
A slow Ken Burns pan and zoom on every image, with letterbox, vignette and film grain.
-
Four transitions
Fade, zoom, a diagonal wipe with a light streak, and blur. Pick one or let mix shuffle them.
-
Real loading progress
Taken from the game's own loading events and smoothed, so it never jumps or freezes.
-
Live status line
Shows what the game is doing right now: "Loading the map", "Joining the session" and so on.
-
Personal welcome
The player's name in the headline, plus the current player count.
-
Rotating tips
A tips card with a timer bar. Great for rules, your Discord and good advice.
-
Captions and dots
A location caption for every slide and clickable slide dots.
-
Buttons for your links
Website, Discord, TikTok, YouTube and store open in the player's browser.
-
Music (optional)
Background music with a mute button. Players can also press Space.
-
Smooth hand-off
Fades out and into the game instead of a hard cut.
-
Any resolution
Scales from 1080p to 4K and ultrawide.
-
Works everywhere
ESX, QBCore, Qbox and standalone. No dependencies.
Installation
Five steps and it is running.
-
Download
Download the ZIP, unpack it and put kd_loadingscreen in your resources folder.
Download for free -
Remove the old one
Stop or remove any other loading screen, for example esx_loadingscreen or qb-loading. Only one can be active.
-
Start the resource
Add it to your server.cfg:
ensure kd_loadingscreen -
Make it yours
Edit web/config.js with your server name, colours, images and links.
-
Restart
Restart the server. Changes only show up for players who connect after the restart.
Open web/index.html in your browser to preview your changes without joining the server. It runs a fake load so you can see everything move.
Running it on your server?
Like the script? Give it a ⭐ on GitHub. It costs nothing and helps other people find it.
Configuration
The look lives in web/config.js, the behaviour in config.lua. That is all of it.
web/config.js · the look
| Option | What it does |
|---|---|
serverName, tagline | Headline and subtitle |
logo | Path to your logo, e.g. img/logo.png. Leave empty to use the badge text |
accent | Main colour as hex, e.g. #ff6a3d |
slides | Your background images, each with an optional caption and sub |
slideDuration, transitionDuration | Timing in milliseconds |
transition | fade, zoom, wipe, blur or mix |
kenBurns, shuffle | Pan/zoom effect and random slide order |
tips, tipTitle, tipDuration | Rotating tips. An empty list hides the card |
links | Buttons top-right. Icons: web, discord, tiktok, youtube, store |
music | Background music (see below) |
welcome, welcomeFallback | Welcome text. {name} becomes the player's name |
showPlayerCount, showStatus, credit | Toggle the online count, status line and credit |
config.lua · the behaviour
| Option | Default | What it does |
|---|---|---|
Config.FadeOutTime | 1200 | Length of the fade-out in ms |
Config.FallbackSeconds | 20 | Closes the screen this many seconds after the player is active, in case playerSpawned never fires. 0 disables it |
Config.GameFadeIn | true | Fades the game in from black afterwards |
Config.Handover | true | Sends the player's name and online count to the screen |
Your own images
Drop your images in web/img/ and list them under slides:
slides: [
{ src: 'img/my-shot.jpg', caption: 'Vinewood Hills', sub: 'Where the money lives' },
],
transition: 'mix', // 'fade' | 'zoom' | 'wipe' | 'blur' | 'mix'
accent: '#ff6a3d', // progress bar, highlights, buttons
Keep them around 1920×1080 JPGs at 200–500 KB each. Players download the loading screen before anything else, so huge PNGs make it load slower.
Music
Put an .mp3 in web/music/ and turn music on. Only use music you have the rights to.
music: {
enabled: true,
file: 'music/music.mp3',
volume: 0.2, // 0.0 - 1.0
startMuted: false,
},
How it closes
The screen fades out when the player spawns (playerSpawned, which ESX, QBCore and spawnmanager all fire). If you use a custom spawn or character selector, you can close it yourself:
-- client side
TriggerEvent('kd_loadingscreen:close')
-- or
exports.kd_loadingscreen:Close()
If nothing closes it, Config.FallbackSeconds takes over.
FAQ
The most common questions. Missing an answer? Ask on Discord.
The old loading screen still shows
Another resource with loadscreen in its fxmanifest.lua is still running. Remove it from server.cfg.
My changes don't show up
Restart the server and reconnect. Clearing the FiveM cache (%localappdata%/FiveM/FiveM.app/data/cache) can help too.
The player name says "Welcome to the city"
The name comes from the server during connect. Make sure Config.Handover = true and that the resource is started (ensure), not only present.
Stuck on the loading screen after spawning
Your spawn system probably doesn't fire playerSpawned. Call TriggerEvent('kd_loadingscreen:close') after your character has spawned, or lower Config.FallbackSeconds.
Can I change it and use it on my server?
Yes. It is MIT licensed: use it, change it and share it. Keeping the small credit on screen (credit: true) is appreciated but not required.
Make a great first impression
Free and open source under the MIT license. Use it, change it, share it. Need a fully custom loading screen? Message me on Discord. Like the script? Give it a ⭐ on GitHub. It costs nothing and helps other people find it.