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.
(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.
(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'
ope 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
- Wiki di LuckPerms: https://luckperms.net/wiki/Home
- Riferimento dei comandi: https://luckperms.net/wiki/Command-Usage
- Editor web: https://luckperms.net/wiki/Web-Editor
LuckPerms: guarda l'esempio
Registrazioni nostre da un ambiente demo. La versione e la configurazione mostrate possono differire da quelle del tuo server.