LuckPerms é o plugin de permissões com o qual defines, num servidor Paper ou Spigot, quem pode usar quais comandos. Sem um plugin de permissões, só existem dois níveis: operador com tudo e jogadores normais com quase nada. O LuckPerms coloca grupos no meio: 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 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ã vêm de um servidor de teste com Paper 1.21.4 e LuckPerms 5.5.71.

Instalação pelo 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 verificados contra os metadados do plugin antes de o ficheiro ir parar à pasta plugins/. O assistente de proteção de mundos na página do plugin instala o LuckPerms juntamente com o WorldGuard e o WorldEdit num só passo, se quiseres o pacote. Depois do reinício, o plugin apresenta-se ao entrar, com versão e autor.

Chat depois de entrar: LuckPerms 5.5.71 está carregado, com site e autor
Chat depois de entrar: LuckPerms 5.5.71 está carregado, com site e autor

A saída aparece quando introduces /luckperms ou, abreviado, /lp sem argumentos. É o teste mais rápido para saber se o plugin está mesmo a correr.

Como as permissões são estruturadas 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 worldedit.* cobre todos os nós de um plugin e é prático para a moderação, mas perigoso para jogadores normais.

O LuckPerms conhece três níveis:

  • Grupos juntam nós. O grupo default é atribuído automaticamente a todos os jogadores.
  • Jogadores herdam dos seus grupos e também podem ter nós próprios.
  • Contextos limitam 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 são executados na consola do servidor ou como operador no jogo:

/lp creategroup mod
/lp group mod permission set worldedit.* true
/lp group mod permission set essentials.kick true
/lp user Spielername parent add mod

A primeira linha cria o grupo. As duas linhas permission set dão-lhe o WorldEdit completo e o 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, vale a pena fazer o caminho inverso: remover 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 comunica um comando desconhecido
Sem a permissão bukkit.command.plugins, o servidor comunica um comando desconhecido
/lp group default permission set bukkit.command.plugins false

Isto não é uma medida de segurança no sentido estrito, mas mantém a lista de plugins longe de convidados curiosos.

O editor web

Para alterações maiores, a consola é pouco prática. /lp editor gera um link 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. O link é válido por poucos minutos e só pode ser usado com o código gerado. As sessões contêm nomes de jogadores e UUIDs, por isso não partilhes o link.

Erros típicos

  • Uma permissão não faz efeito. O jogador ainda é operador. Operadores contornam o LuckPerms. Remove o op e trabalha apenas com grupos.
  • Nó escrito incorretamente. O LuckPerms aceita qualquer texto, até erros de digitação. Verifica o nó na documentação do respetivo plugin.
  • Asterisco em default. Um nó * no grupo padrão dá tudo a todos os convidados. Usa asteriscos apenas em grupos de moderação.
  • Alterações perdidas após reiniciar. Por padrão, o LuckPerms guarda numa base de dados H2 na pasta do plugin. Se a pasta não puder ser escrita ao reiniciar, as alterações perdem-se. Um olhar para a consola durante o arranque mostra o erro.

Local de armazenamento e backup

Todos os dados ficam em plugins/LuckPerms/. O backup do painel inclui essa pasta. Para redes com vários servidores, o LuckPerms oferece uma base de dados MySQL partilhada; para um servidor individual, H2 continua a ser a escolha mais simples.

FAQ

Porque é que uma permissão removida não faz efeito em mim?

Porque és operador. Operadores contornam completamente o LuckPerms — todas as verificações dão positivo para eles. Remove o teu op e usa também uma grupo de moderação para ti, senão não estás a testar as tuas próprias regras em condições reais.

Preciso de uma base de dados MySQL para o LuckPerms?

Para um único servidor, não. Por padrão, o LuckPerms guarda numa base de dados H2 em plugins/LuckPerms/, que o backup do painel também inclui. MySQL só compensa quando vários servidores de uma rede devem partilhar os mesmos grupos e permissões.

Quantos grupos fazem sentido?

Dois a quatro chegam para a grande maioria dos servidores: default para todos, um grupo de construção e um grupo de moderação. Cadeias de herança profundas tornam difícil perceber de onde vem uma permissão — mantém a estrutura simples e atribui nós com asterisco apenas em grupos de moderação.

Como verifico se um jogador tem uma determinada permissão?

Com /lp user Spielername permission check knoten — a resposta indica o resultado e a origem, ou seja, se foi herdada de um grupo ou definida diretamente. /lp user Spielername info mostra todos os grupos do jogador de uma só vez.

O link do editor web é seguro?

É válido apenas por poucos minutos e não pode ser usado sem o código gerado. No entanto, a sessão contém nomes de jogadores e UUIDs do teu servidor — por isso não partilhes o link e gera antes um novo se estiveres inseguro.

Guias adicionais

Como instalar e atualizar plugins em geral está explicado em Instalar e gerir plugins. A proteção de mundos 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.

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

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