Home

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
KD Loadingscreen: a cinematic slideshow of Los Santos with the server name, a tips card and a progress bar
Slideshow with a Ken Burns effect, tips, a welcome line and the real loading status at the bottom.

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.

Open full screen (opens in a new tab)

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.

  1. Download

    Download the ZIP, unpack it and put kd_loadingscreen in your resources folder.

    Download for free
  2. Remove the old one

    Stop or remove any other loading screen, for example esx_loadingscreen or qb-loading. Only one can be active.

  3. Start the resource

    Add it to your server.cfg:

    cfg
    ensure kd_loadingscreen
  4. Make it yours

    Edit web/config.js with your server name, colours, images and links.

  5. 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.

Star on GitHub (opens in a new tab)

Configuration

The look lives in web/config.js, the behaviour in config.lua. That is all of it.

web/config.js · the look

OptionWhat it does
serverName, taglineHeadline and subtitle
logoPath to your logo, e.g. img/logo.png. Leave empty to use the badge text
accentMain colour as hex, e.g. #ff6a3d
slidesYour background images, each with an optional caption and sub
slideDuration, transitionDurationTiming in milliseconds
transitionfade, zoom, wipe, blur or mix
kenBurns, shufflePan/zoom effect and random slide order
tips, tipTitle, tipDurationRotating tips. An empty list hides the card
linksButtons top-right. Icons: web, discord, tiktok, youtube, store
musicBackground music (see below)
welcome, welcomeFallbackWelcome text. {name} becomes the player's name
showPlayerCount, showStatus, creditToggle the online count, status line and credit

config.lua · the behaviour

OptionDefaultWhat it does
Config.FadeOutTime1200Length of the fade-out in ms
Config.FallbackSeconds20Closes the screen this many seconds after the player is active, in case playerSpawned never fires. 0 disables it
Config.GameFadeIntrueFades the game in from black afterwards
Config.HandovertrueSends the player's name and online count to the screen

Your own images

Drop your images in web/img/ and list them under slides:

js
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.

js
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:

lua
-- 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.