FiveM için özel yükleme ekranı: loadscreen, fxmanifest ve shutdown

Yükleme ekranı, oyuncuların sunucunun dosyalarını indirirken gördüğü küçük bir web sayfasıdır. Manifest ve HTML dosyası ile normal bir kaynaktır. Bu rehber dosyaları, manifestyi, ekranı kendiniz kapatmayı ve hafif tutmayı kapsar.

#Kaynak

HTML ve varlıkları ile bir klasör oluşturun:

resources/[ui]/my_loadscreen/
  fxmanifest.lua
  index.html
  css/style.css
  js/app.js
  img/background.jpg
  audio/music.ogg

#fxmanifest.lua

fx_version 'cerulean'
game 'gta5'

loadscreen 'index.html'

files {
    'index.html',
    'css/style.css',
    'js/app.js',
    'img/background.jpg',
    'audio/music.ogg',
}

Burada iki şey önemlidir:

• loadscreen 'index.html' FiveM'in gösterdiği sayfayı adlandırır.
• Sayfa kullanılan her dosya, HTML'nin kendisini dahil, files dosyasında olmalıdır. Listelenmemiş bir dosya 404 döndürür ve ekran o bölümde boş veya bozuktur. 'img/*' gibi desen tüm klasörü listelemek için izin verilir.

server.cfg'ye ekleyin:

ensure my_loadscreen

#Minimal index.html

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <link rel="stylesheet" href="css/style.css">
</head>
<body>
  <h1>Welcome to my server</h1>
  <div id="bar"><div id="fill"></div></div>
  <audio id="music" src="audio/music.ogg" autoplay loop></audio>
  <script src="js/app.js"></script>
</body>
</html>

Yukarıdaki gibi göreli yollar kullanın. Sayfa oyunun tarayıcısında çalışır, bu nedenle normal HTML, CSS ve JavaScript kullanabilirsiniz. İlerleme çubuğu için sayfa oyun yüklerken iletiler alır:

window.addEventListener('message', (e) => {
  if (e.data.eventName === 'loadProgress') {
    document.getElementById('fill').style.width = (e.data.loadFraction * 100) + '%'
  }
})

#Sadece bir yükleme ekranı

FiveM tek bir yükleme ekranı gösterir. İki kaynak loadscreen bildirirse, yalnızca biri kullanılır ve hangisi başlangıç değiştirebilir. Öyleyse:

• Diğer yükleme ekranı kaynağını server.cfg'den kaldırın veya durdurun.
• Yeni bir tane test etmek istediğinizde, ikisini de başlatmak yerine eski satırı yorum yapın.

#Ekranı kendiniz kapatın

Varsayılan olarak FiveM oyun oturumu hazır olduğunda yükleme ekranını kapatır. Çok karakterli veya spawn betiği sıklıkla ekranı daha uzun açık tutmaya ihtiyaç duyar ve karakter seçilene kadar dünyayı gizlemek için. Bunun için manifest otomatik kapatmayı kapatır:

loadscreen_manual_shutdown 'yes'

Sonra bir istemci betiği kapatmalıdır:

-- client.lua
CreateThread(function()
    -- wait until your own condition: player spawned, character chosen...
    while not NetworkIsPlayerActive(PlayerId()) do
        Wait(100)
    end

    ShutdownLoadingScreenNui()
end)

ShutdownLoadingScreenNui, yükleme ekranının NUI sayfasını kapatır. Spawn, çok karakterli bir betik gibi yapan bir betik, çoğu zaman sizin için çağırır veya bunun arkasındaki yerleşikleri çağırır. Önce bu betiği kontrol edin, sonra başka hiçbir şey yapmıyorsa yalnızca kendi çağrınızı ekleyin.

Dikkat: loadscreen_manual_shutdown 'yes' ayarlarsanız ve hiçbir şey kapatmayı çağırmazsa, oyuncular yükleme ekranında sonsuza kadar kalırlar. Bu olursa, oyuncuların yükleme ekranında takılması bölümüne bakın.

#Müzik ve video: hafif tutun

files içindeki her şey her oyuncu tarafından indirilir. Ağır yükleme ekranı beklemeyi daha uzun yapar, bu hedefin tersidir.

• Müzik: .ogg veya .mp3, en fazla birkaç dakika ve ılımlı bit hızı kullanın. 3 MB parça iyidir, 60 MB parça değil. Sessiz düğmesini ekleyin ve kodda ses seviyesini düşük ayarlayın, çünkü yüksek başlangıç oyuncuları rahatsız eder.
• Video: kısa ve döngü, .webm veya .mp4 içinde, küçük çözünürlük ve düşük bit hızı. Daha iyisi, çok daha küçük olan iyi bir arka plan görüntüsü kullanın.
• Görüntüler: bunları sıkıştırın. 200 ila 400 KB'lik arka plan çoğu ekranda 8 MB'lik biri gibi görünür.
• Yazı tipleri ve kitaplıklar: bunları kaynağa koyun. Katılışta internetten yükleme sayfayı yavaşlatır ve ana makine kapalı ise başarısız olur.

Oyuncular yeni sürüm için bu dosyaları her indirdiğinden, bunları sık sık değiştirmeyin. Bir oyuncu güncellemeden sonra hala eski sayfayı görürse, FiveM önbelleğini temizlemesini isteyin.

#İsteğe bağlı: imleç

Oyuncunun yükleme ekranında tıklamasını istiyorsanız, kurallar veya menü için, manifeste aşağıdakileri ekleyin:

loadscreen_cursor 'yes'

#Yaygın sorunlar

• Boş ekran, stil yok. files dosyası eksik veya HTML'deki yol yanlış.
• Varsayılan ekran gösterilir. Kaynak başlatılmadı veya loadscreen satırı eksik.
• Asla kapanmaz. loadscreen_manual_shutdown 'yes' ayarladınız ve hiçbir betik ShutdownLoadingScreenNui() çağırmadı.
• Müzik çalmıyor. Dosya yolunu ve biçimini kontrol edin. Önce sayfayı normal bir tarayıcıda test edin.

#Kontrol Listesi