Plugin Minecraft DeluxeTags

🔌 Informazioni su DeluxeTags

DeluxeTags è un plugin Spigot per Minecraft che fornisce tag extra basati sui permessi (prefissi) che i giocatori possono sbloccare e cambiare tramite una GUI in gioco o comandi. I tag sono trattati come un "prefisso extra" e possono essere mostrati in chat, nella tab e in altre integrazioni chat tramite placeholder.

🎯 Scopo

DeluxeTags risolve il problema di dare ai giocatori tag cosmetici opzionali e sbloccabili, separati dai prefissi di rango/gruppo. È utile per server che vogliono tag acquistabili/sbloccabili o ottenibili come ricompensa, che i giocatori possono attivare o disattivare senza cambiare il proprio gruppo o rango principale.

⚙️ Funzionalità

• Tag basati sui permessi: concedi l'accesso con deluxetags.tag.<identifier> (esempio mostrato nella configurazione come deluxetags.tag.example).
• GUI per i giocatori per sfogliare e selezionare i tag disponibili.
• Comandi per elencare, selezionare e gestire i tag (comandi per giocatori e admin documentati dal progetto).
• Supporto a PlaceholderAPI e placeholder per inserire tag attivo, identificatore, descrizione e conteggio nei formati chat.
• Elementi GUI, nomi e impostazioni di paginazione configurabili mostrati nello snippet di configurazione del plugin.
• Opzioni per caricare il tag di un giocatore all'accesso, integrazione con la formattazione della chat e controlli aggiornamenti.

🧩 A chi è rivolto

• Server Survival / SMP che vogliono tag chat cosmetici e sbloccabili separati dai prefissi di rango.
• Server che usano plugin di permessi per assegnare ricompense cosmetiche (ad esempio tramite LuckPerms).
• Admin che vogliono un selettore di tag semplice basato su GUI per i giocatori.

🏗️ Esempi d'uso

• Concedere a un giocatore il permesso di un tag VIP come cosmetico acquistabile e permettergli di attivarlo/disattivarlo dalla GUI dei tag.
• Una ricompensa evento concede un permesso tag specifico, così i vincitori possono selezionare il nuovo tag tra quelli disponibili.
• Gli amministratori creano tag personalizzati tramite comandi e impostano quali giocatori possono usarli tramite i permessi.

⌨️ Comandi

Nota: la documentazione del progetto conferma questi comandi; i nodi di permesso specifici dei comandi (oltre al pattern per-tag) non sono elencati nella fonte principale.

🔐 Permessi

Il plugin usa nodi di permesso per singolo tag; altri nodi specifici dei comandi non sono documentati esplicitamente nei file principali del progetto disponibili.

⚙️ Installazione

📥 Configurazione

• Scarica il JAR del plugin dalla risorsa Spigot del progetto o dagli artefatti di build ufficiali.
• Metti il JAR nella cartella plugins/ del tuo server.
• Avvia o riavvia il server e controlla la console per confermare che il plugin sia stato caricato.

📦 Dipendenze

• PlaceholderAPI — supportato (il plugin include placeholder e un'opzione papi_chat), indicato nella configurazione e negli esempi di placeholder.

🧾 Configurazione

• DeluxeTags usa una configurazione YAML che definisce tag, impostazioni GUI e messaggi. La configurazione include esempi di voci tag, impostazioni degli elementi GUI, placeholder e opzioni di formato chat. Chiavi comuni viste nella configurazione: deluxetags:, gui:, format_chat, papi_chat, load_tag_on_join.

🧠 Note tecniche

• Il codice sorgente del progetto è disponibile in un repository GitHub pubblico.
• Il progetto Spigot elenca versioni testate di Minecraft dalla 1.8 alla 1.21 e include una voce specifica 1.20.6 nell'elenco delle versioni testate.
• Build di sviluppo e artefatti CI sono forniti dal server CI del progetto.
• Il repository non mostra release pubblicate sull'host sorgente; gli artefatti CI sono disponibili separatamente.

🤝 Quando questo plugin è utile

Se vuoi che i giocatori abbiano tag cosmetici opzionali, basati sui permessi, che possano attivare tramite una GUI o comandi senza cambiare i gruppi di rango, DeluxeTags offre una soluzione semplice e configurabile con integrazione PlaceholderAPI per la visualizzazione in chat.