The First Impression Matters
Every new player who joins your server spends 30-90 seconds watching the loading screen before they see anything else. That's longer than most tutorial sequences. A default GTA V loading screen tells them nothing about your server; a great one tells them everything. Agency-Loadingscreen was built around this idea.
What We Ship
A polished glassmorphism UI that displays server rules, Discord link, staff roster, and a rotating hero image. Custom music player with volume control. Mini server stats: current population, uptime, next event. Smooth transitions when the load completes. All of it branded with your server's colors through a single config.
Why the Music Matters
The audio during loading sets emotional tone. Lo-fi hip-hop for chill RP servers, synthwave for cyberpunk-themed ones, cinematic ambient for serious RP communities. Players unconsciously attune to the vibe before they ever spawn. We ship a built-in track library and a config option to point at your own audio CDN.
Performance
The loading screen runs in the browser before any game asset has loaded, so performance is about page weight. Agency-Loadingscreen is under 400KB total including fonts. It loads instantly even on slow connections, which matters because some of your players are on 50Mbps rural broadband.
A/B Testing for Admins
The admin panel includes a simple A/B testing mode: set up two loading screen variants and we'll show each to 50% of new players, tracking how many make it to spawn on each. This is the kind of optimization tooling professional servers use to fine-tune their first-impression funnel.
Installation & Setup
Agency-Loadingscreen is a pure client resource with no database dependency. Download from Tebex, drop the folder into your resources directory, and add ensure agency-loadingscreen to server.cfg. The resource must load early — place it before your framework's core resource in server.cfg to ensure it displays before game assets begin loading.
All customization happens in config.lua and the html/config.js file. Your server branding (name, colors, logo, rules text, staff roster, Discord link) goes into config.js. No web development knowledge needed — the config is a flat JavaScript object with clear field names.
Configuration Options
The configuration covers visual, content, and performance settings:
- Server name and tagline — displayed prominently in the hero section.
- Color scheme — primary, secondary, and accent colors as hex values. Applied globally to text, borders, and button colors.
- Logo URL — your server logo displayed in the corner. SVG and WebP recommended for sharpness.
- Hero images — up to 10 rotating images with configurable transition interval and fade effect.
- Server rules — markdown text rendered in the rules panel. Support for headers, lists, and bold text.
- Music tracks — array of audio URLs with shuffle mode toggle. Players can mute or adjust volume from a discreet control.
- Live stats — toggle display of current player count, server uptime, and next scheduled event.
- A/B testing — enable variant B configuration and the 50/50 split tracking.
Framework Compatibility
Agency-Loadingscreen runs entirely in the browser layer, before any FiveM resource has initialized. It has no framework dependency and works identically on QBCore, ESX, and standalone servers. The live player count stat pulls from the FiveM server info endpoint, which is framework-agnostic.
Why This Matters for Roleplay
The loading screen is a threshold ritual. Players cross it every session — it's the moment between "I'm launching the game" and "I'm in the world." A screen that uses that time to immerse players in your server's aesthetic and rules sets expectations before they spawn. Players who read the rules on the loading screen are less likely to claim they didn't know them. Players who hear the right music arrive with the right emotional register.
New player retention often fails in the first session. If a new player's first sixty seconds on your server is a blank screen or a generic GTA V loading image, you've wasted a high-attention moment. Agency-Loadingscreen converts that moment into active server marketing — Discord invite, staff names, upcoming events, the server's visual identity.
The A/B testing feature exists because loading screen optimization is measurable. If variant A shows your Discord link prominently and variant B doesn't, and new players in variant A join Discord at twice the rate, that's a concrete finding worth acting on. Professional server operations use data; this is one place where loading screen data is actually collectable.
Frequently Asked Questions
Can I show the current map event or active roleplay scenario on the loading screen?
Yes. The live stats panel supports a custom text field that can be updated via the server's HTTP endpoint. Run a small server script that pushes event status to the endpoint every few minutes, and the loading screen displays it in real time. This is how servers communicate active events to joining players before they spawn.
Does the music autoplay despite browser autoplay policies?
FiveM's embedded browser operates in a context where autoplay restrictions don't apply — it's not a standard browser tab with user gesture requirements. Music autoplays reliably. Players see a mute control in the corner as a courtesy, not a workaround.
How do I track A/B test results?
Enable the A/B tracking endpoint in config.js and point it at your analytics server or a simple webhook. Each variant is tagged and the join event fires when the loading screen dismisses. Compare Discord join rates, session length on first visit, or whatever metric matters to your server between the two groups.
Can I show a video instead of rotating images?
Yes. Set heroType: 'video' and provide a video URL. Video plays muted and loops. Keep video files under 20MB for acceptable load performance on slow connections. WebM format at 720p is the recommended encoding for this use case.
Requirements
- FiveM server (any framework or standalone)
- cfx.re account with valid Agency-Loadingscreen license
- Audio and image hosting (CDN, Discord CDN, or your own server)
- No database dependency
Content Strategy for Your Loading Screen
Most servers populate their loading screen and never update it. The server rules were written a year ago. The staff roster is six months out of date. The hero images are screenshots from events that have long since passed. A stale loading screen signals to experienced players that the server doesn't sweat the details.
Set a calendar reminder for the first of every month: update the rotating images with recent event screenshots, verify the staff roster is current, check that the Discord link is working, refresh the "next event" field. This takes fifteen minutes and keeps the loading screen feeling alive.
Better: build the loading screen update into your event planning workflow. When an event is scheduled, update the loading screen to promote it. After the event, replace that promotion with a recap screenshot. The loading screen becomes a current events board rather than a static brochure.
The music library is worth rotating seasonally. Summer themes, winter vibes, special event playlists. Players who join every day notice the music more than any other element — giving them something new occasionally signals that the server is actively maintained.