Plugin Minecraft PlayerPoints

🔌 Despre PlayerPoints

PlayerPoints este un plugin Minecraft care oferă serverelor un sistem de monedă bazat pe puncte. Expune un API astfel încât alte pluginuri să se poată integra direct, oferă hook-uri opționale pentru pluginuri populare și include suport de stocare bazat pe SQL.

🎯 Scop

PlayerPoints este conceput pentru a oferi serverelor o economie secundară ușoară (puncte) care poate fi acordată, cheltuită sau interogată de alte pluginuri. Rezolvă nevoia unui sistem simplu, scriptabil, de puncte/monedă, fără a necesita un plugin complet de economie monetară.

⚙️ Caracteristici

• Sistem de monedă bazat pe puncte pentru conturile jucătorilor.
• API public pentru ca alte pluginuri să citească și să modifice punctele.
• Suport SQL pentru stocare persistentă (repository-ul descrie suportul SQL).
• Integrare opțională cu Vault și PlaceholderAPI.
• Creează propriul folder de date al pluginului la prima rulare și stochează acolo configurația/datele.

🧩 Pentru cine este

• Servere Survival și SMP care vor o monedă secundară sub formă de puncte.
• Servere care au nevoie de un API simplu pentru autorii de pluginuri, ca să acorde sau să verifice punctele jucătorilor.
• Servere care preferă integrarea opțională cu Vault/PlaceholderAPI.

🏗️ Exemple de utilizare

• Acordarea de puncte ca recompense pentru minigames sau quest-uri.
• Folosirea punctelor ca monedă pentru a cumpăra obiecte cosmetice sau permisiuni pe server prin intermediul altui plugin.
• Pluginuri care citesc punctele pentru a crea sisteme de ranguri, clasamente sau urmărirea progresului.

⚙️ Instalare

📥 Configurare

• Descărcați fișierul jar al pluginului din resursa oficială și puneți-l în directorul plugins/ al serverului.
• Porniți serverul. La prima pornire, PlayerPoints va crea folderul plugins/PlayerPoints, care conține fișierele de configurare și date.
• Confirmați că pluginul s-a încărcat verificând mesajele PlayerPoints din consola serverului.

📦 Dependențe

• Nu există dependențe obligatorii.
• Opțional: Vault (hook opțional) și PlaceholderAPI (hook opțional).

🧠 Note tehnice

• Sursele oficiale menționează compatibilitate cu Spigot și fork-urile sale; Paper este recomandat. CraftBukkit nu este suportat.
• Proiectul menționează suport pentru versiunile Minecraft 1.8.8 și mai noi.
• Pluginul este open-source sub licența GPL-3.0 și expune un API pentru integrare de către alte pluginuri.

🤝 Când este util acest plugin

Când aveți nevoie de un sistem de puncte simplu, scriptabil, cu API și integrare opțională cu pluginuri comune din ecosistem, PlayerPoints oferă o soluție focalizată la care alte pluginuri se pot conecta în mod fiabil.