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.
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-consoleconfigurato 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:
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
exitRiavvia poi il server e attendi la riga Done:
sudo systemctl restart minecraft.service
sudo journalctl -u minecraft.service -fEsci dalla visualizzazione dei log con Ctrl+C, poi verifica che il plugin risponda:
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:
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:
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.
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:
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:
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:
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:
sudo mc-console 'lp verbose off'Assegnare i giocatori ai gradi
# 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à.
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:
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:
sudo mc-console 'lp group vip permission set minecraft.command.weather true world=world'Per rimuoverlo, indica lo stesso contesto:
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:
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
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:
sudo mc-console 'deop Steve'Salvare i permessi
Il comando seguente crea il file plugins/LuckPerms/sauvegarde-luckperms.json.gz:
sudo MC_CONSOLE_WAIT=5 mc-console 'lp export sauvegarde-luckperms'Per ripristinare questo file, posizionato in plugins/LuckPerms, indicane l'estensione:
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:
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.serviceIn 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:
sudo journalctl -u minecraft.service --no-pager | grep -i -A5 'luckperms' | grep -iE 'error|exception|caused by' | head -20
df -h /opt/minecraftUn 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 pluginsche 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 verboseper 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.