Wie verbinde ich eine MySQL-Datenbank mit oxmysql mit einem FiveM-Server?
Die Datenbank im Panel anlegen, oxmysql installieren, mysql_connection_string in server.cfg eintragen, das SQL von ESX oder QBCore importieren und die
oxmysql ist die Ressource, die einen FiveM- oder RedM-Server mit einer MySQL- oder MariaDB-Datenbank verbindet. ESX Legacy, QBCore und Qbox hängen davon ab: Ohne Datenbankverbindung startet das Framework nicht. Bei ACLClouds liegt die Datenbank auf einem eigenen MariaDB-Server und ist im Angebot enthalten: 1 Datenbank bei Dev, 2 bei City, 3 bei Empire.
Schritt-für-Schritt-Anleitung
-
Datenbank erstellen
Klicken Sie unter „Datenbanken“ auf „Neue Datenbank“, geben Sie einen kurzen Namen wie esx oder qbcore ein und lassen Sie „Verbindungen von“ leer, damit Spielserver und PC zugreifen dürfen. Das Panel stellt dem Namen ein Präfix voran: Die Datenbank heißt dann zum Beispiel s12345_esx.
-
Sammeln Sie Identifikatoren
Öffnen Sie die Datenbank in der Liste: Das Panel zeigt den „Endpunkt“ (Host und Port), den „Benutzernamen“, das „Passwort“ und eine JDBC-Verbindungszeichenfolge. Der Host ist die Adresse des Datenbankservers, niemals localhost oder 127.0.0.1.
-
oxmysql installieren
Laden Sie oxmysql.zip aus dem neuesten Release auf der Releases-Seite des GitHub-Repositorys overextended/oxmysql herunter, nicht den Quellcode: Nur das Release-Archiv enthält die kompilierten Dateien. Entpacken Sie es mit „Dateien“ nach resources/[standalone]/oxmysql. Die ESX- und QBCore-Rezepte von txAdmin installieren es bereits.
-
Die Verbindung in server.cfg eintragen
Fügen Sie set mysql_connection_string mit Benutzer, Passwort, Host, Port und Datenbankname hinzu, dann ensure oxmysql vor dem Framework und vor allen Ressourcen, die die Datenbank nutzen.
-
Die Tabellen importieren
Frameworks und viele Skripte liefern eine .sql-Datei mit. Importieren Sie sie von Ihrem PC aus mit HeidiSQL, DBeaver oder dem Client mariadb und den Zugangsdaten aus dem Panel. Ein txAdmin-Rezept legt seine Tabellen selbst an.
-
Neu starten und Konsole prüfen
Beim Start meldet oxmysql in der Konsole die Verbindung zur Datenbank mit der MariaDB-Version. Ein Fehler nennt fast immer seine Ursache: Host, Passwort oder Datenbankname.
Verbindung in server.cfg (URL-Format)
set mysql_connection_string "mysql://u12345_AbCdEf:PASSWORD@HOST:3306/s12345_esx?charset=utf8mb4"
ensure oxmysql
ensure es_extended
Weiteres von oxmysql akzeptiertes Format
set mysql_connection_string "host=HOST;port=3306;user=u12345_AbCdEf;password=PASSWORD;database=s12345_esx"
Nützliche oxmysql-Optionen
set mysql_slow_query_warning 150
set mysql_ui true
Vom PC aus importieren und exportieren
mariadb -h HOST -P 3306 -u u12345_AbCdEf -p s12345_esx < es_extended.sql
mariadb-dump -h HOST -P 3306 -u u12345_AbCdEf -p s12345_esx > backup.sql
Bevor Sie beginnen
Datenbanken sind in den kostenpflichtigen FiveM-Angeboten enthalten, bis zur Grenze, die oben unter „Datenbanken“ angezeigt wird. Jede Datenbank hat ihren eigenen Benutzer und eigene Rechte. Alle Skripte eines Servers teilen sich in der Regel dieselbe Datenbank.
- Stoppen Sie den Server, bevor Sie server.cfg ändern.
- Mit txAdmin bearbeiten Sie die server.cfg des Rezepts im Ordner txData, nicht die im Stammverzeichnis.
- Starten Sie nicht gleichzeitig mysql-async oder ghmattimysql: oxmysql stellt deren Funktionen für ältere Skripte bereit.
Sonderzeichen im Passwort
Im URL-Format zerstören die Zeichen @, :, /, #, ? und % im Passwort die Zeichenfolge. Kodieren Sie sie (@ wird zu %40), nutzen Sie das Format key=value oder übernehmen Sie die JDBC-Zeichenfolge aus dem Panel, in der das Passwort bereits kodiert ist, ohne das Präfix jdbc:.
Die Schaltfläche zum Rotieren des Passworts erzeugt ein neues: Aktualisieren Sie server.cfg sofort, sonst verbindet sich oxmysql beim nächsten Start nicht mehr.
Die Datenbank sichern
Die Backups des Panels sichern die Serverdateien, nicht die Datenbank. Exportieren Sie sie regelmäßig mit mariadb-dump oder dem Export von HeidiSQL, vor allem vor jedem Framework-Update, und bewahren Sie eine Kopie außerhalb des Servers auf.
Häufige Fehler und Lösungen
oxmysql schreibt die Ursache des Fehlers beim Serverstart in die Konsole.
- ECONNREFUSED oder ETIMEDOUT: falscher Host oder Port. Übernehmen Sie den „Endpunkt“ erneut; localhost funktioniert nicht, die Datenbank liegt nicht im Container des Spiels.
- ER_ACCESS_DENIED_ERROR: falscher Benutzer oder falsches Passwort, oft wegen eines nicht kodierten Sonderzeichens, oder ein Wert unter „Verbindungen von“, der den Spielserver ausschließt.
- ER_BAD_DB_ERROR: unbekannter Datenbankname. Geben Sie den vollständigen Namen mit Präfix an, zum Beispiel s12345_esx.
- ER_NO_SUCH_TABLE: Die Datenbank ist leer oder unvollständig. Importieren Sie die .sql-Datei des betroffenen Frameworks oder Skripts.
- No such export zu oxmysql beim Laden eines Skripts: oxmysql startet zu spät. Setzen Sie ensure oxmysql vor das Framework.
Schnellüberprüfung
- Die Konsole zeigt die Verbindung von oxmysql zur Datenbank ohne Fehler.
- ensure oxmysql steht vor dem Framework.
- Die Tabellen des Frameworks erscheinen in HeidiSQL oder DBeaver.
- Ein aktueller .sql-Export liegt außerhalb des Servers.
Häufig gestellte Fragen
Muss ich MySQL auf dem FiveM-Server installieren?
Nein. Die Datenbank liegt auf einem separaten MariaDB-Server, der im Angebot enthalten ist: Sie legen sie unter „Datenbanken“ an, und oxmysql verbindet sich über das Netzwerk. MariaDB ist für ESX, QBCore und Qbox mit MySQL kompatibel.
Wie kann ich die Tabellen ansehen und bearbeiten?
Verbinden Sie sich von Ihrem PC mit HeidiSQL oder DBeaver und verwenden Sie Host, Port, Benutzer und Passwort aus dem Panel. Erstellen Sie vor jeder manuellen Änderung einen Export.
Kann ich eine externe Datenbank nutzen?
Ja. oxmysql verbindet sich mit jedem MySQL- oder MariaDB-Server, der vom Spielserver erreichbar ist: Tragen Sie Host und Zugangsdaten in mysql_connection_string ein. Eine Datenbank nahe am Spielserver antwortet schneller, was für Skripte mit häufigen Abfragen zählt.
Die Konsole meldet langsame Abfragen, was tun?
oxmysql meldet Abfragen, die länger als mysql_slow_query_warning (standardmäßig 200 ms) dauern, und nennt die verantwortliche Ressource. Legen Sie einen Index auf die gefilterte Spalte an oder ersetzen Sie das Skript: Eine Ressource, die die Datenbank in einer Schleife abfragt, bremst den ganzen Server.