Fehlerbehebungsanleitung für häufige RedM-Serverprobleme, einschließlich Lizenzschlüsselfehler, Sichtbarkeit im Serverbrowser, Ressourcenfehler, Client-Verbindungen, Datenbankprobleme und Leistungsoptimierung. Für Ersteinrichtungsanweisungen siehe unsere RedM Server-Einrichtungsanleitung.
Lizenzschlüsselfehler
Lizenzschlüsselprobleme sind das häufigste Problem beim Starten eines neuen RedM-Servers. Hier sind die typischen Fehler und ihre Lösungen:
"Invalid license key" oder "Could not authenticate"
| Ursache | Lösung |
|---|---|
| Lizenzschlüssel ist falsch eingegeben oder enthält zusätzliche Leerzeichen | Kopieren Sie den Schlüssel direkt von Keymaster. Entfernen Sie alle führenden/nachfolgenden Leerzeichen aus der CFX_LICENSE-Startvariable in GPanel oder der sv_licenseKey-Zeile in server.cfg. |
| IP-Adressen-Abweichung | Der Schlüssel ist auf eine andere IP registriert als die tatsächliche IP Ihres Servers. Gehen Sie zu Keymaster, überprüfen Sie die registrierte IP und aktualisieren Sie sie, damit sie mit der in GPanel angezeigten Server-IP übereinstimmt. |
| Schlüssel sowohl in GPanel als auch in server.cfg mit unterschiedlichen Werten gesetzt | Stellen Sie sicher, dass der Schlüssel konsistent ist. Am besten setzen Sie ihn in der GPanel-Startvariable und lassen das Egg die Übergabe an den Server übernehmen. Entfernen oder kommentieren Sie sv_licenseKey aus server.cfg aus, wenn GPanel dies übernimmt. |
| Cfx.re-Kontoproblem oder Schlüssel widerrufen | Melden Sie sich bei Keymaster an und überprüfen Sie, ob der Schlüssel noch aktiv ist. Generieren Sie einen neuen Schlüssel, wenn der alte gelöscht oder abgelaufen ist. |
| Keymaster-Dienst ist vorübergehend nicht verfügbar | Überprüfen Sie die Cfx.re-Statusseite auf Ausfälle. Warten Sie und versuchen Sie es später erneut. |
Wichtig: Wenn Sie kürzlich einen neuen Server erhalten haben oder sich Ihre Server-IP geändert hat (z. B. nach einer Node-Migration), müssen Sie die IP in Keymaster aktualisieren oder einen neuen Lizenzschlüssel generieren. Der alte Schlüssel funktioniert nicht auf einer anderen IP.
Server erscheint nicht im Browser
Wenn Ihr Server läuft, aber Spieler ihn nicht im RedM-Serverbrowser finden können:
Checkliste
- Warten Sie mindestens 5 Minuten. Nach dem Start benötigt der Server Zeit, um sich bei der Cfx.re-Masterserverliste zu registrieren. Neue Server können mehrere Minuten brauchen, bis sie erscheinen.
- Überprüfen Sie, ob der Lizenzschlüssel gültig ist. Der Server wird ohne einen funktionierenden Lizenzschlüssel nicht gelistet. Überprüfen Sie die Serverkonsole auf lizenzbezogene Fehler.
- Überprüfen Sie die Endpunkt-Konfiguration. Stellen Sie sicher, dass
endpoint_add_tcpundendpoint_add_udpinserver.cfgden richtigen Port verwenden:
Der Port muss mit dem in GPanel zugewiesenen übereinstimmen.endpoint_add_tcp "0.0.0.0:30120" endpoint_add_udp "0.0.0.0:30120" - Überprüfen Sie "sv_master1" oder Listing-Einstellungen. Stellen Sie sicher, dass Sie den Server nicht versehentlich so eingestellt haben, dass er sich nicht listet. Es sollte kein
sv_master1 ""in Ihrer Konfiguration stehen (dies deaktiviert die Masterlisten-Registrierung). - Überprüfen Sie, ob der Server tatsächlich läuft. Prüfen Sie die GPanel-Konsole. Wenn der Server abgestürzt oder gestoppt ist, wird er nicht im Browser erscheinen.
- Versuchen Sie eine Direktverbindung. Auch wenn der Server nicht im Browser ist, sollte eine Direktverbindung funktionieren. Lassen Sie einen Spieler F8 in RedM drücken und eingeben:
connect YOUR_SERVER_IP:PORT
Tipp: Sie können überprüfen, ob Ihr Server erreichbar ist, indem Sie die Cfx.re-Serversuche verwenden. Versuchen Sie,
http://YOUR_SERVER_IP:PORT/info.json in einem Webbrowser aufzurufen. Wenn der Server läuft und erreichbar ist, wird er eine JSON-Antwort mit Serverinformationen zurückgeben.
Fehler beim Laden von Ressourcen
Ressourcenfehler sind häufig beim Hinzufügen neuer Skripte oder Frameworks zu Ihrem Server. Hier sind die häufigsten Probleme:
"Could not find resource [resource_name]"
- Der Ressourcenordner existiert nicht im
resources/-Verzeichnis oder befindet sich am falschen Ort. - Der Ordnername stimmt nicht mit dem in
ensureverwendeten Namen überein. Ressourcennamen sind groß-/kleinschreibungsabhängig. - Lösung: Überprüfen Sie, ob der Ressourcenordner existiert und der Name in
server.cfggenau übereinstimmt. Verwenden Sie den GPanel-Dateimanager oder SFTP zur Überprüfung.
"Failed to load resource [resource_name]: manifest error"
- Die
fxmanifest.luaoder__resource.luader Ressource hat einen Syntaxfehler. - Das Manifest verweist auf Dateien, die nicht im Ressourcenordner existieren.
- Lösung: Öffnen Sie die Manifestdatei und prüfen Sie auf Tippfehler, fehlende Kommas oder Verweise auf nicht existierende Dateien. Überprüfen Sie die Serverkonsole auf die genaue Zeilennummer des Fehlers.
"Error loading script [filename]: [error details]"
- Eine Lua-, C#- oder JavaScript-Datei innerhalb der Ressource hat einen Syntax- oder Laufzeitfehler.
- Lösung: Lesen Sie die vollständige Fehlermeldung in der Konsole. Sie enthält den Dateinamen und die Zeilennummer. Häufige Ursachen sind:
- Fehlende Abhängigkeiten (eine andere Ressource, die zuerst geladen werden muss)
- Veraltete Ressource, die nicht mit der aktuellen RedM-Serverversion kompatibel ist
- Falsche Konfigurationswerte in der Konfigurationsdatei der Ressource
Probleme mit der Ressourcen-Ladereihenfolge
Ressourcen in server.cfg werden in der Reihenfolge geladen, in der sie erscheinen. Wenn eine Ressource von einer anderen abhängt (z. B. vorp_inventory von vorp_core), muss die Abhängigkeit zuerst aufgeführt werden:
# Correct order - dependencies first
ensure oxmysql
ensure vorp_core
ensure vorp_inventory
ensure vorp_stores
# Wrong order - will cause errors
# ensure vorp_inventory <-- depends on vorp_core
# ensure vorp_core <-- loaded too late
Warnung: Wenn eine Ressource nicht geladen werden kann, werden alle Ressourcen, die von ihr abhängen, ebenfalls fehlschlagen. Überprüfen Sie immer sorgfältig die Konsolenausgabe, um die Grundursache zu identifizieren, die normalerweise der erste angezeigte Fehler ist.
Client-Verbindungsprobleme
Wenn Spieler keine Verbindung zu Ihrem Server herstellen können:
"Connection timed out" / "Failed to connect"
| Ursache | Lösung |
|---|---|
| Server läuft nicht | Überprüfen Sie die GPanel-Konsole, um zu bestätigen, dass der Server online ist und nicht abgestürzt ist. |
| Falsche IP oder falscher Port | Überprüfen Sie, ob der Spieler die richtige IP und den richtigen Port aus GPanel verwendet. Siehe So finden Sie Ihre Server-IP und Ihren Port. |
| Endpunkt-Fehlkonfiguration | Stellen Sie sicher, dass endpoint_add_tcp und endpoint_add_udp in server.cfg den Port 0.0.0.0:PORT verwenden, wobei PORT mit GPanel übereinstimmt. |
| Server ist voll | Überprüfen Sie, ob sv_maxclients erreicht wurde. Erhöhen Sie den Wert, wenn Ihr Hosting-Plan dies zulässt. |
"Connection rejected by server"
- Serverpasswort: Wenn
sv_passwordgesetzt ist, muss der Spieler das richtige Passwort eingeben. - Whitelist/Allowlist-Ressource: Wenn Sie eine Whitelist-Ressource aktiviert haben, muss der Spieler genehmigt werden, bevor er sich verbinden kann.
- Bann: Der Spieler könnte gebannt sein. Überprüfen Sie Ihre Bannliste oder Datenbank auf seine Identifikatoren.
Client stürzt beim Verbinden ab
- Eine Ressource auf dem Server sendet fehlerhafte Daten oder hat einen clientseitigen Skriptfehler, der den Client zum Absturz bringt.
- Lösung: Deaktivieren Sie kürzlich hinzugefügte Ressourcen einzeln, um die problematische zu identifizieren. Überprüfen Sie die Serverkonsole auf Fehler während der Client-Verbindung.
- Stellen Sie sicher, dass der RedM-Client des Spielers auf dem neuesten Stand ist.
"Could not download file"-Fehler
- Der Server versucht, eine große Datei (z. B. ein Streaming-Asset) zu senden, die die Übertragungslimits überschreitet, oder die Verbindung ist instabil.
- Lösung: Reduzieren Sie die Größe der gestreamten Assets, verwenden Sie ein CDN/externes Hosting für große Dateien, falls unterstützt, oder lassen Sie den Spieler die Verbindung erneut versuchen.
Datenbankprobleme (MySQL / oxmysql)
Die meisten RedM-Roleplay-Frameworks verwenden MySQL für die persistente Datenspeicherung. Der am häufigsten verwendete Datenbank-Connector ist oxmysql.
Verbindungsfehler
Wenn oxmysql (oder ein anderer MySQL-Connector) keine Verbindung herstellen kann, überprüfen Sie Folgendes:
# Typical oxmysql connection string in server.cfg
set mysql_connection_string "mysql://user:password@host:3306/database_name?charset=utf8mb4"| Fehler | Lösung |
|---|---|
ECONNREFUSED oder "Connection refused" |
Der MySQL-Server läuft nicht, der Host/Port ist falsch oder der MySQL-Server akzeptiert keine externen Verbindungen. Überprüfen Sie Host, Port und ob Ihr Datenbankserver online ist. |
ER_ACCESS_DENIED_ERROR |
Falscher Benutzername oder falsches Passwort in der Verbindungszeichenkette. Überprüfen Sie die Anmeldedaten in Ihrem Datenbank-Hosting-Panel. |
ER_BAD_DB_ERROR |
Der Datenbankname existiert nicht. Erstellen Sie die Datenbank zuerst über Ihr Datenbankverwaltungspanel (phpMyAdmin usw.). |
ETIMEDOUT |
Der Datenbankserver ist nicht erreichbar. Überprüfen Sie, ob Firewall-Regeln die Verbindung blockieren oder ob der Datenbank-Host korrekt ist. |
| "Too many connections" | Die Datenbank hat ihr maximales Verbindungslimit erreicht. Dies kann passieren, wenn Ressourcen Verbindungen nicht ordnungsgemäß schließen oder wenn das Limit zu niedrig ist. Starten Sie den Server neu und überprüfen Sie Ihre MySQL max_connections-Einstellung. |
Tipp: Wenn Ihr RedM-Server und die MySQL-Datenbank auf demselben Rechner laufen, verwenden Sie
localhost oder 127.0.0.1 als Host. Wenn sie auf verschiedenen Servern laufen, verwenden Sie die IP-Adresse des Datenbankservers und stellen Sie sicher, dass der MySQL-Benutzer Berechtigungen für Remote-Verbindungen hat.
Fehlende Tabellen oder Schema-Fehler
Roleplay-Frameworks erfordern oft, dass Datenbanktabellen eingerichtet werden, bevor sie funktionieren können:
- Überprüfen Sie die Dokumentation oder das GitHub-Repository des Frameworks auf SQL-Importdateien (oft als
database.sql,schema.sqloder ähnlich benannt). - Importieren Sie die SQL-Datei in Ihre Datenbank mit phpMyAdmin oder einem MySQL-Client.
- Einige Frameworks erstellen Tabellen automatisch beim ersten Start. Stellen Sie sicher, dass der Datenbankbenutzer
CREATE TABLE-Berechtigungen hat.
Leistungsprobleme
Wenn Ihr RedM-Server Verzögerungen, niedrige Tickrate oder allgemein schlechte Leistung aufweist:
Leistungsprobleme identifizieren
Überprüfen Sie die Serverkonsole auf Leistungswarnungen. RedM-Server zielen auf eine Tickrate von etwa 30-64 Ticks pro Sekunde ab. Sie können dies überwachen mit:
- txAdmin-Dashboard: Wenn txAdmin verfügbar ist, zeigt es Echtzeit-Serverleistungsmetriken an.
- Serverkonsole: Achten Sie auf "slow tick"- oder "resource hitch"-Warnungen.
- resmon-Befehl: Geben Sie
resmon 1in der Serverkonsole (oder F8-Konsole) ein, um den Ressourcenmonitor zu aktivieren, der die CPU-Zeit pro Ressource anzeigt.
Häufige Leistungslösungen
| Problem | Lösung |
|---|---|
| Hohe CPU-Auslastung durch eine bestimmte Ressource | Verwenden Sie resmon 1, um die Ressource zu identifizieren. Erwägen Sie, sie durch eine optimiertere Alternative zu ersetzen, oder kontaktieren Sie den Ressourcenentwickler. |
| Zu viele geladene Ressourcen | Jede Ressource verbraucht Serverressourcen. Überprüfen Sie Ihre Ressourcenliste und entfernen Sie alle ungenutzten oder redundanten. |
| Datenbank-Abfrage-Engpass | Langsame oder nicht indizierte Datenbankabfragen können Server-Ruckler verursachen. Überprüfen Sie die oxmysql-Warnungen zu langsamen Abfragen in der Konsole. Fügen Sie Indizes zu häufig abgefragten Spalten hinzu. |
| Hohe Spielerzahl verursacht Verzögerungen | Reduzieren Sie sv_maxclients auf ein Niveau, das Ihre Serverhardware bewältigen kann. Erwägen Sie ein Upgrade Ihres Hosting-Plans für mehr Ressourcen. |
| OneSync-Entity-Limits | Zu viele gespawnte Entities (Peds, Fahrzeuge, Objekte) können die Leistung beeinträchtigen. Verwenden Sie Ressourcen, die ungenutzte Entities aufräumen. |
| Speicherlecks | Einige schlecht programmierte Ressourcen verursachen im Laufe der Zeit Speicherlecks. Überwachen Sie die Server-RAM-Nutzung in GPanel. Regelmäßige Serverneustarts (alle 6-12 Stunden) können dies abmildern. |
Empfohlene Vorgehensweisen
- Planen Sie automatische Neustarts alle 6-12 Stunden mit der Zeitplanfunktion von GPanel oder txAdmin, um angesammelten Speicher und Entity-Probleme zu bereinigen.
- Halten Sie Ressourcen aktuell, um von Leistungsverbesserungen und Optimierungen zu profitieren.
- Vermeiden Sie doppelte Funktionalität — betreiben Sie nicht zwei Ressourcen, die dasselbe tun (z. B. zwei Wettersysteme).
- Testen Sie neue Ressourcen auf einem Testserver (oder mit geringer Spielerzahl), bevor Sie sie auf Ihrem Hauptserver einsetzen.
- Überwachen Sie Servermetriken regelmäßig über GPanel oder txAdmin, um Probleme frühzeitig zu erkennen.
Hinweis: Wenn Sie trotz Optimierung ständig Leistungsprobleme haben, benötigt Ihr Server möglicherweise einen höherwertigen Hosting-Plan mit mehr CPU- und RAM-Ressourcen. Kontaktieren Sie unser Support-Team, um Upgrade-Optionen zu besprechen.
Allgemeine Fehlerbehebungstipps
- Lesen Sie immer die Serverkonsolen-Ausgabe. Fast jeder Fehler enthält eine Nachricht in der Konsole, die Ihnen sagt, was schiefgelaufen ist und wo.
- Starten Sie den Server nach Konfigurationsänderungen neu. Die meisten Änderungen an
server.cfgerfordern einen vollständigen Serverneustart, um wirksam zu werden. - Deaktivieren Sie Ressourcen einzeln, um Probleme zu isolieren. Kommentieren Sie
ensure-Zeilen inserver.cfgmit#aus. - Erstellen Sie Backups von funktionierenden Konfigurationen, bevor Sie Änderungen vornehmen. Laden Sie Ihre
server.cfgund Datenbank vor größeren Updates herunter. - Überprüfen Sie Cfx.re-Foren und Dokumentation unter docs.fivem.net für offizielle Dokumentation, die sowohl für FiveM als auch für RedM gilt.
- Überprüfen Sie die Ressourcenkompatibilität mit Ihrer Serverversion. Ressourcen, die für ältere Versionen erstellt wurden, funktionieren möglicherweise nicht mit aktuellen RedM-Builds.
Verwandte Artikel
- RedM Server-Einrichtungsanleitung — Lizenzschlüssel, server.cfg-Konfiguration, Ressourcenverwaltung und Verbinden.
- So finden Sie Ihre Server-IP und Ihren Port
- So laden Sie Dateien über SFTP hoch
- Erste Schritte mit Ihrem neuen Server
Brauchen Sie Hilfe?
Haben Sie immer noch Probleme mit Ihrem RedM-Server? Eröffnen Sie ein Support-Ticket und fügen Sie alle Fehlermeldungen aus Ihrer Serverkonsole bei. Unser Team hilft Ihnen bei der Diagnose und Behebung des Problems.
