Gerenciar quem pode fazer o quê no seu servidor é uma das tarefas administrativas mais importantes, e o LuckPerms se tornou o padrão da comunidade para isso. Este guia cobre a instalação e os conceitos básicos para começar a configurar cargos e permissões.
O que é o LuckPerms
LuckPerms é um plugin de gerenciamento de permissões que funciona como intermediário entre o servidor e outros plugins: em vez de cada plugin ter seu próprio sistema de cargos, todos consultam o LuckPerms para saber o que cada jogador pode ou não fazer.
Instalação
- Baixe o arquivo .jar do LuckPerms diretamente do Hangar ou site oficial
- Coloque o arquivo na pasta
pluginsdo seu servidor - Reinicie o servidor para o plugin carregar
- O LuckPerms vai gerar automaticamente sua pasta de configuração na primeira inicialização
Conceitos básicos: grupos e permissões
O LuckPerms organiza tudo em torno de grupos (como "default", "vip", "admin") e permissões (strings específicas que cada plugin reconhece, como essentials.fly ou worldguard.region.bypass). Cada jogador pertence a um ou mais grupos, e cada grupo tem um conjunto de permissões concedidas.
Comandos essenciais para começar
| Comando | O que faz |
|---|---|
/lp creategroup vip | Cria um novo grupo chamado "vip" |
/lp group vip permission set essentials.fly true | Concede a permissão de voar ao grupo vip |
/lp user Jogador parent add vip | Adiciona o jogador ao grupo vip |
/lp group vip parent add default | Faz o grupo vip herdar todas as permissões do grupo default |
Herança de grupos: economizando trabalho
Um dos recursos mais úteis do LuckPerms é a herança: em vez de configurar cada permissão do zero para cada cargo, você pode fazer um grupo "herdar" de outro. Por exemplo, o grupo "admin" pode herdar todas as permissões do grupo "vip", que por sua vez herda do "default" — assim você só precisa adicionar as permissões extras de cada nível.
Dica: use o painel web editor do LuckPerms (gerado com o comando /lp editor) para editar permissões visualmente em vez de digitar cada comando manualmente — é bem mais rápido para configurações complexas.
Descobrindo quais permissões cada plugin usa
Cada plugin documenta suas próprias permissões, geralmente na página do plugin no Hangar/SpigotMC ou no wiki oficial. Não existe uma lista universal, já que cada desenvolvedor define suas próprias strings de permissão.
Erros comuns ao configurar
- Esquecer de definir um grupo padrão: todo jogador novo precisa cair em algum grupo (geralmente "default") assim que entra no servidor
- Conflitos de herança: se um grupo nega uma permissão que outro grupo herdado concede, o LuckPerms segue uma ordem de prioridade que pode gerar resultados inesperados se não for bem entendida
- Não recarregar após mudanças manuais no arquivo: se você editar os arquivos de configuração diretamente, é preciso rodar
/lp reloadpara as mudanças terem efeito sem reiniciar o servidor