Viele Serverprogramme brauchen einen ordentlichen Ort für ihre Daten. Rechte-Plugins, Economy-Plugins, Webkarten, Banlisten für mehrere Server und jedes ESX- oder QBCore-Setup auf FiveM erwarten eine MySQL-Datenbank. Du kannst sie in weniger als einer Minute selbst im Panel anlegen, und das Panel zeigt dir alle Werte, die du zum Verbinden brauchst.
Was du brauchst
- Deinen Server im Gamepanel
- Die Konfigurationsdatei des Plugins oder der Resource, die die Datenbank braucht, offen in einem zweiten Tab
Schritt 1: den Tab Datenbanken öffnen
Öffne das Gamepanel, wähle deinen Server und klicke im linken Menü auf Datenbanken. Der Eintrag steht in der Gruppe Erweitert, zusammen mit Netzwerk, Zeitpläne, Aktivität und Zugriff.
Oben auf der Karte siehst du, wie viele Plätze du hast, zum Beispiel 0 von 1 Datenbanken belegt. Neue Server haben einen Datenbankplatz, und der reicht für die meisten Setups: Eine Datenbank kann problemlos die Tabellen mehrerer Plugins aufnehmen, weil jedes Plugin seine eigenen Tabellen anlegt.
Steht dort Datenbanken nicht verfügbar, hat dieser Server keine Datenbankplätze. Öffne ein Ticket über die Support-Seite, dann sehen wir uns das gemeinsam an.
Schritt 2: die Datenbank anlegen
- Klicke auf Neue Datenbank
- Gib einen kurzen Namen ein, zum Beispiel
survivalodereconomy. Erlaubt sind nur Buchstaben, Zahlen und Unterstriche. - Bestätige im Dialog mit Neue Datenbank
Das Panel legt die Datenbank und einen passenden Benutzer mit generiertem Passwort an und zeigt die neue Datenbank in der Liste, das Passwort bereits sichtbar.
Achte auf den Namen, der dabei herauskommt. Es wird automatisch ein Präfix vorangestellt, aus survival wird also etwas wie s1234_survival. Genau diesen vollständigen Namen braucht dein Plugin.
Schritt 3: die Verbindungsdaten kopieren
Jede Datenbank in der Liste zeigt fünf Werte, jeder mit eigenem Kopier-Button:
| Feld | Was es ist |
|---|---|
| Datenbankname | Der vollständige Name inklusive Präfix |
| Host | Die Adresse unseres Datenbankservers, ohne Port |
| Port | Der MySQL-Port, normalerweise 3306 |
| Benutzername | Der für dich angelegte Datenbankbenutzer |
| Passwort | Verborgen, bis du auf das Augensymbol klickst (Passwort anzeigen) |
Kopiere die Werte mit den Buttons, statt sie abzutippen. Drei Fehler stecken hinter fast jeder gescheiterten Verbindung:
- localhost oder root verwenden. Die Datenbank läuft nicht in deinem Gameserver, sondern auf einem eigenen Datenbankhost.
localhost,127.0.0.1und der Benutzerrootfunktionieren nie. - Den Port ins Host-Feld einfügen. Die meisten Konfigurationen haben eine eigene Port-Einstellung. Der Host gehört in das eine Feld, der Port in das andere.
- Einen Datenbanknamen erfinden. Installationsassistenten schlagen oft einen eigenen Namen vor. Nimm stattdessen den Namen mit Präfix aus dem Panel.
Schritt 4: die Daten in die Plugin-Konfiguration eintragen
Jedes Plugin benennt diese Einstellungen etwas anders, aber sie entsprechen immer denselben fünf Werten. So sieht es in LuckPerms aus, einem verbreiteten Rechte-Plugin für Minecraft, in plugins/LuckPerms/config.yml:
storage-method: MySQL
data:
address: DEIN_HOST:3306
database: s1234_survival
username: DEIN_BENUTZERNAME
password: 'DEIN_PASSWORT'
LuckPerms hat keine eigene Port-Einstellung, deshalb ist das die eine Art von Konfiguration, in der Host und Port gemeinsam als host:port stehen. Gibt es ein Port-Feld, trennst du beides.
Speichere die Datei und starte den Server neu. Die meisten Plugins lesen ihre Datenbankeinstellungen nur beim Laden, eine Änderung bei laufendem Server wirkt also erst nach dem nächsten Neustart. Behalte beim Start den Tab Konsole im Blick: Ein Plugin, das keine Verbindung bekommt, meldet das meist dort, oft mit Access denied oder Communications link failure in der Meldung.
FiveM: der oxmysql-Verbindungsstring
Auf einem FiveM-Server kann der Tab Datenbanken noch etwas mehr. Unter der Liste findest du den oxmysql Verbindungsstring für deine erste Datenbank: eine fertige Zeile set mysql_connection_string "..." mit Host, Port, Name, Benutzername und Passwort. Kopiere sie mit dem Button und füge sie oben in server.cfg ein. Wenn txAdmin deinen Server verwaltet, trägst du sie stattdessen in den txAdmin-Einstellungen ein.
Enthält das Passwort in seltenen Fällen ein Zeichen, das oxmysql nicht lesen kann, zeigt das Panel statt einer kaputten Zeile eine Warnung, daneben den Button Neues Passwort erzeugen.
Vom eigenen Rechner verbinden
Dieselben fünf Werte funktionieren auch in einem MySQL-Client auf deinem Rechner, etwa HeidiSQL oder DBeaver. Das ist praktisch, um in die Tabellen zu schauen oder eine bestehende Datenbank zu importieren. Wähle MySQL (oder MariaDB) als Verbindungstyp und fülle die Felder einzeln aus.
Das Passwort ändern
Klicke in der Zeile der Datenbank auf Neues Passwort. Ein neues Passwort wird erzeugt und sofort angezeigt, das alte funktioniert ab sofort nicht mehr. Aktualisiere jede Konfiguration, die die Datenbank nutzt, und starte den Server neu, sonst versuchen es deine Plugins weiter mit dem alten Passwort.
Mach das immer, wenn das Passwort versehentlich geteilt worden sein könnte, zum Beispiel in einem Screenshot oder einer öffentlich geposteten Konfiguration.
Eine Datenbank löschen
Klicke auf das Papierkorb-Symbol in der Zeile und bestätige im Dialog Datenbank löschen. Die Datenbank wird mit allen Tabellen dauerhaft entfernt und lässt sich nicht wiederherstellen. Der Platz wird wieder frei, du kannst also direkt eine neue anlegen.
Die Backups im Tab Backups enthalten die Dateien deines Servers, nicht die Datenbank, denn die liegt auf dem Datenbankhost. Wenn dir die Daten wichtig sind, exportiere sie vor dem Löschen mit einem Client auf deinem Rechner.
Fehlerbehebung
Access denied for user. Benutzername oder Passwort stimmen nicht. Kopiere beides erneut aus dem Panel, prüfe auf ein Leerzeichen am Anfang oder Ende und stelle sicher, dass du nach dem Schreiben der Konfiguration nicht auf Neues Passwort geklickt hast.
Unknown database. Dem Namen fehlt das Präfix. Kopiere den Wert Datenbankname aus dem Panel.
Connection refused oder Timeout. Der Host ist falsch, meist localhost, oder der Port hängt am Host in einem Feld, das nur den Host erwartet.
Der Button Neue Datenbank ist ausgegraut. Alle Plätze sind belegt. Lösche eine Datenbank, die du nicht mehr brauchst, oder lass mehrere Plugins eine Datenbank teilen.
Der Name wird abgelehnt. Erlaubt sind nur Buchstaben, Zahlen und Unterstriche, und ein bereits verwendeter Name geht kein zweites Mal.
Kommst du nicht weiter? Öffne ein Ticket über die Support-Seite mit deinem Servernamen und der Fehlermeldung aus der Konsole, dann prüfen wir es gemeinsam.