Databáza MySQL pre pluginy: LuckPerms, CoreProtect a ďalšie

Väčšina pluginov ukladá dáta do súborov vo svojom priečinku. Pre veľké dáta (história blokov v CoreProtecte) alebo na zdieľanie medzi viacerými servermi (oprávnenia LuckPerms v sieti za proxy) je lepšia databáza MySQL. Ukážeme, ako ju u nás vytvoriť, ako do nej napojiť LuckPerms a CoreProtect a ako sa k nej dostať z počítača.

Kedy MySQL namiesto súborov#

Vytvorenie databázy#

1. V zákazníckej zóne otvorte Moje služby, kliknite na Minecraft server a prejdite na záložku Databázy.

2. Do poľa Názov databázy napíšte krátky názov, napríklad luckperms. Povolené sú písmená bez diakritiky, číslice a podčiarkovník, najviac 48 znakov.

3. Pole Povolený prístup z ponechajte % (pozrite nižšie).

4. Kliknite na Vytvoriť databázu.

   V zozname sa objaví nová databáza s údajmi Server, Používateľ, Povolený prístup z a Heslo.

Ďalšie tlačidlá:

• Nové heslo – vygeneruje nové heslo. Staré prestane fungovať, takže ho hneď zapíšte do konfigurácie všetkých pluginov, ktoré databázu používajú, a server reštartujte.
• Zmazať – zmaže databázu aj so všetkými dátami.

Počet databáz závisí od balíka. Nad zoznamom vidíte Využito 1 z 10. Keď je limit plný, uvidíte Limit je vyčerpaný. Viac pluginov môže zdieľať jednu databázu – každý používa vlastné tabuľky s vlastnou predponou (LuckPerms luckperms_, CoreProtect co_).

LuckPerms#

1. Vypnite server.

2. V záložke Súbory otvorte plugins/LuckPerms/config.yml.

3. Nájdite storage-method a sekciu data a upravte ich:

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

   Za <SERVER>, <NAZEV_DATABAZE>, <UZIVATEL> a <HESLO> dosaďte údaje zo záložky Databázy, vždy bez lomených zátvoriek. Pri hesle ponechajte jednoduché úvodzovky.

4. Uložte súbor (Ctrl+S) a server spustite.

Prenos existujúcich oprávnení do MySQL#

Ak už oprávnenia máte v pôvodnom úložisku, preneste ich:

1. Ešte pred zmenou storage-method zadajte v konzole:

   lp export zaloha-opravneni

   • lp export – uloží všetky dáta LuckPerms do súboru.
   • zaloha-opravneni – názov súboru. Vznikne plugins/LuckPerms/zaloha-opravneni.json.gz.

2. Vypnite server, zmeňte config.yml podľa postupu vyššie a server spustite.

3. V konzole zadajte:

   lp import zaloha-opravneni.json.gz

   Názov súboru píšte aj s príponou .json.gz. Dáta sa nahrajú do novej databázy.

CoreProtect#

1. Vypnite server.

2. V záložke Súbory otvorte 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 zo záložky Databázy rozdeľte: časť pred dvojbodkou patrí do <ADRESA>, číslo za dvojbodkou do <PORT>.

3. Uložte a server spustite.

Novšie verzie CoreProtectu (od verzie 25) majú namiesto use-mysql kľúč database-type. Ak ho v súbore vidíte, nastavte database-type: mysql – má prednosť pred use-mysql.

Ostatné pluginy#

Konfigurácia sa líši, ale polia sú takmer vždy rovnaké:

Po úprave vždy reštartujte server. Príkaz /reload pluginy s databázou často rozbije.

Prístup z počítača#

Databázu môžete prezerať a upravovať v počítači. Funguje to, ak má Povolený prístup z hodnotu %.

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

Zálohy databázy#

Zálohy v záložke Zálohy obsahujú iba súbory servera, databázy v nich nie sú. Exportujte ich zvlášť:

1. V HeidiSQL sa pripojte k databáze (pozrite vyššie).
2. Vľavo kliknite na databázu a zvoľte Tools › Export database as SQL.
3. Zaškrtnite vytvorenie tabuliek aj dáta, zvoľte výstup do súboru .sql a kliknite na Export.

Obnova: v HeidiSQL vyberte databázu a zvoľte File › Run SQL file. Pri LuckPerms máte navyše vlastnú zálohu príkazom lp export <NAZEV_SOUBORU>.

Overenie#

• LuckPerms: v konzole zadajte lp info. V časti Storage musí byť Type: MySQL (alebo MariaDB).
• CoreProtect: v konzole zadajte co status. Uvidíte riadok Database: Using MySQL.
• V HeidiSQL alebo DBeaveri uvidíte v databáze nové tabuľky (luckperms_…, co_…).

Keď niečo nefunguje#

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

Plugin sa k databáze vôbec nedostal (druhú hlášku vypisuje CoreProtect). Skontrolujte adresu a port (údaj Server, presne vrátane čísla za dvojbodkou). Pri CoreProtecte musia byť adresa a port v samostatných poliach. Ak všetko sedí, databázový server môže byť dočasne nedostupný – skúste to o chvíľu, prípadne napíšte podpore.

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

Databáza odmietla meno alebo heslo:

• Heslo ste medzitým zmenili tlačidlom Nové heslo a v plugine je staré.
• Heslo obsahuje špeciálne znaky a nie je v úvodzovkách.
• Povolený prístup z obsahuje konkrétnu IP adresu, z ktorej sa server nepripája. Vytvorte novú databázu s %.

Unknown database '…'#

Názov databázy nesedí. Skopírujte ho presne zo záložky Databázy vrátane prípadnej predpony.

Varovanie Establishing SSL connection without server's identity verification is not recommended#

Ide o varovanie ovládača MySQL. Pri LuckPerms do data.pool-settings.properties pridajte useSSL: false a verifyServerCertificate: false, pri iných pluginoch nájdite voľbu useSSL.

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

LuckPerms nedostal spojenie z poolu. Databáza je nedostupná, alebo je vyčerpaný počet spojení. Každý server s LuckPerms si v predvolenom stave drží 10 spojení – ak ich na databázu mieri viac (sieť serverov, ďalšie pluginy), znížte maximum-pool-size.

No operations allowed after connection closed#

Databáza uzavrela nečinné spojenie skôr, než ho plugin obnovil. Pri LuckPerms musí byť maximum-lifetime (v milisekundách) kratší než časový limit databázy. Predvolených 30 minút zvyčajne vyhovuje.

Ďalšie zdroje#

• LuckPerms: typy úložísk (otvorí sa v novom okne)
• LuckPerms: zmena úložiska (otvorí sa v novom okne)
• LuckPerms: chyby úložiska (otvorí sa v novom okne)
• CoreProtect: konfigurácia (otvorí sa v novom okne)
• HeidiSQL: nápoveda (otvorí sa v novom okne)