[QBCore, QBox, ESX]

Package Description

<p>NProbleM Loading Screen replaces the default FiveM loading screen with a modern, custom-built interface that sells your server while it loads your screenshots, your music, your rules and your team, with real loading progress and a live player count, all driven from config files with zero dependencies.</p>

<h2>Dependencies</h2>

<ul>

  <li><i class="fa-solid fa-ban"></i> None: The loading screen runs before anything else on the client, so it needs no framework, no ox_lib, no oxmysql and no database it works on QBCore, ESX, Qbox and fully standalone servers alike.</li>

</ul>

<h2>Features</h2>

<ul>

  <li><i class="fa-solid fa-image"></i> Image or Video Background: A full-screen slideshow of your own screenshots, or looping video if you prefer motion — with cross-fade timing, shuffle, per-file duration and an adjustable dark overlay so your text always stays readable.</li>

  <li><i class="fa-solid fa-folder-open"></i> Drop-In Media: Backgrounds, gallery shots, videos and music live in the resource's own folders. Add a screenshot or a track, restart, done — you never rebuild the interface to change what players see.</li>

  <li><i class="fa-solid fa-wand-magic-sparkles"></i> Auto File Detection: Set a list to auto, number your files, and the script finds them on its own — four naming patterns and every common format supported, so the config never needs touching again.</li>

  <li><i class="fa-solid fa-music"></i> Built-in Music Player: Your own MP3 and OGG tracks play straight from the resource — no streaming, no internet, no ads. Play, pause, skip, seek progress, elapsed and total time, a volume slider, mute, shuffle and autoplay, with the title and artist on screen.</li>

  <li><i class="fa-solid fa-gauge-high"></i> Real Loading Progress: The percentage, the phase name and the "17 / 42" step counter come from the game's own loading events — nothing faked, nothing on a timer — with a full-width hairline bar tracking it along the bottom edge.</li>

  <li><i class="fa-solid fa-terminal"></i> Optional Init Log: Flip one setting and the live resource initialisation log runs under the status line, for owners who want the technical look.</li>

  <li><i class="fa-solid fa-signal"></i> Live Server Status: A chip in the top-right corner showing the current player count against your slots — read straight from your server's own slot limit or overridden by hand — so a connecting player sees the city is alive before they even spawn.</li>

  <li><i class="fa-brands fa-discord"></i> Live Discord Counts: Show how many people are online in your Discord and how many members you have, in widget mode with no token at all or bot mode for both figures. Counts are cached in the background, so Discord can never slow a player's connection down.</li>

  <li><i class="fa-solid fa-shield-halved"></i> Token-Safe by Design: The Discord ID and token sit in a server-only file, and only the two finished numbers are ever sent to the page — nothing a player can dig out of their own game.</li>

  <li><i class="fa-solid fa-table-columns"></i> Eight Content Panels: Start Here, Rules, Keybinds, Commands, Gallery, Team, News and Updates — each one a single switch away from being hidden, so you ship only the tabs your server actually needs.</li>

  <li><i class="fa-solid fa-flag-checkered"></i> Start Here Guide: A first-steps walkthrough for brand-new players — identity and licences, starter jobs, phone and radio, their first car, banking, housing — so a fresh arrival knows what to do the second they load in.</li>

  <li><i class="fa-solid fa-scale-balanced"></i> Server Rules: Your full rulebook in sectioned cards with a title and explanation on every entry, read on the loading screen instead of ignored on a Discord channel.</li>

  <li><i class="fa-solid fa-keyboard"></i> Interactive Keyboard Map: A full-screen keyboard in QWERTY, QWERTZ or AZERTY, with an optional numpad. Every key you describe lights up; hover it or physically press it and its binding and description slide in — the rest stay greyed out.</li>

  <li><i class="fa-solid fa-magnifying-glass"></i> Searchable Commands: Every chat command grouped by category with a live search box that filters as you type and quietly drops the headings left empty.</li>

  <li><i class="fa-solid fa-images"></i> Community Gallery: A thumbnail grid — one to four columns — with a full-size lightbox, arrow-key paging and click-to-dismiss, pulled from its own folder so your gallery and your backgrounds never mix.</li>

  <li><i class="fa-solid fa-users"></i> Admin Team Cards: Show who runs the server with an avatar, a role label from your language file and a Discord handle — and a clean initials badge whenever no avatar is set.</li>

  <li><i class="fa-solid fa-bullhorn"></i> News & Announcements: Dated announcement cards with colour-coded info, success, warning and danger tags, so the wipe notice or the maintenance window is the first thing every player reads.</li>

  <li><i class="fa-solid fa-code-branch"></i> Changelog Panel: Version-by-version release notes with added, fixed, changed and removed lines, each with its own sign and colour — your players finally see the work you shipped.</li>

  <li><i class="fa-solid fa-lightbulb"></i> Rotating Tips: A hint card that cycles on your own interval, shuffled or in order, keeping the screen alive while the game loads.</li>

  <li><i class="fa-solid fa-share-nodes"></i> Social Buttons: Discord, website, forum, YouTube, Twitch, Kick, Instagram, TikTok, X and Steam — fill a link and its button appears, leave it empty and it disappears. Clicking copies the link to the clipboard with a confirmation, because dropping a player out to a browser mid-load helps nobody.</li>

  <li><i class="fa-solid fa-bolt"></i> Instant, Race-Free Data: Everything the screen shows arrives with the connection itself, so it is already in place before the first frame — no waiting, no pop-in, and no label ever flashing in the wrong language first.</li>

  <li><i class="fa-solid fa-heart-pulse"></i> Never Breaks, Never Blank: A missing background falls back to built-in gradients, a broken image keeps its slot without stalling the slideshow, an unplayable track hides the player instead of ticking along to silence, and a dead avatar simply leaves the initials behind.</li>

  <li><i class="fa-solid fa-hourglass-half"></i> Safe Shutdown: The screen closes the moment the session is ready, with an optional extra delay — and a hard timeout so a stuck load can never trap a player behind a frozen screen.</li>

  <li><i class="fa-solid fa-file-pen"></i> Editable Shutdown Hook: An open file you can edit freely, where you run your own code the instant the screen closes — spawn logic, character selection, whatever your server does next.</li>

  <li><i class="fa-solid fa-sliders"></i> Everything in One Config: Branding, background, music, tips, socials, tabs, gallery, keyboard layout, admin team, status chip and shutdown behaviour all live in a single readable, commented file.</li>

  <li><i class="fa-solid fa-language"></i> Multi-Language: Ships with English, Turkish, German, Spanish and French — and every rule, tip, command, keybind description, news post and changelog line lives in that same language file, so translating the server and writing its content are the same job.</li>

  <li><i class="fa-solid fa-puzzle-piece"></i> Framework Independent: Because it depends on nothing, it drops into QBCore, Qbox, ESX and standalone servers unchanged — and keeps working through every framework update.</li>

  <li><i class="fa-solid fa-feather"></i> Performance Focused: Nothing loads that a player will not see, media stays outside the interface bundle, and Discord data is fetched in the background — the screen stays light and your players connect fast.</li>

</ul>

<p>Lifetime updates included.</p>