FiveM sitzt fest auf dem Ladebildschirm: Ursachen und wie man es debuggt

Spieler verbinden sich, der Balken füllt sich auf, und dann nichts: Der Ladebildschirm bleibt ewig oben, oder das Spiel friert auf einem schwarzen Bildschirm ein. Dieses Handbuch durchläuft die Ursachen in der Reihenfolge, die am schnellsten zu eliminieren ist, und zeigt, wie du F8 und die Server-Konsole benutzt, um die zu finden, die du hast.

#Zuerst: Sind es alle oder nur ein Spieler?

• Alle sitzen fest. Die Ursache liegt auf dem Server: eine Ressource, das Framework, oder eine loadscreen.
• Ein Spieler sitzt fest. Schaue auf den Client dieses Spielers: Cache, eine langsame Verbindung, Mods, oder ein altes Game-Build. Beginne mit FiveM-Cache löschen.

Verbinde dich einmal selbst und drücke F8. Dies funktioniert auch auf dem Ladebildschirm. Lese, was dort gedruckt wird, und halte die Server-Konsole auf der anderen Seite offen.

#1. Ein Script-Fehler auf dem Client

F8 listet Client-Fehler auf. Jede Zeile wie diese während des Ladens ist ein starker Hinweis:

SCRIPT ERROR: @my_script/client/main.lua:25: attempt to index a nil value (global 'ESX')

Ein Client-Script, das bei seiner Start-Thread abstürzt, kann den Spawn-Ablauf unvollständig lassen. Behebe das im Fehler genannte Script: Die Anleitungen für einen Script-Fehler lesen, ESX nil und QBCore nil decken die häufigen ab. Dann starte die Ressource neu und verbinde dich erneut.

Teste durch Eliminierung, wenn nichts gedruckt wird: Stoppe die zuletzt hinzugefügte oder geänderte Ressource, verbinde dich erneut, und sehe, ob das Laden beendet wird.

#2. Niemand spawnt den Spieler

Nach dem Laden muss etwas den Spieler spawnen und den Ladebildschirm ausschalten. Normalerweise:

• spawnmanager tut dies auf einem einfachen Server.
• Ein Frameworks multicharacter und spawn selector tun dies auf ESX und QBCore.

Überprüfe, dass diese Ressourcen starten, in der richtigen Reihenfolge, und dass nur eine von ihnen den Spawn handhabt. Ein typischer Konflikt ist ein Standard spawnmanager, der den Spieler auto-spawnt, während auch eine multicharacter Ressource es will. Stelle sicher, dass die Basis-Ressourcen vor dem Framework gestartet werden, wie in die richtige ensure-Reihenfolge:

ensure oxmysql
ensure ox_lib
ensure es_extended        # or qb-core / qbx_core
ensure spawnmanager
ensure esx_multicharacter # or qb-multicharacter / qbx_core's own

Wenn eine multicharacter Ressource steckenbleibt, suche in der Server-Konsole nach einem Datenbankfehler von ihr: Das Laden von Charakteren liest die Datenbank, und ein SQL-Fehler lässt den Spieler warten. Siehe oxmysql Verbindungsfehler und SQL-Tabelle existiert nicht.

#3. Ein benutzerdefinierter Ladebildschirm, der sich nie schließt

Server-Ladebildschirme sind Ressourcen, die in ihrem Manifest deklariert werden:

fx_version 'cerulean'
game 'gta5'

loadscreen 'html/index.html'
loadscreen_manual_shutdown 'yes'

files { 'html/**/*' }

Mit loadscreen_manual_shutdown 'yes' schließt FiveM den Ladebildschirm nicht automatisch. Ein Client-Script muss dies tun, indem es die Shutdown-Natives aufruft, sobald der Spieler bereit ist:

ShutdownLoadingScreen()
ShutdownLoadingScreenNui()

Wenn eine Ladebildschirm-Ressource die Option für manuelles Herunterfahren hat und niemand diese aufruft, bleibt der Bildschirm auf unbestimmte Zeit oben. Entferne entweder loadscreen_manual_shutdown, oder stelle sicher, dass dein Spawn-Ablauf sie aufruft. Teste, indem du die Ladebildschirm-Ressource stoppst und dich erneut verbindest.

Ein kaputten Ladebildschirm, der eine externe Datei lädt, die unerreichbar ist, oder der ein sehr großes Video abspielt, kann auch den Bildschirm blockieren oder verlangsamen. Halte ihn leicht und lokal.

#4. Großes Streaming und Downloads

Das Verbinden lädt alle gestreamten Dateien herunter, die der Spieler noch nicht hat. Ein Server mit vielen großen Fahrzeugen, Karten und Kleidungspaketen kann beim ersten Verbinden Minuten dauern, und der Ladebildschirm zeigt nichts, das passiert, wenn der Download langsam ist. Zeichen:

• Der F8 oder Ladebildschirm zeigt Downloads in Bearbeitung.
• Es funktioniert für zurückkehrende Spieler, aber nicht für neue.
• Das Problem wird schlimmer, nachdem du ein Asset-Paket hinzufügst.

Behebungen: Reduziere die Größe und die Anzahl der gestreamten Assets (siehe zu große Assets), hoste den Server auf einer Verbindung mit ausreichender Bandbreite, und bitte Spieler, auf die erste Download-Beendigung zu warten.

#5. Game-Build oder Server-Versionsprobleme

Wenn der Server einen Game-Build erzwingt, kann ein Spieler auf einem älteren oder anderen Build möglicherweise nicht sauber verbinden. Überprüfe sv_enforceGameBuild in server.cfg gegen den DLC, den deine Assets brauchen. Siehe sv_enforceGameBuild. Ein veraltetes Server-Artifact kann auch zu merkwürdigen Joins führen: aktualisiere deine Artifacts.

#6. Das Framework lädt den Charakter nicht

Spieler spawnen, aber das Framework beendet niemals das Laden des Spielers. Suche in der Server-Konsole nach:

• einem Datenbankfehler beim Laden des Spielers oder Charakters
• einem Fehler von es_extended, qb-core oder qbx_core auf dem Player-Loaded-Event
• einem Script, das dieses Event abonniert und einen Fehler wirft, wodurch andere Handler stoppt werden

Wenn du einen Fehler dort siehst, behebe ihn und verbinde dich erneut. Ein kaputten Inventar oder ein kaputten Job-Script können auch im Player-Loaded-Ablauf fehlschlagen, also überprüfe die zuletzt hinzugefügten zuerst.

#Eine Debug-Routine

1. Verbinde und drücke F8. Notiere jeden Fehler.
2. Lese die Server-Konsole während des Joins.
3. Stoppe die zuletzt geänderte Ressource, verbinde dich erneut.
4. Stoppe die Ladebildschirm-Ressource, verbinde dich erneut.
5. Immer noch fest für alle: Beginne mit nur den Basis-Ressourcen und füge den Rest in Gruppen hinzu.

Tipp: Wenn du Ressourcen in Gruppen von fünf oder zehn hinzufügst, findest du die schlechte mit wenigen Neustarts, anstatt 80 Ressourcen eine nach einer zu testen.

#Checkliste