Plugin Minecraft AxRewards

🔌 Despre AxRewards

AxRewards este un plugin Minecraft care oferă un sistem de recompense ușor și configurabil. Administratorii serverului definesc recompense cu cooldown-uri arbitrare, le prezintă în interfețe GUI editabile și execută comenzi de revendicare atunci când jucătorii solicită recompensele. Proiectul este întreținut de Artillex-Studios și include stocare bazată pe bază de date, precum și suport pentru mai multe servere.

🎯 Scop

AxRewards rezolvă nevoia comună de recompense programate sau repetabile pentru jucători (de exemplu recompense zilnice sau săptămânale la autentificare), oferind în același timp cooldown-uri flexibile, blocare pe baza permisiunilor și prezentare prin GUI. Este destinat serverelor care doresc un sistem de recompense integrat, configurabil, fără a avea nevoie de sisteme externe de cache.

⚙️ Funcții

• Recompense configurabile cu cooldown-uri arbitrare (specificate în secunde).
• Meniuri GUI editabile pentru prezentarea recompenselor; elementele GUI pot afișa stări diferite (claimable / unclaimable / no-permission).
• Stocare în bază de date cu suport pentru H2, SQLite, MySQL și PostgreSQL.
• Suport pentru mai multe servere fără a necesita Redis.
• GUI cu actualizare automată (se reîmprospătează periodic fără a fi redeschis).
• Posibilitatea de a bloca recompensele în spatele permisiunilor (fiecare recompensă poate necesita o permisiune).
• Acțiunile de revendicare sunt implementate ca o listă de comenzi ale serverului (acceptă placeholder-ul %player%).
• Integrare PlaceholderAPI și suport pentru mai multe formate de culoare.

🧩 Pentru cine este

• Servere Survival și SMP care vor recompense zilnice/săptămânale/custom ce pot fi revendicate.
• Operatorii de servere care au nevoie de persistență bazată pe bază de date între reporniri sau pe mai multe servere.
• Admini care preferă prezentarea recompenselor prin GUI și recompensele blocate pe bază de permisiuni.

🏗️ Exemple de utilizare

• Oferă o recompensă zilnică la autentificare care dă iteme sau rulează comenzi la revendicare.
• Oferă recompense VIP săptămânale cu acces restricționat, care necesită permisiunea rangului pentru a fi revendicate.
• Rulează recompense bazate pe comenzi care oferă bani, iteme sau execută comenzi personalizate ale serverului folosind %player%.

⌨️ Comenzi

(Doar comenzile confirmate în documentația oficială sunt listate.)

⚙️ Instalare

📥 Configurare

• Descarcă JAR-ul pluginului și pune-l în folderul plugins/ al serverului pentru un server compatibil cu Bukkit/Spigot/Paper.
• Pornește sau repornește serverul pentru ca pluginul să-și poată genera folderele de date și configurația.
• Fișierele de configurare și meniurile sunt plasate în folderul pluginului (de exemplu plugins/AxRewards/menus).

📦 Dependențe

• PlaceholderAPI (integrare opțională pentru placeholders) — suport confirmat.

🧠 Note tehnice

• Backend-uri de bază de date confirmate: H2, SQLite, MySQL, PostgreSQL.
• Pluginul suportă PlaceholderAPI și formate comune de culoare (inclusiv MiniMessage și formate legacy).
• GUI-ul se reîmprospătează automat (auto-updating) fără ca jucătorii să fie nevoiți să-l redeschidă.
• Recompensele își definesc cooldown-ul în secunde; setarea cooldown-ului la -1 face ca o recompensă să nu se mai reîmprospăteze niciodată.
• Proiectul este open-source și licențiat sub MIT.
• Software-ul de server și temele confirmate ca fiind suportate includ Bukkit, Spigot, Paper și Folia.
• Cerință confirmată: runtime Java modern (notele proiectului indică Java 21 sau mai recent pentru versiunile recente).

🤝 Când este util acest plugin

Dacă ai nevoie de un sistem de recompense configurabil, bazat pe GUI, cu stocare persistentă și suport cross-server, AxRewards oferă meniuri editabile, gestionarea cooldown-urilor și acțiuni de revendicare bazate pe comenzi, integrându-se cu PlaceholderAPI și bazele de date comune.