MySQL databáze pro pluginy: LuckPerms, CoreProtect a další

Většina pluginů ukládá data do souborů ve své složce. Pro velká data (historie bloků v CoreProtectu) nebo pro sdílení mezi více servery (oprávnění LuckPerms na síti za proxy) je lepší databáze MySQL. Ukážeme, jak ji u nás vytvořit, jak do ní napojit LuckPerms a CoreProtect a jak se k ní dostat z počítače.

Kdy MySQL místo souborů#

Vytvoření databáze#

1. V zákaznické zóně otevřete Moje služby, klikněte na Minecraft server a přejděte na záložku Databáze.

2. Do pole Název databáze napište krátký název, například luckperms. Povolená jsou písmena bez diakritiky, číslice a podtržítko, nejvýš 48 znaků.

3. Pole Povolený přístup z ponechte % (viz níže).

4. Klikněte na Vytvořit databázi.

   V seznamu se objeví nová databáze s údaji Server, Uživatel, Povolený přístup z a Heslo.

Další tlačítka:

• Nové heslo – vygeneruje nové heslo. Staré přestane fungovat, takže ho hned zapište do konfigurace všech pluginů, které databázi používají, a server restartujte.
• Smazat – smaže databázi i se všemi daty.

Počet databází závisí na balíčku. Nad seznamem vidíte Využito 1 z 10. Když je limit plný, uvidíte Limit je vyčerpaný. Více pluginů může sdílet jednu databázi – každý používá vlastní tabulky s vlastní předponou (LuckPerms luckperms_, CoreProtect co_).

LuckPerms#

1. Vypněte server.

2. V záložce Soubory otevřete plugins/LuckPerms/config.yml.

3. Najděte storage-method a sekci data a upravte je:

   storage-method: mysql
   
   data:
     address: <SERVER>
     database: <NAZEV_DATABAZE>
     username: <UZIVATEL>
     password: '<HESLO>'

   Za <SERVER>, <NAZEV_DATABAZE>, <UZIVATEL> a <HESLO> dosaďte údaje ze záložky Databáze, vždy bez špičatých závorek. U hesla ponechte jednoduché uvozovky.

4. Uložte soubor (Ctrl+S) a server spusťte.

Přenos existujících oprávnění do MySQL#

Pokud už oprávnění máte v původním úložišti, přeneste je:

1. Ještě před změnou storage-method zadejte v konzoli:

   lp export zaloha-opravneni

   • lp export – uloží všechna data LuckPerms do souboru.
   • zaloha-opravneni – název souboru. Vznikne plugins/LuckPerms/zaloha-opravneni.json.gz.

2. Vypněte server, změňte config.yml podle postupu výše a server spusťte.

3. V konzoli zadejte:

   lp import zaloha-opravneni.json.gz

   Název souboru pište i s příponou .json.gz. Data se nahrají do nové databáze.

CoreProtect#

1. Vypněte server.

2. V záložce Soubory otevřete plugins/CoreProtect/config.yml a upravte:

   use-mysql: true
   table-prefix: co_
   mysql-host: <ADRESA>
   mysql-port: <PORT>
   mysql-database: <NAZEV_DATABAZE>
   mysql-username: <UZIVATEL>
   mysql-password: '<HESLO>'

   Údaj Server ze záložky Databáze rozdělte: část před dvojtečkou patří do <ADRESA>, číslo za dvojtečkou do <PORT>.

3. Uložte a server spusťte.

Novější verze CoreProtectu (od verze 25) mají místo use-mysql klíč database-type. Pokud ho v souboru vidíte, nastavte database-type: mysql – má přednost před use-mysql.

Ostatní pluginy#

Konfigurace se liší, ale pole jsou téměř vždy stejná:

Po úpravě vždy restartujte server. Příkaz /reload pluginy s databází často rozbije.

Přístup z počítače#

Databázi můžete prohlížet a upravovat v počítači. Funguje to, pokud má Povolený přístup z hodnotu %.

mariadb -h <ADRESA> -P <PORT> -u <UZIVATEL> -p <NAZEV_DATABAZE>

Zálohy databáze#

Zálohy v záložce Zálohy obsahují jen soubory serveru, databáze v nich nejsou. Exportujte je zvlášť:

1. V HeidiSQL se připojte k databázi (viz výše).
2. Vlevo klikněte na databázi a zvolte Tools › Export database as SQL.
3. Zaškrtněte vytvoření tabulek i data, zvolte výstup do souboru .sql a klikněte na Export.

Obnova: v HeidiSQL vyberte databázi a zvolte File › Run SQL file. U LuckPerms máte navíc vlastní zálohu příkazem lp export <NAZEV_SOUBORU>.

Ověření#

• LuckPerms: v konzoli zadejte lp info. V části Storage musí být Type: MySQL (nebo MariaDB).
• CoreProtect: v konzoli zadejte co status. Uvidíte řádek Database: Using MySQL.
• V HeidiSQL nebo DBeaveru uvidíte v databázi nové tabulky (luckperms_…, co_…).

Když něco nefunguje#

Communications link failure nebo Unable to connect to MySQL server.#

Plugin se k databázi vůbec nedostal (druhou hlášku vypisuje CoreProtect). Zkontrolujte adresu a port (údaj Server, přesně včetně čísla za dvojtečkou). U CoreProtectu musí být adresa a port v samostatných polích. Pokud vše sedí, databázový server může být dočasně nedostupný – zkuste to za chvíli, případně napište podpoře.

Access denied for user '…'@'…' (using password: YES)#

Databáze odmítla jméno nebo heslo:

• Heslo jste mezitím změnili tlačítkem Nové heslo a v pluginu je staré.
• Heslo obsahuje speciální znaky a není v uvozovkách.
• Povolený přístup z obsahuje konkrétní IP adresu, ze které se server nepřipojuje. Vytvořte novou databázi s %.

Unknown database '…'#

Název databáze nesouhlasí. Zkopírujte ho přesně ze záložky Databáze včetně případné předpony.

Varování Establishing SSL connection without server's identity verification is not recommended#

Jde o varování ovladače MySQL. U LuckPerms do data.pool-settings.properties přidejte useSSL: false a verifyServerCertificate: false, u jiných pluginů najděte volbu useSSL.

Connection is not available, request timed out after 5000ms#

LuckPerms nedostal spojení z poolu. Databáze je nedostupná, nebo je vyčerpaný počet spojení. Každý server s LuckPerms si ve výchozím stavu drží 10 spojení – pokud jich na databázi míří víc (síť serverů, další pluginy), snižte maximum-pool-size.

No operations allowed after connection closed#

Databáze uzavřela nečinné spojení dřív, než ho plugin obnovil. U LuckPerms musí být maximum-lifetime (v milisekundách) kratší než časový limit databáze. Výchozích 30 minut obvykle vyhovuje.

Další zdroje#

• LuckPerms: typy úložišť (otevře se v novém okně)
• LuckPerms: změna úložiště (otevře se v novém okně)
• LuckPerms: chyby úložiště (otevře se v novém okně)
• CoreProtect: konfigurace (otevře se v novém okně)
• HeidiSQL: nápověda (otevře se v novém okně)