Skip to content

msaber07/nova-loadingscreen

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

nova-loadingscreen

Standalone, framework-free FiveM loading screen — video/photo background, music playlist, social links, rotating tips, changelog panel, live player count, TR/EN.


Nova Loading Screen

English

What it does

A modern, lightweight loading screen shown while players connect. Features:

  • Video or photo background — cinematic .mp4, or a slow crossfade slideshow. Auto-falls back to photos if the video can't load, and to a dark gradient if there are no images.
  • Background music — single track or a playlist (auto-advances). Player widget with current track name + previous/next controls, volume slider + mute, and the player's choice is remembered in their browser.
  • Social links — click to copy to clipboard with a toast (Discord, website, Instagram, etc.).
  • Rotating tips / rules — bottom center.
  • Announcement / changelog panel — bottom right.
  • Live player count — optional, fetched directly from the server via handover data (enabled when cfxId is set).
  • Real load progress — bar + status text driven by FiveM load events.
  • Language — built-in UI strings in TR or EN (and you can add your own).

Dependencies

None. This is a pure loading screen (loadscreen), framework-independent — works on QBCore, ESX, or standalone servers.

Installation

  1. Drop the nova-loadingscreen folder into your resources (e.g. resources/[standalone]/).
  2. Add ensure nova-loadingscreen to your server.cfg. If the folder category is already ensured (e.g. ensure [standalone]), nothing else is needed.
  3. Restart the server. There is only ever one active loadscreen — make sure no other loading screen resource is running.

Configuration — ui/config.js

Everything is edited in one file. Key options:

Option Description
locale Built-in UI text language: 'en' or 'tr'.
serverName Name shown top-left.
logoText / logoImage A letter, or an image at images/logo.png (image wins if set).
title / lines Big title + sublines (bottom left).
images / slideInterval Slideshow photos and change interval (ms).
socials Bottom-left links. copy (or url/label) is copied on click.
showProgress Show/hide the bottom loading bar.
cfxId Set any value (e.g. 'show') to display the live player counter. Empty = hidden.
video.enabled / video.file Use an .mp4 background instead of the slideshow.
music.enabled / music.files / music.volume Background music playlist + default volume (0.0–1.0).
music.titles Optional display names for the player widget (same order as files). If omitted, the file name is used.
tips / tipInterval Rotating tips and interval (ms).
announce.title / announce.items Changelog panel content.
i18n Built-in strings per language (advanced — copy a block to add a language).

Assets

  • Photos → ui/images/ · Music → ui/music/ · Video → ui/video/
  • The bundled demo assets are placeholders — replace them with your own before publishing your server.

Notes

  • Your own texts (server name, title, tips, socials...) can be in any language; locale/i18n only controls the few built-in strings (load status, "Copied", "online").
  • Tooltips are loaded lazily and the music starts on the first allowed gesture (CEF policy) — both handled automatically.

Türkçe

Ne işe yarar?

Oyuncular bağlanırken görünen modern, hafif bir loading ekranı. Özellikler:

  • Video veya fotoğraf arkaplan — sinematik .mp4 ya da yavaş crossfade slideshow. Video yüklenemezse fotoğrafa, görsel yoksa koyu gradyana otomatik düşer.
  • Arkaplan müziği — tek parça veya playlist (sırayla çalar). Çalan parça adı + ileri/geri butonlu oynatıcı widget'ı, ses çubuğu + sustur; oyuncunun tercihi tarayıcısında hatırlanır.
  • Sosyal linkler — tıklayınca panoya kopyalar ve bildirim gösterir (Discord, site, Instagram vb.).
  • Dönen ipuçları / kurallar — alt orta.
  • Duyuru / changelog paneli — sağ alt.
  • Canlı oyuncu sayısı — opsiyonel, handover verisi ile doğrudan oyun sunucusundan çekilir (cfxId aktifken).
  • Gerçek yükleme ilerlemesi — FiveM olaylarına bağlı çubuk + durum metni.
  • Dil — hazır arayüz metinleri TR veya EN (kendi dilini de ekleyebilirsin).

Bağımlılıklar

Yok. Saf bir loading ekranıdır (loadscreen), frameworkten bağımsızdır — QBCore, ESX veya standalone sunucularda çalışır.

Kurulum

  1. nova-loadingscreen klasörünü resources içine at (örn. resources/[standalone]/).
  2. server.cfg'ye ensure nova-loadingscreen ekle. Klasör kategorisi zaten ensure ediliyorsa (örn. ensure [standalone]) ekstra bir şey gerekmez.
  3. Sunucuyu yeniden başlat. Aynı anda tek aktif loadscreen olabilir — başka bir loading ekranı resource'unun çalışmadığından emin ol.

Ayarlar — ui/config.js

Her şey tek dosyadan düzenlenir. Önemli ayarlar:

Ayar Açıklama
locale Hazır arayüz metni dili: 'en' veya 'tr'.
serverName Sol üstte görünen ad.
logoText / logoImage Bir harf ya da images/logo.png görseli (görsel varsa o kullanılır).
title / lines Büyük başlık + alt yazılar (sol alt).
images / slideInterval Slideshow fotoğrafları ve değişim süresi (ms).
socials Sol alt linkler. Tıklayınca copy (yoksa url/label) kopyalanır.
showProgress Alttaki yükleme çubuğunu göster/gizle.
cfxId Canlı oyuncu sayacını göstermek için herhangi bir değer girin (örn. 'aktif'). Boş = gizli.
video.enabled / video.file Slideshow yerine .mp4 arkaplan kullan.
music.enabled / music.files / music.volume Müzik playlist + varsayılan ses (0.0–1.0).
music.titles Oynatıcı widget'ı için opsiyonel parça adları (files ile aynı sıra). Boşsa dosya adı kullanılır.
tips / tipInterval Dönen ipuçları ve süre (ms).
announce.title / announce.items Changelog paneli içeriği.
i18n Dile göre hazır metinler (ileri seviye — yeni dil için blok kopyala).

Dosyalar (assets)

  • Fotoğraflar → ui/images/ · Müzik → ui/music/ · Video → ui/video/
  • Pakette gelen demo dosyaları placeholder'dır — sunucunu yayınlamadan kendi dosyalarınla değiştir.

Notlar

  • Kendi metinlerin (sunucu adı, başlık, ipuçları, sosyaller...) herhangi bir dilde olabilir; locale/i18n sadece birkaç hazır metni (yükleme durumu, "Kopyalandı", "çevrimiçi") kontrol eder.
  • Müzik, CEF politikası gereği ilk izin verilen etkileşimde başlar — otomatik halledilir.

Author: Nova · Version: 1.0.0 · Type: Standalone loadscreen

About

Fivem Standalone Loading Screen

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors