Häufige Fehler des FiveM-Servers und ihre Lösung

Die meisten Probleme eines FiveM-Servers verraten sich in einer einzigen Zeile der Ausgabe. Hier finden Sie die häufigsten Meldungen genau so, wie Sie sie sehen werden, mit Ursache und Lösung. Suchen Sie nach dem Fehlertext (Strg+F).

Wo Sie nach Fehlern suchen#

Lesen Sie ab dem ersten Fehler. Spätere Fehler sind oft nur seine Folgen. Gelbe und rote Zeilen sind Warnungen und Fehler.

Could not authenticate server license key oder no license key was specified#

Ursache: Der Server hat keinen gültigen License Key. Entweder hat er gar keinen erhalten, oder der Schlüssel ist ungültig, deaktiviert oder wurde falsch kopiert.

Lösung: Prüfen Sie die Zeile sv_licenseKey in der server.cfg, die der Server tatsächlich lädt, und die Schlüsselvariable in der Registerkarte Einstellungen. Prüfen Sie im Cfx.re Portal (öffnet sich in einem neuen Fenster), dass der Status des Schlüssels Active ist. Ausführliche Schritte: FiveM License Key.

Couldn't find resource …#

Ursache: Der Server kennt keine Resource mit dem Namen aus ensure. Der Ordnername stimmt nicht überein (-main, Großbuchstaben), fxmanifest.lua liegt eine Ebene tiefer, oder Sie haben das Skript bei laufendem Server ohne den Befehl refresh hochgeladen.

Lösung: Benennen Sie den Ordner genau in den Namen aus ensure um und prüfen Sie, dass fxmanifest.lua direkt darin liegt. Geben Sie dann in der Konsole refresh und ensure <NAME> ein oder starten Sie den Server neu. Siehe FiveM-Resources.

Could not find dependency … for resource …#

Ursache: Das Skript braucht eine andere Resource (eine Bibliothek, ein Framework), die nicht auf dem Server ist.

Lösung: Installieren Sie die zuerst in der Meldung genannte Resource und setzen Sie ihr ensure in der server.cfg über das Skript. Die Meldung Could not start dependency … bedeutet, dass die Abhängigkeit existiert, aber selbst abgestürzt ist. Suchen Sie ihren Fehler in der Konsole.

Couldn't start resource …#

Ursache: Die Resource existiert, ist aber nicht gestartet. Der eigentliche Grund steht in den Zeilen direkt über dieser Meldung: eine fehlende Abhängigkeit, eine nicht erfüllte Bedingung (OneSync, Game Build, Serverversion) oder ein Lizenzfehler bei einem kostenpflichtigen Skript.

Lösung: Beheben Sie die Ursache aus den vorherigen Zeilen und starten Sie die Resource erneut mit ensure <NAME>.

SCRIPT ERROR: @…/….lua:…: …#

Ursache: Ein Fehler im Code des Skripts. Die Meldung enthält Resource, Datei, Zeilennummer und eine Beschreibung, zum Beispiel attempt to index a nil value. Meist ist es die falsche Framework-Einstellung in der config.lua, eine fehlende Datenbanktabelle oder eine ältere Skriptversion, als das Framework erwartet.

Lösung: Prüfen Sie die config.lua (das richtige Framework), importieren Sie das SQL des Skripts und aktualisieren Sie sowohl das Skript als auch das Framework. Wenn der Fehler nach dem Bearbeiten einer Datei auftrat, machen Sie die Bearbeitung rückgängig.

You lack the required entitlement to use …#

Ursache: Ein durch Asset Escrow geschütztes kostenpflichtiges Skript wurde mit einem anderen Cfx.re-Konto gekauft als dem, zu dem der License Key des Servers gehört.

Lösung: Verwenden Sie einen License Key desselben Kontos, mit dem Sie das Skript gekauft haben, oder übertragen Sie das Skript im Cfx.re Portal. Starten Sie den Server dann neu.

Failed to verify protected resource …#

Ursache: Die Dateien eines verschlüsselten Skripts wurden bei der Übertragung beschädigt oder fehlen, meist die .fxap-Datei.

Lösung: Laden Sie die gesamte Resource erneut hoch, einschließlich der .fxap-Datei und versteckter Dateien (die mit einem Punkt beginnen).

Unable to establish a connection to the database (…)!#

Ursache: oxmysql konnte keine Verbindung zur Datenbank herstellen. Der Code in Klammern sagt, warum:

Lösung: Korrigieren Sie set mysql_connection_string in der server.cfg nach Datenbank für FiveM. Sobald es behoben ist, zeigt die Konsole Database server connection established!.

Der Server ist nicht in der Serverliste oder wird als „privat“ angezeigt#

Ursache: eine aktive Zeile sv_master1 "", fehlendes sets sv_projectName oder sets sv_projectDesc, der Server ist von außen nicht erreichbar, oder seit dem Start ist erst kurze Zeit vergangen.

Lösung:

1. Prüfen Sie, dass Sie sich direkt mit dem Server verbinden können: Drücken Sie im Spiel F8 und geben Sie connect <IP_ADRESSE>:<PORT> ein (Adresse aus der Registerkarte Netzwerk).
2. Kommentieren Sie die Zeile sv_master1 "" mit # aus.
3. Fügen Sie sets sv_projectName "…" und sets sv_projectDesc "…" hinzu.
4. Warten Sie nach dem Start bis zu 8 Minuten.

Sie können den Server auch mit dem Werkzeug CFX Resolver prüfen. Details in der Anleitung server.cfg.

Connection rejected by server: Client/Server game build revision mismatch#

Ursache: Das Spiel des Spielers und der Server haben unterschiedliche Game-Build-Revisionen. Typischerweise kurz nach einem Update von GTA V oder FiveM.

Lösung: Aktualisieren Sie die Server-Artifacts (Anleitung). Der Spieler kann im FiveM-Client den Update Channel (Zahnradsymbol › Game) auf den Kanal umstellen, der zum Server passt. Oft muss man nur warten, bis das Update bei allen angekommen ist.

Spieler hängen beim Verbinden im Ladebildschirm#

Ursache:

• ein Fehler im Multicharacter-Skript oder in der Datenbank (der Charakter lädt nicht),
• eine große Menge herunterzuladender Modelle (Autos, Kleidung, Maps) oder langsames Herunterladen,
• die erste Verbindung nach einer Änderung von sv_enforceGameBuild (DLC wird heruntergeladen),
• ein Ladebildschirm-Skript, das sich nie schließt.

Lösung: Sehen Sie in der Serverkonsole und in der F8-Konsole des Spielers nach, wo das Laden stehen geblieben ist. Prüfen Sie bei einem Framework die Datenbankverbindung. Setzen Sie auf Qbox mit eigenem Multicharacter setr loadscreen:externalShutdown false. Schalten Sie versuchsweise große Auto- und Kleidungspakete vorübergehend aus und sehen Sie, ob die Spieler weiterkommen.

Die Verbindung endet mit einem Timeout (timed out) oder connection refused#

Ursache:

• der Port in endpoint_add_tcp und endpoint_add_udp passt nicht zum Port in der Registerkarte Netzwerk (häufig nach dem Deployment eines txAdmin-Rezepts, das den Standard 30120 schreibt),
• der Server ist nicht vollständig gestartet (hat die server.cfg nicht geladen, keine Resources laufen),
• der Server ist überlastet (CPU oder RAM am Limit) oder stürzt gerade ab,
• auf dem eigenen VPS blockiert eine Firewall den Port.

Lösung: Vergleichen Sie den Port in der server.cfg mit der Zeile Verbindungsadresse. Prüfen Sie in der Konsole, dass die Resources gestartet sind (Started resource …). Prüfen Sie die RAM- und CPU-Auslastung unter der Konsole. Erlauben Sie auf einem VPS den Port in der Firewall sowohl für TCP als auch für UDP (Firewall).

Server artifact version is outdated (Warnung EOS oder EOL)#

Ursache: Der Server läuft auf einem alten FXServer-Build. Artifacts, die älter als 3 Monate sind, lassen sich nicht über die Serverliste betreten.

Lösung: Aktualisieren Sie die Artifacts auf den Kanal Recommended (Anleitung).

Native … is not supported, Error parsing script oder Failed to load script#

Ursache: Das Skript oder Framework verwendet Funktionen, die Ihre Serverversion nicht kennt.

Lösung: Aktualisieren Sie die Artifacts auf Recommended. Wenn das nicht reicht, auf Latest.

txAdmin meldet einen Absturz oder ein Einfrieren des Servers und startet ihn neu#

Ursache: Der Server ist abgestürzt oder hat aufgehört zu reagieren. txAdmin startet ihn von selbst neu. Meist ist es ein Skriptfehler (eine Endlosschleife, eine große Datenbankabfrage), zu wenig RAM oder eine neu installierte Resource.

Lösung:

1. Öffnen Sie in txAdmin Live Console und System › Console Log und suchen Sie die letzten Fehler vor dem Absturz.
2. Prüfen Sie die RAM-Auslastung unter der Konsole im Kundenbereich. Bleibt sie am Limit, entfernen Sie Resources oder wechseln Sie zu einem größeren Tarif (Registerkarte Tarif ändern).
3. Wenn die Abstürze nach der Installation oder Aktualisierung eines Skripts begonnen haben, schalten Sie das Skript aus (kommentieren Sie sein ensure aus) und sehen Sie, ob die Abstürze aufhören.

## [txAdmin CFG validator]: … in der server.cfg#

Ursache: txAdmin hat eine Zeile auskommentiert, die in der server.cfg nicht erlaubt ist, und den Grund hinter den Doppelpunkt geschrieben. Am häufigsten:

• onesync MUST only be set in the txAdmin settings page. – mit txAdmin wird OneSync unter Settings › FXServer eingestellt.
• you MUST NOT start/stop/ensure txadmin resources. – löschen Sie die Zeile ensure monitor (txAdmin startet von selbst).
• the … port … is dedicated for txAdmin and CAN NOT be used for FXServer. – in endpoint_add_* steht der txAdmin-Port. Tragen Sie dort den Spielport aus der Registerkarte Netzwerk ein.

Lösung: Korrigieren Sie die Zeile entsprechend dem Grund und löschen Sie die auskommentierte Zeile.

Your config file does not specify a valid endpoints for FXServer to use.#

Ursache: In der server.cfg fehlen die Zeilen endpoint_add_tcp und endpoint_add_udp, oder sie haben einen anderen Port.

Lösung: Fügen Sie beide Zeilen mit dem Port aus der Registerkarte Netzwerk oben in die server.cfg ein:

endpoint_add_tcp "0.0.0.0:<PORT>"
endpoint_add_udp "0.0.0.0:<PORT>"

Ersetzen Sie <PORT> durch die Zahl nach dem Doppelpunkt in der Zeile Verbindungsadresse.

Sie können nicht mehr als 48 Slots einstellen#

Ursache: Mehr als 48 Spieler erfordern ein Abonnement Element Club Argentum im Cfx.re Portal. Das Abonnement allein erhöht die Slot-Anzahl nicht.

Lösung: Erhöhen Sie nach dem Kauf des Abonnements sv_maxclients in der server.cfg (auf einem Server ohne txAdmin gegebenenfalls die Slot-Variable in der Registerkarte Einstellungen) und starten Sie den Server neu. Mehr als 64 Slots erfordern OneSync on.

server thread hitch warning: timer interval of … milliseconds#

Ursache: Ein Server-Tick hat länger als 150 ms gedauert, und der Server hat „geruckelt“. Beim Start und während des Ladens der Resources ist das normal. Häufige Meldungen im laufenden Betrieb bedeuten, dass ein Skript viel Arbeit auf einmal erledigt (große Datenbankabfragen, Schleifen über alle Spieler oder Entitäten). Ähnliche Meldungen gibt es für den Netzwerk-Thread (network thread) und den Sync-Thread (sync thread).

Lösung: Finden Sie den Verursacher mit dem Profiler: in der Serverkonsole profiler record 500, und wenn er fertig ist, profiler saveJSON profil.json. Laden Sie die Datei in der Registerkarte Dateien herunter und öffnen Sie sie in den Entwicklertools von Chrome (Registerkarte Performance). Optimieren, aktualisieren oder ersetzen Sie das Skript dann. Auch ein Blick auf die CPU-Auslastung unter der Konsole hilft.

Warning: sending large event … (… bytes). This may cause performance issues. Consider using latent events instead.#

Ursache: Ein Skript sendet eine große Datenmenge auf einmal in einem einzigen Event an die Spieler. Das kann bei Spielern zu Lag und Verbindungsabbrüchen führen.

Lösung: Ermitteln Sie anhand des Event-Namens, um welches Skript es sich handelt, und melden Sie es dem Autor. Große Daten sollten mit latent events gesendet werden, die sie in Teilen übertragen.

Could not contact the server browser#

Ursache: Der Server erreicht die Cfx.re-Dienste nicht, die die Serverliste betreiben. Eine gelegentliche Meldung ist harmlos; wiederholt sie sich ständig, fällt der Server aus der Liste.

Lösung: Starten Sie den Server neu. Wenn die Meldung immer wieder kommt, kontaktieren Sie uns. Prüfen Sie auf dem eigenen VPS, dass Ihre Firewall oder Ihr DDoS-Schutz die Cfx.re-Adressen aus static.cfx.re/ips.txt (öffnet sich in einem neuen Fenster) durchlässt.

Can't restart a stopped resource.#

Ursache: Sie haben restart bei einer Resource verwendet, die nicht läuft.

Lösung: Verwenden Sie ensure <NAME>. Es startet eine nicht laufende Resource und startet eine laufende neu.

Warnung Resource … does not specify an fx_version in fxmanifest.lua.#

Ursache: Ein älteres Skript hat keine Zeile fx_version in seinem Manifest.

Lösung: Fügen Sie fx_version 'cerulean' und game 'gta5' oben in die fxmanifest.lua ein. Ein Skript mit __resource.lua statt fxmanifest.lua ist sehr alt; suchen Sie nach einer neueren Version.

Ein Auto oder Modell lädt im Spiel nicht#

Ursache: Der Modellname im Befehl oder Skript stimmt nicht mit dem Namen in vehicles.meta überein, die Resource mit dem Modell läuft nicht, im Manifest fehlen die data_file-Zeilen, oder das Modell erfordert einen höheren Game Build.

Lösung: Prüfen Sie in der Konsole, dass die Resource mit dem Modell läuft (Started resource …). Suchen Sie den genauen Modellnamen (modelName) in vehicles.meta und verwenden Sie ihn zum Spawnen. Prüfen Sie, dass das Manifest data_file für vehicles.meta enthält (FiveM-Resources).

Wenn es weiterhin nicht funktioniert: wann Sie den Support kontaktieren#

Kontaktieren Sie uns (Kontakte), wenn:

• die Konsole im Kundenbereich nicht lädt oder die Schaltflächen Start und Neustart nicht reagieren,
• der Server selbst mit dem Basisrezept von txAdmin und ohne zusätzliche Skripte nicht startet,
• Spieler den Port nicht erreichen, obwohl die server.cfg zur Registerkarte Netzwerk passt,
• Sie SFTP-Zugang für große Dateien brauchen.

Senden Sie uns den Namen oder die ID des Dienstes, wann das Problem auftrat, den genauen Fehlertext (aus der Konsole kopiert) und was Sie zuletzt geändert haben. Senden Sie nie Ihren License Key oder Ihr Datenbankpasswort.

Weiterführende Links#

• FiveM: Server Issues (öffnet sich in einem neuen Fenster)
• FiveM: Resource FAQ (öffnet sich in einem neuen Fenster)
• FiveM: Server Commands (öffnet sich in einem neuen Fenster)