Compatibility
- Frameworks
- Not specified
- Version
- Not specified
- Game Mode
- FiveM

by wss_developments
WSS-Loadingscreen is a free, open-source loading screen for FiveM.
Fully config-driven from a single config.lua, it gives you video or YouTube background, music, tips, rules, changelogs, keybinds, staff section, and social links. Clean layout, manual shutdown on spawn, and no framework dependency.
Free. Open source. Ready to drop in and customize.
(Untitled - Clipped GTA V with Medal.tv)
Single config file β no code edits for branding or content
Background video (local file or YouTube) or no video
Optional background music with volume control
Custom tips, server rules, and changelogs (in-app panels)
Keybinds panel with keyboard layout and descriptions
Staff section with names, roles, and photos
Social links (Discord, Tebex, YouTube, X, TikTok, Instagram)
Themed UI with configurable colors and gradients
Manual shutdown β closes only when the player has spawned
No framework required β works on any server
Fully open source β use and modify as you like
No bloat, no paywall. Configure and go.
Branding β Server name, tagline, community name, slogan (can be turned off)
Video β Local file (e.g. ./videos/background.webm) or YouTube URL; mute and type (auto/local/youtube) in config
Music β Multiple tracks, volume, all paths in config
Tips β Single config string shown under the loading panel
Rules β List of rules, shown in-app when the rules link is #
Changelogs β Version, date, and bullet list per entry; newest first
Keybinds β Action, key, and description per bind; optional keyboard layout with per-key info
Staff β Name, role, optional photo path per entry
Social β Discord, Tebex, YouTube, X, TikTok, Instagram; leave blank to hide
Sections can be enabled or disabled so you only show what you use.
Central loading panel with progress
Configurable theme: background, panels, cards, borders, accent, text, success/error, gradient
Optional branding block
Responsive layout
Fonts: Orbitron & Rajdhani (customizable via build/CSS)
Easy to match your serverβs look by editing the config (and CSS if you rebuild the UI).
Server β Sends the whole config to the client via deferrals.handover(Config) on playerConnecting.
Client β Uses loadscreen_manual_shutdown βyesβ and closes the NUI only on playerSpawned, so the loading screen stays until the player has actually spawned.
UI β Built from React (or your stack) in ui/; output in ui/dist/; no external runtime dependency.
No database, no framework hooks. Just config and one spawn event.
FiveM β fx_version βceruleanβ, game βgta5β
No framework β Works on any server
Build step β If you change the UI source: cd ui && npm install && npm run build
Files β Ensure ui/dist/index.html, ui/dist/assets/**, and any images / videos / music paths you use are in files in fxmanifest.lua
Full loading screen resource (client, server, config)
Pre-built UI in ui/dist/
Single config.lua for all content and toggles
Example rules, changelogs, keybinds, staff, and social links
Manual shutdown on playerSpawned
Open source β modify and redistribute freely
Free and fully open source.
GitHub / download link: ( GitHub - Stretz/wss-loadingscreen: React UI Loading Screen Full Opensource Β· GitHub )
License: Use, modify, and redistribute as you like. Credit appreciated but not required.
| Code is accessible | Yes |
|---|---|
| Subscription-based | No |
| Lines (approximately) | ~200+ (Lua + UI) |
| Requirements | None |
| Support | Yes (Discord) |
Developed by WSS-Development
Free download (ad supported)
Quick answers based on the information published for Loading Screen.
Have another question? Check the mod description above for more details.
Learn more about setting up, configuring, and using this type of resource.
Discover more resources for your FiveM or GTA 5 server.
Free mods are a good starting point. When your server needs stronger support, cleaner installs, and premium systems, move into the commercial hubs below.