IT

Server di gioco

Come gestire gradi e permessi con LuckPerms

Installa LuckPerms sul tuo server Minecraft Paper, crea i gradi, assegna permessi e prefissi, poi verifica e salva la tua configurazione.

7 min di lettura, aggiornato il 18 novembre 2026

In questa pagina

LuckPerms è un plugin che stabilisce cosa può fare ogni giocatore sul tuo server. Questa guida spiega come installarlo, creare una gerarchia di gradi (giocatore, VIP, moderatore, amministratore), assegnarvi i giocatori e controllare il risultato.

Prerequisiti

  • Un server con Paper, con il comando mc-console configurato nella guida Installare e aggiornare i plugin su Paper
  • Nessun altro plugin di permessi installato: LuckPerms deve essere l'unico
  • Il tuo nome utente Minecraft e dei giocatori che si sono già connessi almeno una volta

In questa guida, Steve e Alex sono esempi: sostituiscili con nomi utente reali.

I concetti da conoscere

Concetto Significato
Permesso Diritto in forma di testo, ad esempio minecraft.command.ban. Il suo valore è true (concesso) o false (negato)
Gruppo Insieme di permessi assegnato ai giocatori: è il tuo grado
Parent Gruppo da cui si eredita. Un giocatore eredita dai suoi gruppi, e un gruppo può ereditare da un altro
Peso Priorità di un gruppo in caso di conflitto. Vince il numero più alto
Contesto Condizione di applicazione di un permesso, ad esempio un mondo specifico
Percorso (track) Scala di gradi che permette di promuovere o retrocedere un giocatore

Per impostazione predefinita, tutti i giocatori appartengono al gruppo default, che esiste fin dall'installazione.

Installare LuckPerms

Scarica la versione per Bukkit/Paper nella cartella plugins:

Terminale
sudo -u minecraft bash
cd /opt/minecraft/server/plugins
URL=$(curl -fsSL https://metadata.luckperms.net/data/all | jq -r '.downloads.bukkit')
curl -fLO "$URL"
ls -l LuckPerms-*.jar
exit

Riavvia poi il server e attendi la riga Done:

Terminale
sudo systemctl restart minecraft.service
sudo journalctl -u minecraft.service -f

Esci dalla visualizzazione dei log con Ctrl+C, poi verifica che il plugin risponda:

Terminale
sudo mc-console 'lp info'

La risposta indica la versione di LuckPerms e il tipo di archiviazione utilizzato.

Scegliere l'archiviazione

Per impostazione predefinita, LuckPerms salva i dati in un database locale H2, il file plugins/LuckPerms/luckperms-h2-v2.mv.db. Questa scelta è adatta a un singolo server e non devi cambiare nulla.

Se preferisci file leggibili e modificabili, imposta storage-method: yaml in plugins/LuckPerms/config.yml, poi riavvia il server. Se gestisci più server che condividono gli stessi gradi, ti serve un database remoto come MySQL o MariaDB. Fai questa scelta ora: è più semplice prima di creare i gruppi.

Darti l'accesso ai comandi

Subito dopo l'installazione, nessuno può usare /lp in gioco. Vi ha accesso solo la console. Assegnati tutti i permessi su LuckPerms:

Terminale
sudo mc-console 'lp user Steve permission set luckperms.* true'

Potrai poi usare /lp in gioco, oppure continuare dalla console come nel resto di questa guida.

Creare i gradi

Ecco la gerarchia dell'esempio. Lascia uno scarto tra i pesi per poter inserire un grado in seguito.

Gruppo Peso Eredita da Ruolo
default 1 nessuno Tutti i giocatori
vip 10 default Giocatori privilegiati
moderator 50 vip Moderazione
admin 100 moderator Amministrazione

Crea i gruppi e i relativi pesi:

Terminale
sudo mc-console 'lp creategroup vip'
sudo mc-console 'lp creategroup moderator'
sudo mc-console 'lp creategroup admin'
sudo mc-console 'lp group default setweight 1'
sudo mc-console 'lp group vip setweight 10'
sudo mc-console 'lp group moderator setweight 50'
sudo mc-console 'lp group admin setweight 100'

Definisci poi l'ereditarietà. L'ereditarietà si trasmette: admin riceve anche i permessi di vip e di default.

Terminale
sudo mc-console 'lp group vip parent add default'
sudo mc-console 'lp group moderator parent add vip'
sudo mc-console 'lp group admin parent add moderator'

Assegnare i permessi

I comandi di Minecraft usano permessi nella forma minecraft.command.<comando>. Dai ai moderatori ciò che serve per espellere e bannare, e agli amministratori permessi aggiuntivi:

Terminale
sudo mc-console 'lp group moderator permission set minecraft.command.kick true'
sudo mc-console 'lp group moderator permission set minecraft.command.ban true'
sudo mc-console 'lp group moderator permission set minecraft.command.pardon true'
sudo mc-console 'lp group admin permission set minecraft.command.gamemode true'
sudo mc-console 'lp group admin permission set minecraft.command.whitelist true'

Per rimuovere un permesso, o per vietarlo esplicitamente:

Terminale
sudo mc-console 'lp group moderator permission unset minecraft.command.pardon'
sudo mc-console 'lp group vip permission set minecraft.command.kick false'

unset cancella la riga, mentre false nega attivamente il permesso, anche se è ereditato da altrove. Questi due comandi sono esempi: eseguili solo se vuoi davvero queste modifiche.

Per conoscere i permessi di un plugin, consulta la sua documentazione. Puoi anche osservare quelli che il server controlla quando un giocatore digita un comando:

Terminale
sudo mc-console 'lp verbose on Steve'

Fai digitare il comando al giocatore, leggi i log con sudo journalctl -u minecraft.service -n 30 --no-pager, poi disattiva il monitoraggio:

Terminale
sudo mc-console 'lp verbose off'

Assegnare i giocatori ai gradi

Terminale
# Sostituisce tutti i gruppi del giocatore con questo grado
sudo mc-console 'lp user Steve parent set moderator'

# Aggiunge un grado senza rimuovere gli altri
sudo mc-console 'lp user Alex parent add vip'

# Rimuove un grado
sudo mc-console 'lp user Alex parent remove vip'

# Assegna un grado per 30 giorni
sudo mc-console 'lp user Alex parent addtemp vip 30d'

Le modifiche si applicano immediatamente, senza riavvio.

Creare un percorso di promozione

Un percorso permette di far salire o scendere un giocatore di un livello, senza dover ricordare il nome dei gradi. Non cambia nulla nell'ereditarietà.

Terminale
sudo mc-console 'lp createtrack staff'
sudo mc-console 'lp track staff append default'
sudo mc-console 'lp track staff append moderator'
sudo mc-console 'lp track staff append admin'
sudo mc-console 'lp user Alex promote staff'
sudo mc-console 'lp user Alex demote staff'

Aggiungere i prefissi

Un prefisso viene mostrato davanti al nome utente. Il suo peso decide quale viene scelto quando un giocatore ne eredita più di uno. I codici come &c definiscono il colore:

Terminale
sudo mc-console 'lp group vip meta setprefix 10 "&6[VIP] "'
sudo mc-console 'lp group moderator meta setprefix 50 "&9[Modo] "'
sudo mc-console 'lp group admin meta setprefix 100 "&c[Admin] "'

Mantieni gli apici singoli attorno al comando completo e le virgolette doppie attorno al prefisso.

Limitare un permesso a un mondo

Aggiungi un contesto alla fine del comando. Con la configurazione predefinita, il mondo principale si chiama world:

Terminale
sudo mc-console 'lp group vip permission set minecraft.command.weather true world=world'

Per rimuoverlo, indica lo stesso contesto:

Terminale
sudo mc-console 'lp group vip permission unset minecraft.command.weather world=world'

Usare l'editor web

Se preferisci un'interfaccia grafica, LuckPerms offre un editor nel browser:

Terminale
sudo MC_CONSOLE_WAIT=5 mc-console 'lp editor'

Apri il link visualizzato, apporta le modifiche e salva. Se l'editor ti fornisce un comando da eseguire, lancialo nella console per applicare le modifiche. Non condividere questo link: dà accesso alla modifica dei tuoi permessi.

Verificare il risultato

Terminale
sudo mc-console 'lp listgroups'
sudo mc-console 'lp group moderator info'
sudo mc-console 'lp group moderator listmembers'
sudo mc-console 'lp user Steve info'
sudo mc-console 'lp user Steve permission check minecraft.command.kick'
sudo mc-console 'lp user Steve meta info'

Dovresti ritrovare i tuoi quattro gruppi, Steve in moderator, il permesso minecraft.command.kick impostato su true e il prefisso [Modo].

Fai poi una prova reale con un account che non sia operatore. Un operatore dispone già della maggior parte dei permessi, e questo nasconde gli errori di configurazione. Se necessario, rimuovi questo stato:

Terminale
sudo mc-console 'deop Steve'

Salvare i permessi

Il comando seguente crea il file plugins/LuckPerms/sauvegarde-luckperms.json.gz:

Terminale
sudo MC_CONSOLE_WAIT=5 mc-console 'lp export sauvegarde-luckperms'

Per ripristinare questo file, posizionato in plugins/LuckPerms, indicane l'estensione:

Terminale
sudo MC_CONSOLE_WAIT=5 mc-console 'lp import sauvegarde-luckperms.json.gz'

Copia regolarmente questo file fuori dal server, perché un backup conservato nello stesso posto andrebbe perso insieme al server.

Aggiornare LuckPerms

Metti la nuova versione in plugins/update, poi riavvia. Paper sostituisce il vecchio file all'avvio:

Terminale
sudo -u minecraft bash
mkdir -p /opt/minecraft/server/plugins/update
cd /opt/minecraft/server/plugins/update
URL=$(curl -fsSL https://metadata.luckperms.net/data/all | jq -r '.downloads.bukkit')
curl -fLO "$URL"
exit
sudo systemctl restart minecraft.service

In caso di problemi

« You do not have permission to use this command! »

Il tuo account non ha accesso a /lp. Assegnati luckperms.* dalla console, come indicato sopra.

« A user for Steve could not be found »

Il nome utente è scritto male, oppure questo giocatore non si è mai connesso. Controlla l'ortografia e chiedigli di connettersi una prima volta.

« A group named vip could not be found »

Il gruppo non esiste ancora. Controlla l'elenco con sudo mc-console 'lp listgroups', poi crealo con lp creategroup.

« Cannot execute command 'lp' in plugin LuckPerms … plugin is disabled »

LuckPerms non è riuscito ad avviarsi. Cerca il primo errore nei log:

Terminale
sudo journalctl -u minecraft.service --no-pager | grep -i -A5 'luckperms' | grep -iE 'error|exception|caused by' | head -20
df -h /opt/minecraft

Un disco pieno (No space left on device) o una cartella che non appartiene a minecraft impedisce al plugin di creare i suoi file. Nel secondo caso, esegui sudo chown -R minecraft /opt/minecraft/server, poi riavvia il server.

Un permesso non funziona

  • Controllalo con lp user Steve permission check <permesso>
  • Verifica con sudo mc-console plugins che non sia installato nessun altro plugin di permessi
  • Prova con un account non operatore
  • Controlla se un gruppo di peso superiore lo nega con false
  • Usa lp verbose per vedere il nome esatto del permesso controllato

Il prefisso non appare nella chat

Verifica prima che sia stato salvato con lp user Steve meta info. Se lo è, il problema riguarda la visualizzazione: installa Vault e un plugin di chat. Se due prefissi hanno lo stesso peso, assegna loro pesi diversi.

I giocatori Bedrock non vengono riconosciuti

Con Floodgate i nomi utente Bedrock iniziano con un punto, cosa che LuckPerms rifiuta per impostazione predefinita. La procedura da seguire si trova nella guida Accogliere i giocatori Bedrock con Geyser e Floodgate.

Per approfondire, consulta la wiki ufficiale di LuckPerms.