Datenbank mit FiveM verbinden

Datenbank mit FiveM verknüpfen

Jetzt, da du eine Datenbank erstellt und deinen Connection String bereit hast, ist es Zeit, deinen FiveM-Server tatsächlich mit der Datenbank zu verknüpfen. Dies tust du, indem du eine MySQL-Resource installierst und deinen Connection String in der Serverkonfiguration einstellst.

Welche MySQL-Resource benötigst du?

FiveM benötigt eine zusätzliche Resource, die als Vermittler zwischen deinem Server und der MySQL-Datenbank dient. Es gibt einige beliebte Optionen:

oxmysql – Die beliebteste und empfohlene Wahl. Wird aktiv gepflegt, ist schnell und wird von den meisten modernen Frameworks (QBCore, ESX Legacy) standardmäßig verwendet.
mysql-async – Der ältere Standard. Funktioniert noch gut, wird aber weniger aktiv gepflegt. Einige ältere Resources erfordern diese speziell.
ghmattimysql – Eine Alternative, die von einigen Frameworks verwendet wird. Weniger populär als oxmysql.

Unsere Empfehlung: Verwende oxmysql, es sei denn, dein Framework oder deine Resources erfordern ausdrücklich etwas anderes.

oxmysql installieren

Gehe zur oxmysql-Releases-Seite auf GitHub: github.com/overextended/oxmysql/releases
Lade die neueste oxmysql.zip herunter (nicht den Quellcode)
Gehe im HytaleNode-Panel zum File Manager deines FiveM-Servers
Navigiere zum Ordner resources (oder resources/[standalone], wenn du diese Ordnerstruktur verwendest)
Lade die ZIP-Datei hoch und entpacke sie über den File Manager
Stelle sicher, dass der Ordner oxmysql heißt (nicht oxmysql-2.x.x oder ähnlich)

mysql-async installieren (Alternative)

Wenn du lieber mysql-async verwendest oder dein Framework dies erfordert:

Gehe zu github.com/brouznouf/fivem-mysql-async/releases
Lade die neueste Release herunter
Lade hoch und entpacke in deinem Ordner resources
Benenne den Ordner in mysql-async um

Connection String in server.cfg einstellen

Jetzt musst du deinem FiveM-Server mitteilen, wie er eine Verbindung zur Datenbank herstellen soll. Dies tust du in der Datei server.cfg.

Öffne den File Manager im Panel
Öffne die Datei server.cfg
Füge folgende Zeilen oben in der Datei hinzu (vor allen anderen ensure-Zeilen):

Für oxmysql:

set mysql_connection_string "mysql://gebruikersnaam:wachtwoord@host:poort/database_naam"
ensure oxmysql

Für mysql-async:

set mysql_connection_string "mysql://gebruikersnaam:wachtwoord@host:poort/database_naam"
ensure mysql-async

Ersetze den Connection String durch den String, den du in der vorherigen Anleitung zusammengestellt hast. Ein vollständiges Beispiel:

set mysql_connection_string "mysql://u1_abc123xyz:[email protected]:3306/s1_fivem_server"
ensure oxmysql

Wichtig: Die Zeile ensure oxmysql (oder ensure mysql-async) muss vor allen anderen Resources stehen, die die Datenbank verwenden, wie dein Framework (ESX, QBCore usw.). Andernfalls versuchen diese Resources, die Datenbank zu nutzen, während die Verbindung noch nicht aktiv ist.

Testen, ob die Verbindung funktioniert

(Neu)starte deinen FiveM-Server über das Panel. Gehe zum Tab Konsole, um die Server-Ausgabe zu verfolgen. Wenn alles gut gelaufen ist, siehst du eine Meldung wie:

Bei oxmysql:

[oxmysql] Database server connection established!

Bei mysql-async:

[mysql-async] Database connected successfully.

Häufige Fehler beim Verbinden

Siehst du eine Fehlermeldung statt einer Erfolgsmeldung? Überprüfe Folgendes:

„Connection refused" – Überprüfe, ob Host und Port korrekt sind. Kopiere sie erneut aus dem Panel.
„Access denied" – Benutzername oder Passwort ist falsch. Achte auf Groß-/Kleinschreibung und Sonderzeichen.
„Unknown database" – Der Datenbankname ist falsch. Überprüfe den exakten Namen im Panel (einschließlich des Präfixes wie s1_).
Resource oxmysql not found – Der Ordner steht nicht am richtigen Ort oder hat einen falschen Namen. Überprüfe die Ordnerstruktur im File Manager.

Tipp: Kopiere die Daten direkt aus dem Panel, anstatt sie abzutippen. So vermeidest du Tippfehler.