LuckPerms è il plugin dei permessi con cui stabilisci chi può usare quali comandi su un server Paper o Spigot. Senza un plugin dei permessi esistono solo due livelli: l'operatore, che può fare tutto, e i giocatori normali, che non possono fare quasi nulla. LuckPerms inserisce dei gruppi tra questi due estremi: ospiti, costruttori, moderazione. Ogni gruppo ha i propri nodi di permesso e i giocatori ereditano i nodi dei gruppi a cui appartengono.

Questa guida ti accompagna dall'installazione fino alla creazione del primo gruppo di moderazione. I comandi provengono dalla documentazione ufficiale di LuckPerms; gli screenshot da un server di prova con Paper 1.21.4 e LuckPerms 5.5.71.

Installazione dal pannello

Nel pannello del server trovi LuckPerms in Plugin → Browser. La ricerca recupera i dati da Modrinth; il loader e la versione del server vengono confrontati con i metadati del plugin prima che il file finisca nella cartella plugins/. Se vuoi il pacchetto completo, l'assistente per la protezione del mondo nella pagina dei plugin installa LuckPerms insieme a WorldGuard e WorldEdit in un solo passaggio. Dopo il riavvio, quando entri nel server il plugin mostra la versione e l'autore.

Chat dopo l'accesso: LuckPerms 5.5.71 è caricato, con sito web e autore (Enlarge image)

Questo messaggio compare quando digiti /luckperms o, in breve, /lp senza argomenti. È il modo più rapido per verificare che il plugin sia davvero in funzione.

Come sono strutturati i permessi in LuckPerms

Un nodo di permesso è una stringa come essentials.home o worldedit.region.set. Ogni plugin ha i propri nodi e li documenta. Un nodo può essere impostato su true o false. L'asterisco in worldedit.* copre tutti i nodi di un plugin: è comodo per la moderazione, ma pericoloso per i giocatori normali.

LuckPerms prevede tre livelli:

  • I gruppi raggruppano i nodi. Ogni giocatore riceve automaticamente il gruppo default.
  • I giocatori ereditano i nodi dai propri gruppi e possono averne anche di propri.
  • I contesti limitano i nodi, ad esempio a un mondo o a una modalità di gioco.

Mantieni una struttura semplice. Per la maggior parte dei server bastano da due a quattro gruppi.

Creare il primo gruppo

Puoi eseguire i seguenti comandi nella console del server o in gioco come operatore:

/lp creategroup mod
/lp group mod permission set worldedit.* true
/lp group mod permission set essentials.kick true
/lp user NomeGiocatore parent add mod

La prima riga crea il gruppo. Le due righe con permission set gli assegnano l'intero WorldEdit e il comando kick di EssentialsX. L'ultima riga aggiunge un giocatore al gruppo. Puoi controllare il risultato con /lp user Spielername permission check essentials.kick.

Per il gruppo default conviene seguire la strada opposta: togliere i comandi di cui i giocatori non hanno bisogno. Senza il permesso bukkit.command.plugins, Paper non mostra più il comando /plugins; il giocatore vede soltanto un messaggio di errore relativo a un comando sconosciuto.

Senza il permesso bukkit.command.plugins, il server segnala un comando sconosciuto (Enlarge image)
/lp group default permission set bukkit.command.plugins false

Non è una misura di sicurezza in senso stretto, ma tiene l'elenco dei plugin lontano dagli ospiti curiosi.

L'editor web

Per le modifiche più corpose, la console è scomoda. /lp editor genera un link all'editor web su luckperms.net. Lì vedi tutti i gruppi e i giocatori in una tabella, puoi impostare i nodi con il mouse e, alla fine, trasferire la sessione sul server con un clic. Il link è valido per pochi minuti e si può usare solo con il codice generato. Le sessioni contengono nomi dei giocatori e UUID, quindi non condividere il link.

Errori comuni

  • Un permesso non ha effetto. Il giocatore è ancora operatore. Gli operatori aggirano LuckPerms. Togli l'op e lavora solo con i gruppi.
  • Nodo scritto male. LuckPerms accetta qualsiasi testo, anche con errori di battitura. Controlla il nodo nella documentazione del plugin interessato.
  • Asterisco in default. Un nodo * nel gruppo predefinito concede tutto a ogni ospite. Usa gli asterischi solo nei gruppi di moderazione.
  • Modifiche perse dopo il riavvio. Per impostazione predefinita, LuckPerms salva i dati in un file H2 nella cartella del plugin. Se al riavvio la cartella non è scrivibile, le modifiche vanno perse. Controlla la console all'avvio per individuare l'errore.

Posizione dei dati e backup

Tutti i dati si trovano in plugins/LuckPerms/. Il backup del pannello include anche questa cartella. Per le reti con più server, LuckPerms offre un database MySQL condiviso; per un singolo server, H2 rimane la scelta più semplice.

Guide correlate

Per sapere come installare e aggiornare i plugin in generale, consulta la guida Installare e gestire i plugin. La protezione del mondo tramite regioni è spiegata in WorldGuard: proteggere le regioni, mentre gli strumenti di costruzione sono illustrati in WorldEdit: costruire e annullare le modifiche.

Fonti

LuckPerms: guarda l'esempio

Registrazioni nostre da un ambiente demo. La versione e la configurazione mostrate possono differire da quelle del tuo server.

LuckPerms: Without permission, the tested plugin-list command is unavailable.
Without permission, the tested plugin-list command is unavailable.

LuckPerms 5.5.71 · 2026-09-12

LuckPerms: After the permission change, the same command returns the plugin list.
After the permission change, the same command returns the plugin list.

LuckPerms 5.5.71 · 2026-09-12