O LuckPerms é o plugin de permissões com o qual defines, num servidor Paper ou Spigot, quem pode usar que comandos. Sem um plugin de permissões, existem apenas dois níveis: o operador, que pode tudo, e os jogadores normais, que não podem quase nada. O LuckPerms acrescenta grupos entre estes dois níveis: convidados, construtores, moderação. Cada grupo tem nós de permissão, e os jogadores herdam os nós dos seus grupos.
Este guia mostra-te o caminho desde a instalação até ao primeiro grupo de moderação. Os comandos vêm da documentação oficial do LuckPerms; as capturas de ecrã são de um servidor de testes com Paper 1.21.4 e LuckPerms 5.5.71.
Instalação através do painel
No painel do servidor, encontras o LuckPerms em Plugins → Browser. A pesquisa obtém os dados do Modrinth; o loader e a versão do servidor são comparados com os metadados do plugin antes de o ficheiro ser colocado na pasta plugins/. Se quiseres o pacote completo, o assistente de proteção do mundo, na página do plugin, instala o LuckPerms juntamente com o WorldGuard e o WorldEdit num só passo. Depois de reiniciares, o plugin indica a versão e o autor quando entras no servidor.
(Enlarge image)Esta mensagem aparece quando escreves /luckperms ou, de forma abreviada, /lp sem argumentos. É a forma mais rápida de testar se o plugin está mesmo a funcionar.
Como estão estruturadas as permissões no LuckPerms
Um nó de permissão é uma cadeia de caracteres como essentials.home ou worldedit.region.set. Cada plugin traz os seus próprios nós e documenta-os. Um nó pode estar definido como true ou false. O asterisco em worldedit.* abrange todos os nós de um plugin e é prático para a moderação, mas perigoso para os jogadores normais.
O LuckPerms tem três níveis:
- Grupos agrupam nós. Todos os jogadores recebem automaticamente o grupo
default. - Jogadores herdam dos seus grupos e podem ter também nós próprios.
- Contextos limitam os nós, por exemplo, a um mundo ou a um modo de jogo.
Mantém a estrutura simples. Dois a quatro grupos chegam para a maioria dos servidores.
Criar o primeiro grupo
Os comandos seguintes podem ser executados na consola do servidor ou no jogo, como operador:
/lp creategroup mod
/lp group mod permission set worldedit.* true
/lp group mod permission set essentials.kick true
/lp user NomeDoJogador parent add mod
A primeira linha cria o grupo. As duas linhas com permission set dão-lhe acesso total ao WorldEdit e ao comando de expulsão do EssentialsX. A última linha adiciona um jogador ao grupo. Podes verificar o resultado com /lp user Spielername permission check essentials.kick.
Para o grupo default, compensa fazer o contrário: retirar os comandos de que os jogadores não precisam. Sem a permissão bukkit.command.plugins, o Paper deixa de mostrar o comando /plugins; o jogador vê apenas uma mensagem de erro sobre um comando desconhecido.
(Enlarge image)/lp group default permission set bukkit.command.plugins false
Em rigor, isto não é uma medida de segurança, mas mantém a lista de plugins longe de convidados curiosos.
O editor web
Para alterações maiores, a consola torna-se pouco prática. O comando /lp editor gera uma ligação para o editor web em luckperms.net. Aí vês todos os grupos e jogadores numa tabela, podes definir nós com o rato e, no fim, transferir a sessão de volta para o servidor com um clique. A ligação é válida durante poucos minutos e só pode ser usada com o código gerado. As sessões contêm nomes de jogadores e UUIDs, por isso não partilhes a ligação.
Erros comuns
- Uma permissão não produz efeito. O jogador ainda é operador. Os operadores contornam o LuckPerms. Retira o
ope trabalha apenas com grupos. - Nó mal escrito. O LuckPerms aceita qualquer texto, incluindo erros de escrita. Verifica o nó na documentação do plugin em causa.
- Asterisco em
default. Um nó*no grupo predefinido dá acesso a tudo a qualquer convidado. Usa asteriscos apenas em grupos de moderação. - Alterações perdidas depois de reiniciar. Por predefinição, o LuckPerms guarda os dados num ficheiro H2 na pasta do plugin. Se não for possível escrever nessa pasta ao reiniciar, as alterações perdem-se. Basta olhares para a consola durante o arranque para veres o erro.
Localização dos dados e cópia de segurança
Todos os dados ficam em plugins/LuckPerms/. A cópia de segurança do painel inclui esta pasta. Para redes com vários servidores, o LuckPerms oferece uma base de dados MySQL partilhada; para um único servidor, o H2 continua a ser a opção mais simples.
Guias relacionados
Podes ver como instalar e atualizar plugins em geral em Instalar e gerir plugins. A proteção do mundo com regiões é explicada em WorldGuard: proteger regiões e as ferramentas de construção em WorldEdit: construir e desfazer.
Fontes
- Wiki do LuckPerms: https://luckperms.net/wiki/Home
- Referência de comandos: https://luckperms.net/wiki/Command-Usage
- Editor web: https://luckperms.net/wiki/Web-Editor
LuckPerms: ver exemplo
Gravações próprias de um ambiente de demonstração. A versão e a configuração mostradas podem diferir do teu servidor.