Torna al blog
Rangées de clés anciennes sur fond jaune, symbole des rangs et permissions gérés avec LuckPerms
Pubblicato il 19/10/2026

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_nether per 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.

  1. Scarica la versione Bukkit dalla pagina di download ufficiale di LuckPerms: è quella che funziona su Spigot, Paper e Purpur.
  2. Avvia il server una volta, così che la cartella plugins esista, poi carica il file .jar con il file manager del tuo pannello.
  3. Esegui un riavvio completo (stop e 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:

GradoGruppoPesoEredita daPrefisso
Giocatoredefault0nessuno&7[Giocatore]
VIPvip10default&6[VIP]
Moderatoremoderatore50vip&9[Mod]
Adminadmin100moderatore&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:

  1. Digita /lp editor (oppure /lp editor groups solo per i gruppi, /lp group vip editor per un singolo gruppo).
  2. Clicca sul link ricevuto in chat o in console.
  3. 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.
  4. 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.