Plugin Minecraft Rankup

🔌 Despre Rankup

Rankup este un plugin Minecraft pentru Bukkit/Spigot care implementează un sistem de progresie configurabil, de tip scară de rankuri. Oferă un GUI pentru a răsfoi pașii de rank, un sistem flexibil de cerințe pentru a controla când pot avansa jucătorii și un sistem prestige pentru progresie repetată. Pluginul este destinat administratorilor de servere care vor o metodă automată și configurabilă de a promova jucătorii prin rankuri.

🎯 Scop

Rankup rezolvă problema gestionării progresiei jucătorilor (scara de rankuri) fără promovare manuală. Centralizează definițiile de rank, cerințele de avansare și mecanicile opționale de prestige, astfel încât proprietarii serverelor să poată defini progresii în mai mulți pași legate de permissions și cerințe personalizate.

⚙️ Funcții

• Scară de rankuri configurabilă definită în rankups.yml.
• GUI pentru ca jucătorii să vadă și să confirme rankup-ul.
• Sistem de cerințe pentru definirea condițiilor fiecărui pas de rank (de ex. permissions, timp de joc, tokenuri/valori furnizate de pluginurile de cerințe).
• Suport pentru prestige cu un fișier separat prestiges.yml.
• Comenzi pentru listarea rankurilor, efectuarea unui rankup pe un singur pas sau pe mai mulți pași și reîncărcarea configurației.
• Suport pentru placeholder prin engine-ul de placeholder al pluginului pentru mesaje și GUI.
• Control al accesului bazat pe permissions pentru comenzi și funcții administrative.

🧩 Pentru cine este

• Servere Survival / SMP care folosesc progresie sau scări de rankuri.
• Servere Prison sau economy care oferă sisteme de promovare pe pași.
• Admini de server care vor avansare pe rankuri bazată pe permissions, cu suport GUI.

🏗️ Exemple de utilizare

• Definiți o secvență de rankuri care cere automat tot mai mult timp de joc sau tot mai multe iteme înainte ca un jucător să poată avansa.
• Folosiți prestige pentru a reseta rankul unui jucător, oferindu-i în același timp recompense speciale sau contoare de progres.
• Integrați cu un plugin de permissions pentru a acorda sau elimina permission nodes legate de rank atunci când un jucător avansează.

⌨️ Comenzi

🔐 Permissions

⚙️ Instalare

📥 Configurare

• Descărcați JAR-ul pluginului din distribuția oficială sau construiți-l din sursă.
• Plasați JAR-ul în directorul plugins/ al serverului dvs.
• Porniți sau reporniți serverul și verificați outputul consolei pentru a confirma că pluginul a fost încărcat.
• Folosiți fișierele de configurare furnizate (rankups.yml, prestiges.yml, locale/config) și comanda de reload furnizată pentru a aplica modificările în timpul rulării.

📦 Build from source

• Proiectul include un Gradle wrapper; rulați gradlew build inclus pentru a produce JAR-ul pluginului în directorul build/libs.

🧠 Note tehnice

• Pluginul folosește fișiere de configurare YAML (în special rankups.yml și prestiges.yml) pentru definițiile de rank și prestige.
• Oferă un engine de placeholder și suportă placeholders pentru utilizare în mesaje și GUI.
• Pluginul expune permission nodes explicite pentru comenzi și o permisiune administrativă pentru a reda accesul OP.
• Codul sursă este publicat sub GPL-3.0.

🤝 Când este util acest plugin

Dacă aveți nevoie de o scară de rankuri configurabilă, sensibilă la permissions, cu suport GUI și prestige, Rankup centralizează definițiile de rank și regulile de avansare pentru a automatiza progresia jucătorilor fără promovări manuale.