The Creator#
Everything in Loading Screen Creator happens in one window, opened by an admin with /loadingcreator. Running the command again, or pressing Esc, closes it. It has two tabs:
Tab | What it is for |
|---|---|
Design | The editor: your themes on the left, the canvas in the middle, the module stack and the inspector on the right. |
Settings | The theme's server identity — the name, Discord and website its modules print — its description, which theme is live and the theme id. |
Preview, top right, opens the theme at full screen with every animation running and the soundtrack playing. It is the same renderer the game uses, so what you see there is exactly what players get. Esc leaves it.
Changes are a draft until you press Save. Set live saves first if it needs to, then makes that theme the one every connecting player sees.
The Design Tab#
Laid out like a graphics editor:
Where | What is there |
|---|---|
Left | The theme library: the built-in themes and yours, a Live badge on the one players see, Built-in on the shipped ones, and the Import and New theme buttons. |
Toolbar | Theme name, zoom (40–220%), undo and redo, Grid, Safe area, Animations on or off, and the theme's actions: Copy code, Revert, Duplicate, Delete, Save and Set live. |
Centre | The canvas. Click a module to select it, drag to move it, pull its eight handles to resize. Click empty canvas to select the whole screen. |
Top right | Modules: the library to add from, in four groups, and the stack of modules in the theme — show or hide, lock, bring forward, send backward, duplicate and delete. Double-click a name to rename it. |
Bottom right | The inspector: the selected module's properties, or the whole screen's when nothing is selected. |
Shortcuts#
Key | Does |
|---|---|
| Undo. One step per gesture: a whole drag is one step, not one per pixel. |
| Redo. |
| Duplicate the selected module. |
| Delete the selected module. |
| Nudge the selected module by 0.1% of the screen — by 1% with |
| Snap position and size to whole 1% steps. |
| Leave the preview, or close the creator. |
Positions and sizes are percentages of the screen, which is what keeps a design correct at every resolution. A locked module cannot be dragged or nudged by accident — lock the background pieces once they are placed. The canvas plays videos and animations silently; Preview adds the sound.
The Built-in Themes#
Seven finished designs ship inside the interface. Use one as it is or open it and change it: saving a built-in theme keeps your version under the same name, and deleting it later brings the original back.
Theme | Look |
|---|---|
Cinematic | The default. A graded video backdrop framed by 2.34:1 letterbox bars, the server name and a single rule. The soundtrack sits in the left band, the mute in the right, and a hairline progress bar runs along the bottom edge. |
Midnight | Dark, wide and calm. Everything anchored to the corners so the centre stays clean. |
Neon | Centred synthwave: circular progress, scanlines and neon glow, with a visible music player. |
Welcome | A restrained welcome card: one huge word floating over a soft radial glow, the server name in sky blue, and almost nothing else. |
Cyberpunk | A rain-slick night city: black asphalt, a cyan and magenta accent pair, a hard neon rule and terminal cards on a strict three-column grid. |
Aurora | Light and airy. Soft aurora washes on paper, an oversized progress ring and an editorial wordmark on a four-column grid. |
Overdrive | Nothing holds still: counter-rotating halos, a wordmark glitching in three chromatic layers, and a signature that writes itself underneath. |
Duplicate makes an independent copy to experiment on, Revert throws away unsaved changes, and New theme starts from an empty canvas.
Background, Overlay and Soundtrack#
Click empty canvas and the inspector switches to what belongs to the whole loading screen rather than to one module:
Section | What it holds |
|---|---|
Canvas | The design resolution, 1920 × 1080 by default. Nearly every player is on 16:9, and the screen scales to any other size. |
Background | A colour or gradient (solid, linear, radial or conic), an image, a slideshow (fade, slide or Ken Burns zoom) or a video file — with fit, blur, brightness, saturation and grayscale. |
Overlay | A fill painted over the background and under every module, plus a vignette. The quickest way to make text readable over a busy video. |
Soundtrack | A playlist of tracks from |
A video background can play its own sound on top of the soundtrack. Mute one of the two, and add the Sound toggle module: it is a single master mute that silences the video and the music together, and each player's choice is remembered for their next join.
Modules#
A theme is a stack of modules. Add one from the library at the top right and it lands on the canvas, selected and ready to move. Nineteen types, in four groups:
Group | Modules |
|---|---|
Basics | Text · Image · Shape · Icon · Effect |
Loading | Progress bar · Spinner · Server info · Clock |
Content | Tips · News · Rules · Staff · Social links · Countdown |
Media | Music player · Sound toggle · Slideshow · Video |
What every module has#
Section | Settings |
|---|---|
Transform | Name, position and size in % of the screen, rotation, opacity, corner radius and blend mode — 16 of them, from multiply and screen to overlay and luminosity. |
Entrance animation | How it arrives: fade, up, down, left, right, zoom, zoom out, blur or flip, with a delay and a duration. Stagger the delays and the screen builds itself piece by piece. |
Looping motion | What it does after arriving: float, sway, pulse, breathe, spin, wobble, flicker, glitch or shimmer, on its own cycle and delay. Without one, a screen freezes into a still image a second after loading starts. |
Backing panel | An optional card behind the module: fill, border, shadow, background blur for a frosted-glass look, and padding between the content and the edge. |
Text-based modules choose from Poppins, Pacifico, Arial, Georgia, Courier New, Arial Black, Trebuchet MS and Verdana.
Module by module#
Text
Fixed text, or bound to live data: server name, players online, max players, slots, load percentage, the loading status line, date, time, Discord or website — with a prefix and a suffix around it. Font, size, weight, italic, uppercase, letter spacing, line height, a colour or gradient fill, outline, shadow, alignment and a line limit.
Handwriting traces the word as if it were being written, then fills it in. It suits a script font such as Pacifico.
Image
A picture from images/ — a logo, a character render, a badge — with cover, contain or stretch, a border, a shadow, and grayscale, brightness, contrast, saturation and blur filters.
Shape
A rectangle or an ellipse with any fill — solid, linear, radial or conic gradient — a border, a shadow and blur. Bars, glows, frames and dividers are all shapes.
Icon
One of 30 icons — Discord, X, TikTok, Instagram, YouTube, Twitch, Steam, a globe, a shield, a crown, a car, a map and more — in any colour, with a shadow.
Effect
An effect layer over its area: vignette, film grain, scanlines, gradient, glow, particles, stars, rain, sheen or noise, with intensity, speed and two colours.
Progress bar
The real loading progress, read from the game's own loading events and eased so it never sits frozen. Six styles — bar, thin line, neon rail, segmented, dots and ring — with track and bar fills, thickness, stripes, glow, the percentage, and a label that shows the live status line or your own text.
Spinner
Ring, dots, bars, pulse or orbit, in any colour, thickness and speed.
Server info
The server name, players online, slots, Discord and website, in a row or a column, with or without icons.
Clock
The player's local time in 12- or 24-hour format, with optional seconds and date.
Tips
A heading and a list of lines that rotate on an interval, with a fade, rise or slide transition and an optional icon.
News
Entries with a tag, title, body and date, as a list or as cards, with optional auto-scroll when they do not fit.
Rules
A numbered or plain list of rules, in one or more columns.
Staff
Team members with a name, a role and an avatar from images/, in a grid of circle, rounded or square portraits.
Social links
Buttons with an icon and a label — pill, solid, ghost or icon only — laid out in a row, a column or a grid.
Countdown
Days, hours, minutes and seconds to a date you pick — a launch, a wipe, an event night — as blocks or inline.
Music player
Shows the soundtrack: title, artist, artwork, controls, volume, a visualiser and a progress line, in bar, compact, vinyl or minimal style. It only draws — the music belongs to the theme, so changing its style never restarts the song. The soundtrack can also be edited from here.
Sound toggle
The master mute: one button that silences the soundtrack and the background video at once, as a circle, a pill or a bare icon, with a label for each state. Each player's choice is remembered.
Slideshow
Images from images/ cycling on an interval with a fade, slide or Ken Burns zoom, plus brightness, blur and an overlay.
Video
A clip from videos/ inside a frame — fit, loop, mute, volume, brightness, blur and an overlay. For a full-screen clip, use the background instead.
The Settings Tab#
What the theme says about your server. Every module bound to the server name, Discord or website prints these values:
Field | Notes |
|---|---|
Server name | Leave it empty to use your |
Discord | For example |
Website | For example |
Players online and slots always come from the server and refresh while the screen is up; they cannot be overridden. The tab also holds the theme's description, shows which theme is live right now, and the theme id — the value the SetActiveTheme export takes. The identity is saved per theme, so two themes can print two different names.
Going Live#
Save writes the theme to data/themes.json. Set live makes it the screen every player gets, saving first if there are unsaved changes. Nothing restarts:
The server hands the live theme to each player as they connect, so it draws from the very first frame.
Players who are loading at that moment switch to it on the spot.
The last theme a player saw is kept on their PC, so a custom design never flashes the default on their next join.
Delete removes a theme. If it was live, players get the default (Cinematic) until you set another one.
Sharing Themes#
Every theme can travel as a single line of text. Copy code in the toolbar shows the theme as a code starting with QSLS1: — select it, copy it and send it. On the other server, Import at the top of the theme list takes the code and opens it as a new, unsaved theme.
A code carries the design, not the files. Songs, videos and images are referenced by file name, so the receiving server needs the same files in
song/,videos/andimages/. Anything missing shows in the creator as an external URL entry until you pick a replacement.
How the Screen Closes#
Loading Screen Creator decides when the screen goes away, and every path ends with it closed — nobody is ever left on a loading screen.
The game is ready
The session starts and the player's character exists. The progress bar fills to 100%.
The handoff
The screen stays up until the next interface can take over, so the player never sees the empty world in between. Multicharacter closes it the moment character selection is ready; any other script can do the same with one export or one event.
The safety ceiling
If nothing ever closes it, the screen closes itself:
Config.MaxDuration(45 seconds) after the character exists, orConfig.MaxDurationHandoff(3 minutes) while a resource inConfig.HandoffResourcesis running, because a slow PC can need that long to stream a character scene.
A resource that shuts the loading screen down on its own — many frameworks and spawn selectors do — works as well, and stopping qs-loadingscreen closes the screen for everyone still on it.
If nothing on your server closes the loading screen, it waits for the 45-second ceiling. Lower
Config.MaxDuration, or close it from your own spawn script — see Integrations.
Framing and Resolutions#
Modules are scaled to fit and the background is scaled to cover — two different scales on purpose. If everything covered, on an ultrawide or 4:3 monitor anything pinned to an edge would be cut off. If everything fitted, black bars would appear around the background. On 16:9, which is what nearly every player has, the two match and nothing changes. Turn on Safe area while designing and keep important text inside it.
Performance on Slow PCs#
The FiveM browser decodes video in software, at the exact moment the game is streaming hundreds of resources. On a PC with four CPU cores or fewer, or 4 GB of memory or less, background and module videos are held on their first frame instead of playing: the design stays, and the CPU goes to the game.
If a lighter copy of the clip exists next to it with _low added to the name — quasar_roleplay_low.webm beside quasar_roleplay.webm — those players load that one instead. The creator and its preview always play the full clip, so nothing is hidden from you while designing.