Guida LuckPerms: configurare gradi e permessi passo dopo passo
LuckPerms è il plugin di riferimento per i permessi sui server Minecraft con Spigot, Paper o Purpur, ma i suoi comandi spesso confondono al primo approccio. Questa guida ti accompagna dall'installazione a una gerarchia completa Giocatore, VIP, Moderatore e Admin, con modelli da copiare e incollare, l'editor web e le soluzioni ai problemi più comuni.
Cosa fa LuckPerms e cosa non fa
LuckPerms decide chi può fare cosa. Ogni comando o funzione di un plugin è protetto da un permesso, una semplice stringa come essentials.fly. Un permesso può valere true (concesso), false (negato esplicitamente) oppure non essere definito, il che equivale quasi sempre a un rifiuto.
Bastano quattro concetti:
- Gruppo: un insieme di permessi da assegnare ai giocatori. Un grado corrisponde a un gruppo.
- Ereditarietà (parent): un gruppo può ereditare da un altro. Se «admin» eredita da «moderatore», ottiene tutti i suoi permessi.
- Peso (weight): un numero che ordina i gruppi. Più è alto, più il gruppo ha priorità.
- Contesto: una condizione, ad esempio
world=world_netherper un permesso valido solo nel Nether.
Il punto chiave che molte guide tralasciano: LuckPerms memorizza i prefissi ma non li mostra. Per vedere «[Admin]» davanti a un nome in chat servono anche Vault e un plugin di formattazione della chat, come EssentialsX Chat. Ne parliamo più avanti.
Installare LuckPerms su Spigot, Paper o Purpur
A ottobre 2026 la versione attuale è la 5.5.87 (serie 5.5), compatibile con Minecraft dalla 1.8.9 alla 26.3 secondo i metadati ufficiali del progetto.
- Scarica la versione Bukkit dalla pagina di download ufficiale di LuckPerms: è quella che funziona su Spigot, Paper e Purpur.
- Avvia il server una volta, così che la cartella
pluginsesista, poi carica il file.jarcon il file manager del tuo pannello. - Esegui un riavvio completo (
stope nuovo avvio). Evita/reload, che spesso lascia i plugin in uno stato instabile.
Per impostazione predefinita LuckPerms salva i dati in un database H2 (il file luckperms-h2-v2.mv.db, da non cancellare). Se preferisci file leggibili, imposta storage-method su yaml in plugins/LuckPerms/config.yml prima di creare i gradi. Per una rete di più server, scegli MySQL.
Passo 1: darti l'accesso completo
Subito dopo l'installazione nessuno può usare i comandi di LuckPerms, nemmeno tu. Apri la console del server (lì si scrive senza barra):
lp user TuoNome permission set luckperms.* true
Il carattere jolly * concede tutti i permessi che iniziano con luckperms.. Poi puoi continuare in gioco con /lp.
Passo 2: pianificare la gerarchia dei gradi
Prima di scrivere qualsiasi comando, definisci la struttura. Ecco quella che costruiremo:
| Grado | Gruppo | Peso | Eredita da | Prefisso |
|---|---|---|---|---|
| Giocatore | default | 0 | nessuno | &7[Giocatore] |
| VIP | vip | 10 | default | &6[VIP] |
| Moderatore | moderatore | 50 | vip | &9[Mod] |
| Admin | admin | 100 | moderatore | &c[Admin] |
Il gruppo default esiste già e ogni giocatore ne fa parte automaticamente. La documentazione ufficiale sconsiglia di sostituirlo con un altro gruppo; se il nome non ti piace, cambia solo il nome visualizzato con /lp group default setdisplayname Giocatore.
Passo 3: creare i gruppi e l'ereditarietà
Il comando creategroup accetta il peso come secondo argomento facoltativo:
/lp creategroup vip 10
/lp creategroup moderatore 50
/lp creategroup admin 100
/lp group vip parent add default
/lp group moderatore parent add vip
/lp group admin parent add moderatore
L'ereditarietà è ricorsiva: l'admin riceve i permessi del moderatore, quindi anche quelli del VIP e del giocatore. Non dovrai mai ripetere un permesso in più gruppi. Per un gruppo già esistente, il peso si imposta con /lp group vip setweight 10.
Passo 4: modelli di gradi pronti all'uso
Questi modelli usano i permessi di EssentialsX, il plugin di utilità più diffuso. Adattali ai tuoi plugin: la loro documentazione elenca sempre i permessi disponibili.
Giocatore (gruppo default)
/lp group default permission set essentials.spawn true
/lp group default permission set essentials.home true
/lp group default permission set essentials.sethome true
/lp group default permission set essentials.tpa true
/lp group default permission set essentials.tpaccept true
/lp group default permission set essentials.tpdeny true
/lp group default permission set essentials.msg true
/lp group default permission set essentials.balance true
/lp group default permission set essentials.pay true
VIP
Il VIP riceve vantaggi di comodità, niente che sbilanci il gioco:
/lp group vip permission set essentials.hat true
/lp group vip permission set essentials.workbench true
/lp group vip permission set essentials.back true
/lp group vip permission set essentials.nick true
/lp group vip permission set essentials.sethome.multiple true
/lp group vip permission set essentials.sethome.multiple.vip true
Le ultime due righe permettono più case. Il numero esatto si imposta nella sezione sethome-multiple del config.yml di EssentialsX (5 per «vip» nella configurazione predefinita). Servono entrambi i permessi.
Moderatore
/lp group moderatore permission set essentials.kick true
/lp group moderatore permission set essentials.mute true
/lp group moderatore permission set essentials.tempban true
/lp group moderatore permission set essentials.tp true
/lp group moderatore permission set essentials.invsee true
/lp group moderatore permission set essentials.vanish true
/lp group moderatore permission set essentials.socialspy true
Il moderatore può bannare in modo temporaneo ma non definitivo: una protezione semplice contro errori e abusi.
Admin
/lp group admin permission set essentials.* true
/lp group admin permission set minecraft.command.* true
/lp group admin permission set luckperms.* true
Riserva luckperms.* a persone di assoluta fiducia: con questo permesso chiunque può darsi qualsiasi diritto. E non assegnare mai il permesso globale * a un grado di moderazione.
Bloccare un permesso ereditato
Il valore false toglie un permesso ereditato. Esempio: i VIP possono volare ovunque tranne che nel Nether, grazie a un contesto:
/lp group vip permission set essentials.fly true
/lp group vip permission set essentials.fly false world=world_nether
Passo 5: prefissi e visualizzazione in chat
Aggiungi un prefisso a ogni gruppo. La priorità (il primo numero) stabilisce quale prefisso vince quando un giocatore ne eredita più di uno: viene usato il più alto. Usare lo stesso valore del peso rende tutto più leggibile.
/lp group default meta setprefix 0 "&7[Giocatore] "
/lp group vip meta setprefix 10 "&6[VIP] "
/lp group moderatore meta setprefix 50 "&9[Mod] "
/lp group admin meta setprefix 100 "&c[Admin] "
Le virgolette servono a mantenere lo spazio finale. setprefix sostituisce il prefisso esistente nello stesso contesto, mentre addprefix ne aggiunge un altro.
Perché i prefissi compaiano davvero, installa Vault e un plugin di chat compatibile con Vault: EssentialsX Chat se usi già EssentialsX, oppure VaultChatFormatter per una soluzione minimale. Per la lista Tab e i nomi sopra la testa serve un plugin dedicato come TAB.
Passo 6: assegnare i gradi ai giocatori
# Aggiungere un grado (gli altri restano)
/lp user Steve parent add vip
# Sostituire tutti i gradi con uno solo
/lp user Steve parent set moderatore
# VIP per 30 giorni, poi rimosso automaticamente
/lp user Alex parent addtemp vip 30d
# Togliere un grado
/lp user Steve parent remove vip
Le durate si combinano: 1mo3d12h significa un mese, tre giorni e dodici ore. Per verificare, /lp user Steve info mostra i gruppi, il gruppo principale e il prefisso effettivamente passato agli altri plugin.
Passo 7: una track per promuovere lo staff
Una track è una scala ordinata di gruppi. Evita di togliere e aggiungere gruppi a mano a ogni promozione:
/lp createtrack staff
/lp track staff append moderatore
/lp track staff append admin
/lp user Steve promote staff
/lp user Steve demote staff
Se Steve non è ancora in nessun gruppo della track, promote lo inserisce nel primo (moderatore). La promozione successiva lo rende admin e rimuove automaticamente il gruppo moderatore.
La via rapida: l'editor web /lp editor
Se i comandi ti sembrano troppo lunghi, l'editor web fa tutto dal browser, con il completamento automatico dei permessi:
- Digita
/lp editor(oppure/lp editor groupssolo per i gruppi,/lp group vip editorper un singolo gruppo). - Clicca sul link ricevuto in chat o in console.
- Aggiungi i permessi nel campo «Add Permission»; puoi incollarne diversi insieme. Clicca su un valore per modificarlo, o su «Add Contexts» per limitarlo a un mondo.
- Salva con «Save» o Ctrl+S. L'editor genera un comando
/lp applyedits <codice>: eseguilo sul server per applicare le modifiche.
Nell'editor puoi gestire i gradi anche come nodi: group.vip per un gruppo padre, weight.10 per il peso, prefix.10.&6[VIP] per un prefisso, displayname.Giocatore per un nome visualizzato. Non condividere mai pubblicamente il link di una sessione: dà accesso ai tuoi dati dei permessi.
Risoluzione dei problemi più comuni
«Non trovo il permesso giusto»
Usa la modalità verbose, il metodo più affidabile. Avvia /lp verbose record Steve, fai eseguire a Steve il comando che non funziona, poi scrivi /lp verbose upload: otterrai l'elenco esatto dei permessi controllati e il loro esito.
Il prefisso non compare in chat
Controlla prima /lp user Steve info. Se il prefisso c'è, LuckPerms funziona e il problema è nella visualizzazione: manca Vault, oppure il plugin di chat manca o è configurato male. Il comando /vault-info deve indicare che i dati della chat arrivano da LuckPerms.
Un giocatore ha un permesso che non dovrebbe avere
Quasi sempre è un operatore (/op): gli OP ricevono automaticamente tutti i permessi che un plugin riserva per impostazione predefinita agli operatori. Toglilo con /deop e gestisci tutto con LuckPerms. Altrimenti trova l'origine con /lp user Steve permission check essentials.fly.
Le modifiche non vengono applicate
Se qualcosa è stato cambiato fuori dal server (file YAML modificati a mano, database condiviso), ricarica i dati con /lp sync.
Prova tutto su un server gratuito
LuckPerms richiede pochissime risorse. Puoi costruire e testare l'intera struttura dei gradi su un server Minecraft gratuito di MineServerGratis con Paper, Spigot o Purpur prima di aprirlo alla tua community.
Domande frequenti
LuckPerms è gratuito?
Sì, LuckPerms è gratuito e open source su tutte le piattaforme supportate.
Serve Vault per usare LuckPerms?
Per i permessi in sé no. Sì quando un altro plugin (chat, economia, lista Tab) deve leggere gruppi o prefissi tramite Vault.
Come rinomino il gruppo default?
Non si rinomina: gli si dà un nome visualizzato con /lp group default setdisplayname Giocatore, oppure lo si fa ereditare da un gruppo «membro» con /lp group default parent add membro.
Che differenza c'è tra parent add e parent set?
parent add aggiunge un gruppo e mantiene gli altri; parent set rimuove tutti i gruppi esistenti e lascia solo quello nuovo.
Posso dare un grado per un tempo limitato?
Sì, con /lp user Nome parent addtemp vip 30d. Il grado scompare da solo alla scadenza.