Bază de date MySQL pentru plugin-uri (exemplu LuckPerms)

Unele plugin-uri și moduri își pot ține datele într-o bază de date MySQL, în loc de fișiere în propriul folder. Fiecare server Torchlite poate avea o bază de date (două pe planul Max), creată din pagina Databases a panelului.

Ghidul ăsta explică când merită s-o folosești, cum o creezi, unde găsești datele de conectare și cum legi un plugin de ea, cu LuckPerms pe un server Paper ca exemplu.

Ai nevoie de o bază de date?

De multe ori, nu. Majoritatea plugin-urilor care știu MySQL merg din prima și cu un fișier local. LuckPerms, de exemplu, folosește implicit o bază de date H2 într-un fișier, iar pentru un singur server e perfect în regulă.

O bază de date MySQL merită când:

• un plugin îți spune s-o folosești pentru volume mari de date. Plugin-urile de logare, cum e CoreProtect, recomandă MySQL când lumea devine aglomerată;
• vrei ca mai multe servere, un site sau un bot să citească aceleași date;
• vrei ca datele să stea separat de fișierele serverului.

Dacă nu te regăsești aici, poți sări peste ghid și revii când un plugin îți cere o bază de date.

Creează baza de date

1. Deschide serverul în panel și intră la Databases.
2. Apasă New Database.
3. În fereastra Create new database, scrie un nume la Database name, de exemplu luckperms. Folosește litere, cifre și underscore.
4. Lasă gol Connection From. Gol înseamnă că sunt permise conexiuni de oriunde, inclusiv de la serverul tău de joc.
5. Apasă Create Database.

Acum pagina scrie „1 of 1 databases have been allocated to this server” („1 of 2” pe planul Max). Numele scris de tine primește un prefix cu numărul serverului, așa că luckperms devine ceva de genul s12_luckperms. Folosește mereu numele complet, cu prefix.

O singură bază de date ajunge pentru mai multe plugin-uri. Fiecare își creează propriile tabele, cu propriul prefix, așa că LuckPerms și CoreProtect pot împărți aceeași bază de date fără să se încurce.

Găsește datele de conectare

Apasă Database Details pe rândul bazei de date. Fereastra Database connection details arată:

Dă click pe o valoare ca s-o copiezi. Desparte Endpoint-ul la două puncte: mysql.torchlite.host e host-ul, iar 3306 e portul.

Nu folosi localhost sau 127.0.0.1 ca host, chiar dacă așa scrie în config-ul unui plugin. Baza de date nu rulează în serverul tău de joc; stă pe host-ul de baze de date, și doar adresa din Endpoint ajunge la ea.

Parola e generată automat și poate conține simboluri. Dacă ajunge vreodată unde nu trebuie, Rotate Password din aceeași fereastră face una nouă, iar apoi o actualizezi în toate plugin-urile care folosesc baza de date.

Exemplu complet: LuckPerms pe Paper

LuckPerms e cel mai des motiv pentru care jucătorii își fac o bază de date. Aceiași pași merg și pe Purpur și Spigot.

1. Instalează LuckPerms din Plugin Manager sau urcă jar-ul în folderul plugins.
2. Pornește serverul o dată, ca LuckPerms să-și creeze folderul și config-ul, apoi oprește-l.
3. În Files, deschide plugins/LuckPerms/config.yml.
4. Găsește storage-method și secțiunea data de sub el și schimbă-le așa, cu valorile tale:

storage-method: mysql

data:
  address: mysql.torchlite.host:3306
  database: s12_luckperms
  username: u12_AbCdEfGhIj
  password: 'lipeste-parola-aici'

1. Lasă celelalte setări, cum ar fi prefixul tabelelor, cum sunt.
2. Salvează fișierul și pornește serverul.

Păstrează ghilimelele simple din jurul parolei. Ele împiedică YAML să înțeleagă greșit simboluri ca # sau : din parolă.

Urmărește consola cât pornește serverul. LuckPerms scrie ce tip de stocare încarcă, iar acolo ar trebui să apară MySQL. Poți rula și lp info în consolă ca să vezi ce stocare folosește.

Păstrează-ți rangurile existente

Schimbarea stocării nu copiază nimic: LuckPerms pornește cu o bază de date goală. Dacă ți-ai făcut deja grupuri și permisiuni, mută-le:

1. Înainte să editezi config-ul, rulează lp export ranks în consolă. LuckPerms scrie fișierul în propriul folder.
2. Treci pe MySQL ca mai sus și repornește serverul.
3. Rulează lp import ranks.

Pe Fabric, LuckPerms își ține config-ul în config/luckperms/luckperms.conf. Setările au aceleași nume, scrise în formatul fișierului respectiv.

Alte plugin-uri

Fiecare plugin numește câmpurile puțin diferit, dar ele corespund mereu acelorași cinci valori din Database Details:

• host sau address: mysql.torchlite.host;
• port: 3306;
• database sau name: numele complet, cu prefixul s;
• user sau username: utilizatorul care începe cu u;
• password: parola.

CoreProtect, de exemplu, are în plugins/CoreProtect/config.yml câmpurile use-mysql, mysql-host, mysql-port, mysql-database, mysql-username și mysql-password. Pune use-mysql pe true și completează restul. Un plugin care cere în schimb un singur URL JDBC primește JDBC Connection String.

Ține datele în siguranță

Pagina Backups copiază fișierele serverului, nu baza de date. Așa că o restaurare nu dă înapoi și baza de date, iar un backup din panel nu o protejează.

Baza de date e ștearsă și ea odată cu serverul, de exemplu după 5 zile fără activitate. Pentru datele la care ții, folosește din când în când exportul plugin-ului. La LuckPerms asta înseamnă lp export, iar fișierul îl descarci apoi prin SFTP. Ghidul despre backup-uri explică cum păstrezi copii pentru tot restul.

Probleme frecvente

„Communications link failure” sau „Connection refused”

Plugin-ul nu ajunge la baza de date. Verifică host-ul și portul cu cele din Endpoint și asigură-te că n-ai lăsat localhost sau 127.0.0.1 în config.

„Access denied for user”

Utilizatorul sau parola sunt greșite. Copiază-le din nou din Database Details; dacă ai schimbat parola cu Rotate Password, cea veche nu mai merge din acel moment. Și o valoare diferită de % la Connections from poate bloca serverul.

„Unknown database”

Numelui bazei de date îi lipsește prefixul. Folosește numele complet, de exemplu s12_luckperms, nu doar luckperms.

Nu există butonul New Database

Serverul are deja toate bazele de date permise de plan (una, sau două pe Max), iar pagina le arată în listă. Dacă pagina scrie „Databases cannot be created for this server”, întreabă pe Discord-ul nostru și dă-ne ID-ul serverului.

LuckPerms tot H2 folosește

Verifică dacă storage-method e pe mysql și dacă indentarea YAML e corectă. Editează config-ul cu serverul oprit, apoi pornește-l.