Die meisten Plugins speichern ihre Daten in Dateien in ihrem eigenen Ordner. Für große Datenmengen (Blockverlauf in CoreProtect) oder für das Teilen von Daten zwischen mehreren Servern (Berechtigungen von LuckPerms in einem Netzwerk hinter einem Proxy) eignet sich eine MySQL-Datenbank besser. Diese Anleitung zeigt, wie Sie bei StormHost eine anlegen, LuckPerms und CoreProtect damit verbinden und vom Computer aus darauf zugreifen.
Was Sie brauchen
- Ein Minecraft-Server bei StormHost mit einem Plugin, das MySQL unterstützt
- Die Berechtigungen Datenbanken und Dateien, wenn Ihnen der Server nicht gehört
- Etwa 15 Minuten
Wann MySQL statt Dateien#
| Situation | Dateien (Standard) | MySQL |
|---|---|---|
| Ein Server, eine normale Spielerzahl | Genügt | Nicht nötig |
| Ein Netzwerk von Servern hinter einem Velocity-Proxy mit gemeinsamen Berechtigungen | Nicht möglich | Erforderlich – alle Server müssen dieselben Daten lesen |
| CoreProtect auf einem großen, lange laufenden Server | Funktioniert, aber die Datei wächst ständig | Besserer Umgang mit großen Datenmengen |
| Sie möchten die Daten vom Computer aus durchsehen oder bearbeiten | Kompliziert | Einfach (HeidiSQL, DBeaver) |
| Eine Website, die Statistiken vom Server liest | Nicht möglich | Ja |
Eine Datenbank anlegen#
Öffnen Sie im Kundenbereich Meine Dienste, klicken Sie auf Ihren Minecraft-Server und wechseln Sie in die Registerkarte Datenbank.
Geben Sie im Feld Datenbankname einen kurzen Namen ein, zum Beispiel
luckperms. Erlaubt sind Buchstaben ohne Sonderzeichen, Ziffern und Unterstriche, bis zu 48 Zeichen.Lassen Sie im Feld Erlaubte Verbindungen von den Wert
%(siehe unten).Klicken Sie auf Datenbank erstellen.
Die neue Datenbank erscheint in der Liste mit den Angaben Host, Benutzer, Erlaubte Verbindungen von und Passwort.
| Angabe | Was es ist | Wo Sie es eintragen |
|---|---|---|
| Datenbankname (oben bei der Datenbank) | Der tatsächliche Name der Datenbank. Das System kann dem gewählten Namen ein Präfix voranstellen. | Im Feld „database“ des Plugins. Kopieren Sie immer genau, was Sie sehen. |
| Host | Die Adresse des Datenbankservers in der Form adresse:port. | Im Feld „host“/„address“, den Port im Feld „port“. |
| Benutzer | Der Anmeldename für die Datenbank (generiert). | Im Feld „username“/„user“. |
| Passwort | Das Passwort (erscheint nach einem Klick darauf). | Im Feld „password“. |
| Erlaubte Verbindungen von | Von wo aus man sich mit der Datenbank verbinden kann: % = von überall, sonst eine einzelne IP-Adresse. | Nirgends, nur zur Information. |
Erlaubte Verbindungen von
Tragen Sie eine bestimmte IP-Adresse ein (zum Beispiel Ihre private), nimmt die Datenbank Verbindungen nur von dieser Adresse an. Nicht einmal Ihr Minecraft-Server kann sich dann verbinden, weil er sich von einer anderen Adresse aus verbindet. Lassen Sie also % und verlassen Sie sich auf das starke generierte Passwort. Nach dem Anlegen der Datenbank lässt sich der Wert nicht mehr ändern – Sie müssten eine neue Datenbank anlegen.
Weitere Schaltflächen:
- Neues Passwort – erzeugt ein neues Passwort. Das alte funktioniert dann nicht mehr; tragen Sie das neue also sofort in die Konfiguration aller Plugins ein, die die Datenbank verwenden, und starten Sie den Server neu.
- Löschen – löscht die Datenbank samt allen Daten.
Eine Datenbank löschen
Das Löschen lässt sich nicht rückgängig machen, und die Daten sind nicht in den Backups des Servers. Exportieren Sie die Datenbank vor dem Löschen (siehe Backups der Datenbank).
Die Anzahl der Datenbanken hängt von Ihrem Tarif ab. Über der Liste sehen Sie 1 von 10 verwendet. Ist das Limit ausgeschöpft, erscheint Das Limit ist erreicht. Mehrere Plugins können sich eine Datenbank teilen – jedes verwendet eigene Tabellen mit eigenem Präfix (LuckPerms luckperms_, CoreProtect co_).
LuckPerms#
Haben Sie bereits Berechtigungen eingerichtet?
Nach dem Wechsel zu MySQL beginnt LuckPerms mit einer leeren Datenbank. Haben Sie auf dem Server schon Gruppen und Berechtigungen, exportieren Sie sie zuerst wie unter Bestehende Berechtigungen nach MySQL übertragen beschrieben und machen Sie erst dann weiter.
Stoppen Sie den Server.
Öffnen Sie in der Registerkarte Dateien die Datei
plugins/.LuckPerms/ config. yml Suchen Sie
storage-methodund den Abschnittdataund ändern Sie sie:plugins/ LuckPerms/ YAMLconfig.yml storage-method: mysql data: address: <HOST> database: <DATABASE_NAME> username: <USER> password: '<PASSWORD>'Ersetzen Sie
<HOST>,<DATABASE_NAME>,<USER>und<PASSWORD>durch die Angaben aus der Registerkarte Datenbank, jeweils ohne spitze Klammern. Behalten Sie die einfachen Anführungszeichen um das Passwort.Speichern Sie die Datei (Strg+S) und starten Sie den Server.
| Einstellung | Was sie tut | Empfohlener Wert | Wann ändern |
|---|---|---|---|
storage-method | Wo LuckPerms Daten speichert: h2 (eine Datei, Standard), mysql, mariadb, yaml und weitere. | mysql | mariadb, wenn Sie wissen, dass der Datenbankserver MariaDB ist (LuckPerms empfiehlt es). |
data.address | Die Adresse der Datenbank. Der Port folgt nach einem Doppelpunkt (adresse:port). | Der Wert Host | Wenn Sie die Datenbank wechseln. |
data.database | Der Name der Datenbank. Sie muss bereits existieren. | Der Name aus der Registerkarte Datenbank | – |
data.username, data.password | Zugangsdaten. | Aus der Registerkarte Datenbank | Nach einem Klick auf Neues Passwort. |
data. | Wie viele Verbindungen zur Datenbank LuckPerms offen hält. | 10 | Senken (zum Beispiel auf 5), wenn die Datenbank zu viele Verbindungen meldet. |
data. | Zusätzliche Verbindungsparameter. | useUnicode: true, characterEncoding: utf8 | Ergänzen Sie useSSL: false, wenn eine SSL-Warnung erscheint. |
data.table-prefix | Das Präfix der Tabellen. | 'luckperms_' | Ein anderes Präfix, wenn zwei Server in einer Datenbank getrennte Daten haben sollen. |
server (oben in der Datei) | Der Name des Servers für Berechtigungen, die nur auf einem Server im Netzwerk gelten. | global | In einem Netzwerk hinter einem Proxy für jeden Server ein anderer (lobby, survival). |
Sonderzeichen im Passwort
Setzen Sie das Passwort immer in einfache Anführungszeichen '…'. Sonst würde YAML Zeichen wie #, : oder % als Syntax lesen. Enthält das Passwort einen Apostroph ', schreiben Sie ihn doppelt ('').
Bestehende Berechtigungen nach MySQL übertragen#
Haben Sie bereits Berechtigungen im ursprünglichen Speicher, übertragen Sie sie:
Geben Sie vor der Änderung von
storage-methodin der Konsole ein:text lp export zaloha-opravnenilp export– speichert alle Daten von LuckPerms in eine Datei.zaloha-opravneni– der Dateiname. Es entstehtplugins/.LuckPerms/ zaloha-opravneni. json. gz
Stoppen Sie den Server, ändern Sie
config.ymlwie oben beschrieben und starten Sie den Server.Geben Sie in der Konsole ein:
text lp import zaloha-opravneni.json.gzGeben Sie den Dateinamen einschließlich der Endung
.json.gzein. Die Daten werden in die neue Datenbank geladen.
CoreProtect#
Stoppen Sie den Server.
Öffnen Sie in der Registerkarte Dateien die Datei
plugins/und ändern Sie:CoreProtect/ config. yml plugins/ CoreProtect/ YAMLconfig.yml use-mysql: true table-prefix: co_ mysql-host: <ADDRESS> mysql-port: <PORT> mysql-database: <DATABASE_NAME> mysql-username: <USER> mysql-password: '<PASSWORD>'Teilen Sie den Wert Host aus der Registerkarte Datenbank auf: Der Teil vor dem Doppelpunkt gehört in
<ADDRESS>, die Zahl nach dem Doppelpunkt in<PORT>.Speichern Sie und starten Sie den Server.
| Einstellung | Was sie tut | Empfohlener Wert | Wann ändern |
|---|---|---|---|
use-mysql | Speichert den Verlauf in MySQL statt in einer Datei. | true | false für die Rückkehr zur Datei. |
table-prefix | Das Präfix der Tabellen von CoreProtect. | co_ | Wenn CoreProtect von mehreren Servern eine Datenbank verwendet. |
mysql-host | Die Adresse der Datenbank ohne Port. | Der Teil von Host vor dem Doppelpunkt | – |
mysql-port | Der Port der Datenbank. | Der Teil von Host nach dem Doppelpunkt | – |
mysql-database, mysql-username, mysql-password | Name der Datenbank und Zugangsdaten. | Aus der Registerkarte Datenbank | Nach einem Klick auf Neues Passwort. |
Der alte Verlauf wird nicht übernommen
Beim Wechsel zu MySQL beginnt CoreProtect einen neuen Verlauf. Die bestehenden Einträge bleiben in der Datei im Ordner plugins/CoreProtect, in MySQL sind sie aber nicht. Wechseln Sie also gleich am Anfang, nicht nach einem Jahr Betrieb.
Neuere Versionen von CoreProtect (ab Version 25) haben statt use-mysql den Schlüssel database-type. Sehen Sie ihn in der Datei, setzen Sie database-type: mysql – er hat Vorrang vor use-mysql.
Andere Plugins#
Die Konfigurationen unterscheiden sich, die Felder sind aber fast immer dieselben:
| Feld in der Konfiguration des Plugins | Was eintragen |
|---|---|
host, hostname, address | Die Adresse aus dem Wert Host (ohne Port, wenn es ein eigenes Feld für den Port gibt). |
port | Der Port aus dem Wert Host. |
database, db-name | Der Name der Datenbank. |
username, user | Der Benutzer. |
password | Das Passwort (in Anführungszeichen). |
useSSL, ssl | false, wenn das Plugin SSL-Probleme meldet. |
jdbc-url, url | Die vollständige Adresse in der Form jdbc: (für den MariaDB-Treiber jdbc:mariadb://…). |
Starten Sie den Server nach Änderungen immer neu. Der Befehl /reload bringt Plugins mit Datenbank oft durcheinander.
Zugriff vom Computer#
Sie können die Datenbank auf Ihrem Computer durchsehen und bearbeiten. Das funktioniert, wenn Erlaubte Verbindungen von auf % steht.
Windows
- Installieren Sie HeidiSQL von heidisql.com (öffnet sich in einem neuen Fenster).
- Klicken Sie im Fenster des Sitzungsmanagers auf New.
- Wählen Sie als Network type MariaDB/MySQL (TCP/IP).
- Tragen Sie in Hostname / IP die Adresse ein, in Port den Port (beides aus dem Wert Host) und in User und Password die Zugangsdaten.
- Klicken Sie auf Open.
macOS
- Installieren Sie DBeaver Community von dbeaver.io (öffnet sich in einem neuen Fenster).
- Wählen Sie Database › New Database Connection und den Typ MySQL (oder MariaDB).
- Füllen Sie Server Host, Port, Database, Username und Password aus.
- Klicken Sie auf Test Connection und dann auf Finish.
Linux
Verwenden Sie DBeaver Community von dbeaver.io (öffnet sich in einem neuen Fenster) (dasselbe Vorgehen wie unter macOS) oder einen Client im Terminal. Unter Ubuntu und Debian installieren Sie ihn mit apt install mariadb-client und verbinden sich so:
mariadb -h <ADDRESS> -P <PORT> -u <USER> -p <DATABASE_NAME>mariadb– der Client für MariaDB und MySQL.-h <ADDRESS>– die Adresse des Datenbankservers.-P <PORT>– der Port (großes P).-u <USER>– der Benutzer.-p– das Programm fragt nach dem Passwort (es steht nicht im Befehl und landet daher nicht im Verlauf).<DATABASE_NAME>– die Datenbank, mit der Sie arbeiten möchten.
Neuere MariaDB-Clients (ab Version 11.4, zum Beispiel unter Debian 13) prüfen standardmäßig das Zertifikat des Datenbankservers. Scheitert die Verbindung mit einem TLS/SSL error, der ein Zertifikat erwähnt, ergänzen Sie hinter mariadb den Schalter --disable-ssl-verify-server-cert (der Client prüft dann das Zertifikat des Servers nicht). Besagt der Fehler, dass der Server kein SSL unterstützt, verwenden Sie stattdessen den Schalter --disable-ssl.
Vorsicht beim Bearbeiten
Ändern Sie keine Daten, während der Server läuft – Plugins halten einen Teil ihrer Daten im Speicher und überschreiben Ihre Änderung. Erstellen Sie vor jeder manuellen Bearbeitung einen Export.
Backups der Datenbank#
Backups in der Registerkarte Backups enthalten nur die Dateien des Servers, keine Datenbanken. Exportieren Sie diese separat:
- Verbinden Sie sich in HeidiSQL mit der Datenbank (siehe oben).
- Klicken Sie links auf die Datenbank und wählen Sie Tools › Export database as SQL.
- Kreuzen Sie das Anlegen der Tabellen und die Daten an, wählen Sie die Ausgabe in eine
.sql-Datei und klicken Sie auf Export.
Wiederherstellen: Markieren Sie in HeidiSQL die Datenbank und wählen Sie File › Run SQL file. LuckPerms hat außerdem ein eigenes Backup mit dem Befehl lp export <FILE_NAME>.
Überprüfung#
- LuckPerms: Geben Sie in der Konsole
lp infoein. Im AbschnittStoragemussType: MySQL(oderMariaDB) stehen. - CoreProtect: Geben Sie in der Konsole
co statusein. Sie sehen die ZeileDatabase: Using MySQL. - In HeidiSQL oder DBeaver sehen Sie in der Datenbank neue Tabellen (
luckperms_…,co_…).
Fehlerbehebung#
Communications link failure oder Unable to connect to MySQL server.#
Das Plugin hat die Datenbank überhaupt nicht erreicht (die zweite Meldung stammt von CoreProtect). Prüfen Sie Adresse und Port (den Wert Host, genau, einschließlich der Zahl nach dem Doppelpunkt). In CoreProtect müssen Adresse und Port in getrennten Feldern stehen. Stimmt alles, ist der Datenbankserver vielleicht vorübergehend nicht erreichbar – versuchen Sie es gleich noch einmal oder wenden Sie sich an den Support.
Access denied for user '…'@'…' (using password: YES)#
Die Datenbank hat Benutzernamen oder Passwort abgelehnt:
- Sie haben das Passwort inzwischen mit der Schaltfläche Neues Passwort geändert, und das Plugin hat noch das alte.
- Das Passwort enthält Sonderzeichen und steht nicht in Anführungszeichen.
- Erlaubte Verbindungen von enthält eine bestimmte IP-Adresse, von der aus sich der Server nicht verbindet. Legen Sie eine neue Datenbank mit
%an.
Unknown database '…'#
Der Name der Datenbank stimmt nicht. Kopieren Sie ihn genau aus der Registerkarte Datenbank, einschließlich eines eventuellen Präfixes.
Warnung Establishing SSL connection without server's identity verification is not recommended#
Das ist eine Warnung des MySQL-Treibers. Bei LuckPerms ergänzen Sie in data. die Werte useSSL: false und verifyServerCertificate: false, bei anderen Plugins suchen Sie die Option useSSL.
Connection is not available, request timed out after 5000ms#
LuckPerms hat aus seinem Pool keine Verbindung bekommen. Die Datenbank ist nicht erreichbar, oder das Verbindungslimit ist erreicht. Jeder Server mit LuckPerms hält standardmäßig 10 Verbindungen – greifen mehr auf die Datenbank zu (ein Servernetzwerk, andere Plugins), senken Sie maximum-pool-size.
No operations allowed after connection closed#
Die Datenbank hat eine untätige Verbindung geschlossen, bevor das Plugin sie erneuert hat. Bei LuckPerms muss maximum-lifetime (in Millisekunden) kürzer sein als das Timeout der Datenbank. Der Standard von 30 Minuten funktioniert meist.
Zusammenfassung
- Legen Sie die Datenbank in der Registerkarte Datenbank an und lassen Sie Erlaubte Verbindungen von auf
%. - Kopieren Sie die Angaben genau und setzen Sie das Passwort in YAML in einfache Anführungszeichen.
- LuckPerms:
storage-method: mysqlund der Abschnittdata; bestehende Daten übertragen Sie mitlp exportundlp import. - CoreProtect:
use-mysql: true, Adresse und Port getrennt eintragen; der alte Verlauf wird nicht übernommen. - Datenbanken sind nicht in den Backups des Servers enthalten – exportieren Sie sie separat (HeidiSQL).
Weiterführende Links#
- LuckPerms: Speichertypen (öffnet sich in einem neuen Fenster)
- LuckPerms: Speichertyp wechseln (öffnet sich in einem neuen Fenster)
- LuckPerms: Fehler des Speichersystems (öffnet sich in einem neuen Fenster)
- CoreProtect: Konfiguration (öffnet sich in einem neuen Fenster)
- HeidiSQL: Hilfe (öffnet sich in einem neuen Fenster)