oxmysql einrichten: FiveM MySQL-Datenbank in 5 Schritten

oxmysql ist die FiveM-Ressource, die deinen Server mit einer MySQL- oder MariaDB-Datenbank verbindet. Um oxmysql einzurichten, lädst du die aktuelle Version von GitHub, trägst in der server.cfg deinen mysql_connection_string ein und startest oxmysql vor allen Ressourcen, die die Datenbank nutzen. Jedes RP-Framework auf FiveM, ob ESX, QBCore oder Qbox, speichert Spielerdaten in dieser Datenbank. Ohne Datenbank funktioniert das Framework nicht: kein Inventar, keine Fahrzeuge, kein Geld, keine Jobs.

Eigener FiveM-Server? Bei HostValues ab €5,60 pro Monat, in wenigen Minuten online. Pakete ansehen →

Schritt 1: Datenbank erstellen

Bei allen FiveM-Paketen von HostValues ist eine Datenbank inklusive. Im Gamepanel findest du unter Databases die Option, eine neue Datenbank zu erstellen. Nach der Erstellung siehst du:

• Host: Die Adresse des Datenbankservers (meistens localhost oder eine interne IP)
• Port: Standard 3306
• Datenbankname: Der Name, den du gewählt hast
• Benutzername: Automatisch generiert
• Passwort: Klicke auf das Augensymbol, um es anzuzeigen

Schritt 2: oxmysql installieren

Lade die neueste Version von oxmysql von GitHub herunter (Stand: 7. Oktober 2026 ist das v2.14.3). Entpacke sie und lade den Ordner nach resources/[ox]/oxmysql/ hoch. Füge in server.cfg hinzu:

ensure oxmysql

Setze dies über alle Resources, die die Datenbank verwenden.

Schritt 3: Connection String einstellen

Füge in server.cfg den Connection String hinzu. Laut oxmysql-Doku muss diese Zeile vor dem Start der Ressourcen stehen, also oberhalb von ensure oxmysql:

set mysql_connection_string "mysql://benutzer:passwort@host:3306/datenbankname?charset=utf8mb4"

Ersetze die Werte durch die aus Schritt 1. Achte auf Sonderzeichen im Passwort: Laut oxmysql-Doku sind je nach Format Zeichen wie ; , / ? : @ & = + $ # reserviert oder werden nicht unterstützt, und eine URL-Kodierung wie %40 wandelt oxmysql nicht zurück. Am sichersten ist ein Passwort ohne diese Zeichen; sonst hilft oft der Wechsel auf das zweite Format mit Semikolons:

set mysql_connection_string "user=benutzer;password=passwort;host=host;port=3306;database=datenbankname;charset=utf8mb4"

Schritt 4: Framework-SQL importieren

Jedes Framework hat SQL-Dateien, die die Datenbanktabellen erstellen. Öffne phpMyAdmin über das Gamepanel (Button neben der Datenbank), klicke auf "Importieren" und lade die SQL-Datei deines Frameworks hoch:

• ESX: es_extended.sql
• QBCore: qb-core.sql
• Qbox: Die SQL aus dem Recipe oder dem qbx_core-Ordner

Die meisten Scripts, die du später hinzufügst, haben ebenfalls eigene SQL-Dateien. Importiere sie auf die gleiche Weise.

Schritt 5: Testen

Starte den Server. In der Konsole solltest du die Meldung sehen:

[oxmysql] Database server connection established

Siehst du "connection refused" oder "access denied", prüfe den Connection String auf Tippfehler, ob die Datenbank erstellt wurde und ob das Passwort stimmt.

Häufige Probleme

• ER_NOT_SUPPORTED_AUTH_MODE: Dein MySQL-Server erfordert einen anderen Authentifizierungsmechanismus. Bei MariaDB tritt das selten auf; bei MySQL 8+ musst du mysql_native_password einstellen.
• Tabellen existieren bereits: Du importierst die SQL doppelt. Kein Problem, der Import überschreibt nichts, wenn die Tabellen bereits existieren.
• Charset-Fehler: Vergiss ?charset=utf8mb4 nicht im Connection String. Ohne diesen Parameter werden Emojis und Sonderzeichen nicht korrekt gespeichert.

Häufige Fragen

Kann ich SQLite statt MySQL verwenden?

Technisch ja, aber kein RP-Framework unterstützt das standardmäßig. MySQL oder MariaDB ist die Erwartung. Bei HostValues ist eine Datenbank bei jedem FiveM-Paket inklusive, es gibt also keinen Grund für SQLite.

Wie erstelle ich ein Backup meiner Datenbank?

Über phpMyAdmin: Wähle die Datenbank aus, klicke auf "Exportieren", wähle "Schnell" und "SQL" und lade die Datei herunter. Speichere sie separat. Bei einer Neuinstallation importierst du diese Datei wieder.

Kann ich die Datenbank ansehen, während der Server läuft?

Ja. phpMyAdmin zeigt Live-Daten. Du kannst Spielerdaten, Fahrzeuge und Inventare direkt einsehen und bei Bedarf manuell anpassen. Sei vorsichtig: Ein Fehler in der Datenbank kann Spielerdaten beschädigen.

Welche oxmysql-Version ist aktuell?

Stand: 7. Oktober 2026 ist v2.14.3 vom 6. Oktober 2026 die neueste Version. oxmysql wird weiterhin von Overextended auf GitHub gepflegt, der Fork von CommunityOx ist archiviert. Nutze mindestens Version 2.14.0: Sie aktualisiert die Abhängigkeit mysql2 und schließt damit mehrere Sicherheitslücken, darunter eine SQL-Injection.

Ersetzt oxmysql mysql-async und ghmattimysql?

Ja. oxmysql versteht die Syntax von mysql-async und ghmattimysql. Laut offizieller Doku kannst du beide Ressourcen löschen, oxmysql übernimmt ihre Funktion.

Soll ich für FiveM MySQL oder MariaDB nutzen?

Die oxmysql-Doku empfiehlt ausdrücklich MariaDB, auch wegen der besseren Performance. Viele FiveM-Ressourcen wurden für MySQL 5.7 geschrieben und können mit MySQL 8 Probleme bekommen, etwa durch zusätzliche reservierte Wörter.

Eine Datenbank ist bei allen FiveM-Paketen inklusive. Bei Fragen zur Datenbankeinrichtung hilft unser Supportteam.