Jedes RP-Framework auf FiveM, ob ESX, QBCore oder Qbox, speichert Spielerdaten in einer MySQL- oder MariaDB-Datenbank. Ohne Datenbank funktioniert das Framework nicht: kein Inventar, keine Fahrzeuge, kein Geld, keine Jobs. oxmysql ist der Standard-Connector, der das Framework mit der Datenbank verbindet.
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 gewaehlt hast
- Benutzername: Automatisch generiert
- Passwort: Klicke auf das Augensymbol, um es anzuzeigen
Schritt 2: oxmysql installieren
Lade oxmysql von GitHub herunter. Entpacke es und lade den Ordner nach resources/[ox]/oxmysql/ hoch. Fuege in server.cfg hinzu:
ensure oxmysql
Setze dies ueber alle Resources, die die Datenbank verwenden.
Schritt 3: Connection String einstellen
Fuege in server.cfg den Connection String hinzu:
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: Wenn es ein @ oder # enthaelt, URL-encode diese (zum Beispiel %40 fuer @).
Schritt 4: Framework-SQL importieren
Jedes Framework hat SQL-Dateien, die die Datenbanktabellen erstellen. Oeffne phpMyAdmin ueber 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 spaeter hinzufuegst, 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", pruefe den Connection String auf Tippfehler, ob die Datenbank erstellt wurde und ob das Passwort stimmt.
Haeufige 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_passwordeinstellen. - Tabellen existieren bereits: Du importierst die SQL doppelt. Kein Problem, der Import ueberschreibt nichts, wenn die Tabellen bereits existieren.
- Charset-Fehler: Vergiss
?charset=utf8mb4nicht im Connection String. Ohne diesen Parameter werden Emojis und Sonderzeichen nicht korrekt gespeichert.
Kann ich SQLite statt MySQL verwenden?
Technisch ja, aber kein RP-Framework unterstuetzt das standardmaessig. MySQL oder MariaDB ist die Erwartung. Bei HostValues ist eine Datenbank bei jedem FiveM-Paket inklusive, es gibt also keinen Grund fuer SQLite.
Wie erstelle ich ein Backup meiner Datenbank?
Ueber phpMyAdmin: Waehle die Datenbank aus, klicke auf "Exportieren", waehle "Schnell" und "SQL" und lade die Datei herunter. Speichere sie separat. Bei einer Neuinstallation importierst du diese Datei wieder.
Kann ich die Datenbank ansehen, waehrend der Server laeuft?
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 beschaedigen.
Eine Datenbank ist bei allen FiveM-Paketen inklusive. Bei Fragen zur Datenbankeinrichtung hilft unser Supportteam.
