FiveM Datenbank einrichten
So bindest du eine Datenbank richtig über txAdmin an deinen FiveM-Server an, inklusive Frameworks, SQL-Import und typischer Fehler.
Fast jedes größere FiveM-Framework wie ESX oder QBCore speichert Spielerdaten, Fahrzeuge, Inventare, Jobs und Bankkonten dauerhaft in einer MySQL-Datenbank. Ohne eine korrekt angebundene Datenbank startet dein Server entweder gar nicht erst oder die Spieler verlieren ihren Fortschritt bei jedem Neustart. Die Datenbankverbindung trägst du bei FiveM direkt in txAdmin ein, nicht manuell in der server.cfg.
Datenbank anbinden
Lege im Bereich Databases eine neue Datenbank an, zum Beispiel fivem. Du erhältst automatisch Host, Port, Datenbankname, Benutzer und Passwort.
Öffne txAdmin, siehe FiveM Server einrichten, falls du den Zugriff noch nicht eingerichtet hast.
Trage Host, Port, Datenbankname, Benutzer und Passwort im Datenbank-Schritt des txAdmin Setup-Assistenten ein (bei einem bereits eingerichteten Server findest du dieselben Felder unter Settings). txAdmin baut daraus automatisch den Connection String und schreibt ihn selbst in die server.cfg.
txAdmin testet die Verbindung direkt beim Speichern und zeigt eine Fehlermeldung, falls Host, Benutzer oder Passwort nicht stimmen. Starte den Server erst, wenn der Test erfolgreich war.
Gib deine Datenbank-Zugangsdaten und deinen txAdmin-Zugang niemals weiter, weder öffentlich noch in geteilten server.cfg-Dateien. Wer Zugriff auf txAdmin hat, hat damit auch Zugriff auf die komplette Datenbank. Ergänzend dazu lohnt sich ein Blick in Sicherheit.
Editiere den mysql_connection_string in der server.cfg nach Möglichkeit nicht von Hand. txAdmin verwaltet diese Zeile selbst und überschreibt manuelle Änderungen beim nächsten Speichern in den Settings wieder.
Welche Datenbank-Ressource nutzt txAdmin?
- oxmysql: Aktiver Standard fast aller modernen ESX- und QBCore-Versionen. txAdmin installiert und aktiviert oxmysql beim Recipe-Deployment automatisch, sobald du eine Datenbankverbindung eingetragen hast.
- mysql-async (Legacy): Ältere Ressource, die in vielen alten Tutorials noch auftaucht. Nur relevant, wenn ein bestimmtes altes Script explizit
mysql-asyncvoraussetzt, ansonsten übernimmt txAdmin oxmysql für dich, ohne dass du selbst etwas installieren musst.
Framework mit der Datenbank verbinden
- ESX Legacy liest die Verbindung ausschließlich über den von txAdmin gesetzten
mysql_connection_stringConvar, eine zusätzliche Konfiguration inconfig.luaist meist nicht mehr nötig. - QBCore nutzt ebenfalls oxmysql und den von txAdmin verwalteten
mysql_connection_string. Prüfe zusätzlichshared/config.lua, falls dein Framework-Fork eigene Datenbank-Einstellungen mitbringt.
Weitere Ressourcen und Scripts, die du zusätzlich zum Framework installierst, siehe FiveM Ressourcen installieren, greifen in aller Regel ebenfalls automatisch auf denselben mysql_connection_string zurück, solange sie oxmysql als Abhängigkeit nutzen.
SQL-Schema importieren
Frameworks wie ESX oder QBCore benötigen bestimmte Tabellen (Accounts, Fahrzeuge, Inventare, Jobs), bevor der Server fehlerfrei startet.
Jedes Framework liefert eine .sql-Datei mit dem Grundschema, meist es_extended.sql bzw. qb-core.sql, direkt im jeweiligen GitHub-Repository.
Öffne die Datenbankverwaltung über den Bereich Databases im Panel und importiere die .sql-Datei in die zuvor angelegte Datenbank.
Viele Zusatz-Scripts (Tankstellen, Jobs, Housing-Systeme) bringen eigene .sql-Dateien mit. Importiere diese in derselben Datenbank, nachdem das Grundschema des Frameworks steht.
Erstelle ein Backup deiner Datenbank, bevor du größere Scripts oder Updates einspielst, damit du bei Fehlern in der SQL-Datei einfach zum vorherigen Stand zurückkehren kannst. Achte beim Import außerdem auf den Zeichensatz utf8mb4: Ältere .sql-Dateien nutzen teilweise noch utf8, was bei Emojis oder Sonderzeichen in Spielernamen zu Fehlern oder verstümmelten Daten führen kann.
Häufige Fragen
Frameworks wie ESX oder QBCore benötigen zwingend eine MySQL-Datenbank. txAdmin fragt die Verbindungsdaten deshalb bereits im Setup-Assistenten ab und richtet oxmysql automatisch dafür ein.
Prüfe in txAdmin unter Settings, ob Benutzer, Passwort, Host und Datenbankname exakt mit den Zugangsdaten aus dem Bereich Databases übereinstimmen, und speichere die Einstellungen erneut, um die Verbindung neu zu testen.
Das Grundschema deines Frameworks wurde noch nicht importiert. Importiere die passende .sql-Datei (z. B. es_extended.sql oder qb-core.sql) über die Datenbankverwaltung im Bereich Databases, bevor du den Server erneut startest.
Öffne txAdmin, gehe zu Settings und passe dort Host, Datenbankname, Benutzer und Passwort an. txAdmin schreibt den aktualisierten Connection String automatisch in die server.cfg.
Ja, das ist sogar der Normalfall. Framework, Jobs, Housing- und Wirtschaftssysteme greifen in der Regel gemeinsam auf eine einzige Datenbank zu, solange keine Tabellennamen kollidieren.
Datenbanken werden bei einem vollständigen Server-Backup automatisch mitgesichert, siehe Datenbanken sowie Backups & Snapshots für die zeitliche Steuerung. Vor riskanten SQL-Imports lohnt sich zusätzlich ein manuelles Backup.
In der Regel ja. Die Zugangsdaten im Bereich Databases enthalten alle nötigen Verbindungsinformationen für externe Tools. Wende dich an unseren Support, falls der externe Zugriff nicht funktioniert.
Siehe auch
- FiveM Server einrichten - Server starten und txAdmin zum ersten Mal öffnen.
- FiveM Ressourcen installieren - zusätzliche Scripts installieren, die dieselbe Datenbank nutzen.
- Datenbanken - Datenbanken im Panel allgemein anlegen und verwalten.
- Backups & Snapshots - Datenbank und Serverstand regelmäßig sichern.
- Sicherheit - Zugangsdaten und txAdmin-Zugriff zusätzlich absichern.