Plugin Minecraft Rankup

🔌 Informazioni su Rankup

Rankup è un plugin Minecraft per Bukkit/Spigot che implementa un sistema di progressione a livelli di rank configurabile. Offre una GUI per sfogliare gli step dei rank, un motore dei requisiti flessibile per controllare quando i giocatori possono avanzare e un sistema di prestige per la progressione ripetuta. Il plugin è pensato per gli amministratori di server che vogliono un modo automatizzato e configurabile per promuovere i giocatori attraverso i rank.

🎯 Scopo

Rankup risolve il problema di gestire la progressione dei giocatori (scale di rank) senza promozioni manuali. Centralizza le definizioni dei rank, i requisiti di avanzamento e le meccaniche opzionali di prestige, così che i proprietari del server possano definire progressioni in più passaggi legate a permessi e requisiti personalizzati.

⚙️ Funzionalità

• Scala di rank configurabile definita in rankups.yml.
• GUI per permettere ai giocatori di vedere e confermare i rankup.
• Sistema di requisiti per definire le condizioni di ogni step di rank (ad esempio permessi, tempo di gioco, token/valori forniti dai plugin di requisiti).
• Supporto ai prestige con un prestiges.yml separato.
• Comandi per elencare i rank, eseguire rankup singoli o multi-step e ricaricare la configurazione.
• Supporto ai placeholder tramite il motore di placeholder del plugin per messaggi e GUI.
• Controllo degli accessi basato sui permessi per comandi e funzioni amministrative.

🧩 A chi è rivolto

• Server Survival / SMP che usano progressione o scale di rank.
• Server Prison o economy che espongono sistemi di promozione basati su step.
• Admin di server che vogliono un avanzamento di rank guidato dai permessi con supporto GUI.

🏗️ Casi d’uso di esempio

• Definire una sequenza di rank che richieda automaticamente più tempo di gioco o oggetti prima che un giocatore possa avanzare.
• Usare i prestige per azzerare il rank di un giocatore concedendo al tempo stesso ricompense speciali o contatori di progressione.
• Integrare un plugin permessi per assegnare o rimuovere nodi di permesso legati ai rank quando un giocatore avanza.

⌨️ Comandi

🔐 Permessi

⚙️ Installazione

📥 Configurazione

• Scarica il JAR del plugin dalla distribuzione del plugin (risorsa ufficiale) oppure compilalo dal sorgente.
• Metti il JAR nella directory plugins/ del tuo server.
• Avvia o riavvia il server e controlla l’output della console per confermare che il plugin sia stato caricato.
• Usa i file di configurazione forniti (rankups.yml, prestiges.yml, locale/config) e il comando di reload fornito per applicare le modifiche a runtime.

📦 Compilare dal sorgente

• Il progetto include un Gradle wrapper; esegui il gradlew build incluso per produrre il JAR del plugin nella directory build/libs.

🧠 Note tecniche

• Il plugin usa file di configurazione YAML (in particolare rankups.yml e prestiges.yml) per le definizioni di rank e prestige.
• Fornisce un motore di placeholder e supporta i placeholder da usare nei messaggi e nelle GUI.
• Il plugin espone nodi di permesso espliciti per i comandi e un permesso amministrativo per rispecchiare l’accesso OP.
• Il codice sorgente è pubblicato sotto GPL-3.0.

🤝 Quando questo plugin è utile

Se ti serve una scala di rank configurabile e basata sui permessi, con supporto GUI e prestige, Rankup centralizza le definizioni dei rank e le regole di avanzamento per automatizzare la progressione dei giocatori senza promozioni manuali.