So richtest Du eine Datenbank für Deinen FiveM Server ein

Viele FiveM Skripte und Frameworks speichern ihre Daten in einer MySQL-Datenbank. Damit Dein Server darauf zugreifen kann, brauchst Du zwei Dinge: eine Datenbank samt Zugangsdaten und eine Datenbank-Resource, die die Verbindung herstellt.

Wir empfehlen oxmysql. Die Resource wird aktiv gepflegt und ersetzt die veralteten Resources mysql-async und ghmattimysql, deren Funktionen sie mit abdeckt.

Datenbank anlegen

1. Datenbank erstellen
   Lege in der Verwaltung unter Datenbanken über das Plus-Symbol eine neue Datenbank an. Die ausführliche Anleitung dazu findest Du unter Datenbank erstellen.

2. Zugangsdaten ablesen
   Klicke neben Deiner Datenbank auf das Augen-Symbol. Du brauchst gleich diese Werte:

   • Datenbank Host (z.B. db1.cgn1.emeraldhost.de)
   • Datenbank Port (Standard: 3306)
   • Datenbank Benutzername
   • Datenbank Passwort
   • Datenbank Name

oxmysql hochladen

1. Resource herunterladen
   Lade Dir das aktuelle Release von oxmysql herunter. Verwende die Datei oxmysql.zip und nicht den Quellcode-Download.

2. Archiv entpacken
   Entpacke das Archiv. Du erhältst einen Ordner mit dem Namen oxmysql.

3. Server stoppen
   Stoppe Deinen Server über die Verwaltung.

4. Per SFTP verbinden
   Verbinde Dich per SFTP mit Deinem Server.

5. Ordner hochladen
   Lade den Ordner oxmysql in den resources-Ordner hoch, der neben der server.cfg Deines Servers liegt.

   Setup	Pfad
   Standard (empfohlen)	/home/container/resources
   txAdmin Recipe / Deployer	/home/container/txData/<Profilname>/resources

Connection String eintragen

Der Connection String bündelt alle Zugangsdaten in einer Zeile. oxmysql liest ihn aus der Convar mysql_connection_string.

1. server.cfg öffnen
   Öffne die server.cfg, die Dein Server verwendet. Welche das ist, hängt von Deinem txAdmin Setup ab – die Übersicht dazu findest Du unter Port einstellen.

2. Connection String setzen
   Trage folgende Zeile ein und ersetze die Platzhalter durch Deine Zugangsdaten aus dem Augen-Symbol:

   set mysql_connection_string "mysql://BENUTZERNAME:PASSWORT@HOST:PORT/DATENBANKNAME"
   

   Alternativ akzeptiert oxmysql auch das Format mit Semikolons:

   set mysql_connection_string "user=BENUTZERNAME;password=PASSWORT;host=HOST;port=PORT;database=DATENBANKNAME"
   

3. Nur set verwenden
   Setze die Convar ausschließlich mit set.

4. oxmysql starten
   Füge unterhalb des Connection Strings die Startzeile für die Resource ein:

   ensure oxmysql
   

5. Server starten
   Speichere die server.cfg und starte Deinen Server über die Verwaltung.

Verbindung prüfen

Öffne nach dem Start die Konsole Deines Servers in der Verwaltung. Hat die Verbindung geklappt, findest Du dort diese Meldung:

Database server connection established!

Davor steht in eckigen Klammern die Version Deines Datenbankservers.

Schlägt die Verbindung fehl, gibt oxmysql stattdessen eine Meldung in dieser Form aus:

Unable to establish a connection to the database (FEHLERCODE)!

Prüfe in diesem Fall Benutzername, Passwort, Host, Port und Datenbankname noch einmal über das Augen-Symbol in der Verwaltung.

Sonderzeichen im Passwort

Je nach verwendetem Format sind bestimmte Sonderzeichen reserviert oder werden nicht unterstützt. Enthält Dein Datenbank-Passwort eines dieser Zeichen, kann die Verbindung fehlschlagen:

; , / ? : @ & = + $ #

Weitere Convars

Für die Fehlersuche stellt oxmysql zusätzliche Convars bereit, die Du ebenfalls mit set in die server.cfg einträgst:

Wie geht es weiter?

Deine Datenbank ist jetzt verbunden, aber noch leer. Die meisten Frameworks und Skripte bringen eine .sql-Datei mit, die die benötigten Tabellen anlegt. Wie Du sie einspielst, steht unter Datenbank importieren.