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.

Chat depois de entrar: o LuckPerms 5.5.71 está carregado, com o site e o autor (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.

Sem a permissão bukkit.command.plugins, o servidor indica 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 op e 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

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.

LuckPerms: Sem permissão, o comando de lista de plugins testado não está disponível.
Sem permissão, o comando de lista de plugins testado não está disponível.

LuckPerms 5.5.71 · 2026-09-12

LuckPerms: Depois da alteração de permissões, o mesmo comando mostra a lista de plugins.
Depois da alteração de permissões, o mesmo comando mostra a lista de plugins.

LuckPerms 5.5.71 · 2026-09-12