Diese Anleitung behandelt Lösungen für die häufigsten FiveM-Server-Probleme — TXAdmin-Zugriffsprobleme, CFX-Lizenzschlüssel-Fehler, Datenbankverbindungsfehler, Server-Abstürze, Spieler-Verbindungsprobleme und nicht ladende Ressourcen. Für die erstmalige Servereinrichtung siehe die FiveM Server-Einrichtungsanleitung.
Allgemeiner Fehlerbehebungstipp: Überprüfen Sie immer zuerst die GPanel-Konsolenausgabe und die TXAdmin-Logs. Die meisten Fehler erzeugen eine klare Meldung, die auf die Ursache hinweist.
TXAdmin lädt nicht oder ist nicht erreichbar
- Überprüfen Sie, ob der Server in GPanel läuft — TXAdmin startet nur, wenn der FiveM-Serverprozess aktiv ist.
- Prüfen Sie die GPanel-Konsole auf die TXAdmin-URL und den Port. Der TXAdmin-Port unterscheidet sich vom Spielport.
- Stellen Sie sicher, dass Sie
http://und nichthttps://verwenden — TXAdmin verwendet standardmäßig kein SSL. - Wenn TXAdmin zuvor funktioniert hat, aber nicht mehr lädt, versuchen Sie den Server über GPanel neu zu starten.
- Leeren Sie Ihren Browser-Cache oder versuchen Sie es in einem Inkognito-/Privatfenster.
TXAdmin-Passwort vergessen? Wenn Sie sich nicht einloggen können, müssen Sie möglicherweise die TXAdmin-Profildaten löschen und den Einrichtungsassistenten erneut ausführen. Überprüfen Sie den GPanel-Reiter "Dateien" auf das TXAdmin-Datenverzeichnis und entfernen Sie die Profildateien, dann starten Sie den Server neu.
CFX-Lizenzschlüssel-Fehler
| Fehlermeldung | Ursache | Lösung |
|---|---|---|
Invalid license key |
Schlüssel falsch kopiert oder zusätzliche Leerzeichen | Gehen Sie zu Keymaster, bestätigen Sie, dass der Schlüssel aktiv ist, und kopieren Sie ihn sorgfältig erneut. Fügen Sie ihn sowohl in die GPanel-Startvariable als auch in sv_licenseKey in server.cfg ein. |
License key already in use |
Schlüssel ist auf eine andere Server-IP registriert | Jeder Schlüssel kann nur auf einem Server gleichzeitig verwendet werden. Widerrufen Sie den alten Schlüssel auf Keymaster und erstellen Sie einen neuen mit Ihrer aktuellen Server-IP. |
Unable to verify license key |
Cfx.re-Authentifizierungsserver sind vorübergehend nicht verfügbar | Warten Sie einige Minuten und starten Sie den Server neu. Überprüfen Sie status.cfx.re auf Ausfälle. |
Tipp: Stellen Sie sicher, dass der Schlüssel sowohl in der GPanel-Startvariable als auch in
server.cfg (sv_licenseKey) gesetzt ist. Je nach Konfiguration kann der Server den einen oder den anderen auslesen.
Datenbankverbindungsfehler
| Fehlermeldung | Ursache | Lösung |
|---|---|---|
Connection refused oder ETIMEDOUT |
Falscher Datenbank-Host oder Port | Überprüfen Sie die Datenbank-Hostadresse und den Port im GPanel-Reiter Databases. Verwenden Sie nicht localhost oder 127.0.0.1. |
Access denied |
Falscher Benutzername oder Passwort | Kopieren Sie die Zugangsdaten direkt aus GPanel, um Tippfehler zu vermeiden. Passwörter sind groß-/kleinschreibungssensitiv. |
Unknown database |
Datenbankname stimmt nicht überein | Stellen Sie sicher, dass der Datenbankname in Ihrem Verbindungsstring genau mit dem in GPanel angezeigten übereinstimmt. |
Weitere Schritte zur Datenbank-Fehlerbehebung:
- Wenn Sie oxmysql verwenden, stellen Sie sicher, dass die
oxmysql-Ressource in Ihremresources/-Ordner vorhanden ist und dassensure oxmysqlin server.cfg vor allen Ressourcen steht, die eine Datenbank benötigen. - Wenn Ihr Passwort Sonderzeichen wie
@,#oder%enthält, URL-kodieren Sie diese im Verbindungsstring (z.B.@wird zu%40). - Überprüfen Sie Ihren Verbindungsstring auf fehlende oder überzählige Zeichen — selbst ein einziges falsches Zeichen verursacht einen Fehler.
Verwenden Sie nicht localhost. Der Datenbankserver ist vom Spielserver getrennt. Verwenden Sie immer die vollständige Hostadresse, die im GPanel-Reiter "Databases" angezeigt wird.
Server stürzt beim Start ab
- Überprüfen Sie die GPanel-Konsole auf Fehlermeldungen. Häufige Ursachen sind eine fehlende oder falsch konfigurierte
server.cfg, ein ungültiger CFX-Lizenzschlüssel oder eine fehlerhafte Ressource. - Versuchen Sie, benutzerdefinierte Ressourcen zu deaktivieren, indem Sie sie in server.cfg auskommentieren (fügen Sie
#vor jederensure-Zeile hinzu) und starten Sie neu. Fügen Sie sie einzeln wieder hinzu, um die problematische Ressource zu identifizieren. - Stellen Sie sicher, dass die Ports in
endpoint_add_tcpundendpoint_add_udpmit Ihrem in GPanel zugewiesenen Port übereinstimmen.
# Comment out resources to isolate the problem
#ensure suspicious-resource
#ensure another-resource
# Keep core resources enabled
ensure mapmanager
ensure spawnmanager
ensure sessionmanager
ensure hardcap
ensure chat
Binäre Suche nach fehlerhaften Ressourcen: Wenn Sie viele Ressourcen haben, kommentieren Sie jeweils die Hälfte aus, anstatt einzeln vorzugehen. Das grenzt das Problem wesentlich schneller ein.
Spieler können sich nicht verbinden
- Bestätigen Sie, dass der Server in GPanel als Running angezeigt wird.
- Überprüfen Sie die IP und den Port — Spieler sollten den Spielport verwenden, nicht den TXAdmin-Port.
- Prüfen Sie, dass
sv_maxclientsnicht auf 0 oder eine unrealistisch niedrige Zahl gesetzt ist. - Wenn Sie ein Serverpasswort verwenden (
sv_passwordin server.cfg), stellen Sie sicher, dass die Spieler es kennen. - Spieler müssen den FiveM-Client installiert haben — sie können sich nicht über den regulären GTA V-Launcher verbinden.
- Überprüfen Sie den GPanel-Reiter Network und bestätigen Sie, dass die Ports in
endpoint_add_tcpundendpoint_add_udpübereinstimmen. Eine Abweichung verhindert Verbindungen.
Server nicht im Browser sichtbar? Neue Server können 5-15 Minuten brauchen, um in der FiveM-Serverliste zu erscheinen. Verwenden Sie in der Zwischenzeit die Direktverbindung (
IP:PORT). Überprüfen Sie außerdem, dass Ihr sv_licenseKey gültig ist.
Ressourcen laden nicht
- Prüfen Sie, ob der Ressourcen-Ordner sich im
resources/-Verzeichnis (oder einem entsprechenden Unterordner) befindet. - Stellen Sie sicher, dass der Ordnername exakt mit der
ensure-Zeile in server.cfg übereinstimmt (Groß-/Kleinschreibung beachten). - Jede Ressource muss eine gültige
fxmanifest.lua(oder die ältere__resource.lua) enthalten. Fehlt diese Datei, wird die Ressource nicht geladen. - Überprüfen Sie die TXAdmin- oder GPanel-Konsole auf Fehlermeldungen zur Ressource. Häufige Fehler sind fehlende Abhängigkeiten oder Lua-Syntaxfehler.
- Wenn die Ressource ein Framework (ESX, QBCore) benötigt, stellen Sie sicher, dass das Framework in server.cfg vor der Ressource geladen wird.
- Wenn die Ressource eine Datenbank benötigt, stellen Sie sicher, dass Ihre MySQL-Ressource (oxmysql, mysql-async) geladen ist und die Datenbankverbindung funktioniert.
Ordnerstruktur überprüfen. Ein häufiger Fehler ist das Hochladen einer Ressource, wobei ein doppelt verschachtelter Ordner entsteht wie
resources/my-resource/my-resource/fxmanifest.lua. Das Manifest muss sich direkt im Ressourcen-Ordner befinden: resources/my-resource/fxmanifest.lua.
Server-Leistungsprobleme
- Öffnen Sie TXAdmin und überprüfen Sie das Dashboard auf Leistungskennzahlen (Tick-Zeit, Spieleranzahl, Speicherauslastung).
- Ein gesunder FiveM-Server sollte eine Server-Tick-Zeit (auch "Hitch" genannt) unter 20ms aufrechterhalten. Konstante Spitzen darüber hinaus deuten darauf hin, dass eine Ressource zu viel Rechenzeit beansprucht.
- Verwenden Sie die TXAdmin-Seite Resources, um zu identifizieren, welche Ressourcen die meiste Serverzeit verbrauchen.
- Entfernen oder ersetzen Sie schlecht optimierte Ressourcen. Kostenlose Ressourcen aus unbekannten Quellen sind häufig die Ursache von Leistungsproblemen.
- Reduzieren Sie die Anzahl der geladenen Ressourcen, wenn die Speicher- oder CPU-Grenzen Ihres Serverplans erreicht werden.
Hilfe erhalten
Wenn Sie die oben genannten Lösungen ausprobiert haben und weiterhin Probleme auftreten:
- Kopieren Sie die vollständige Fehlermeldung aus der GPanel-Konsole oder dem TXAdmin-Log.
- Notieren Sie, welche Fehlerbehebungsschritte Sie bereits durchgeführt haben.
- Eröffnen Sie ein Support-Ticket unter https://legionhosting.net/submitticket.php mit diesen Informationen. Unser Team wird Ihnen so schnell wie möglich helfen.
