Este exemplo configura um grupo VIP em um servidor Paper com LuckPerms e EssentialsX. O LuckPerms controla permissões; o EssentialsX fornece o comando de voo usado no exemplo. Sem o plugin que implementa uma função, conceder a permissão não cria essa função.
1. Instale o plugin correto
Faça um backup, baixe a variante Bukkit/Paper no site oficial do LuckPerms, pare o servidor e coloque o arquivo JAR em plugins. Inicie e confira o console. Não use um JAR destinado somente a Velocity ou Fabric em Paper.
Os comandos abaixo são para o console, sem barra inicial. No chat do jogo, use /lp e uma conta autorizada. Substitua NomeDoJogador pelo nome real de uma conta de teste.
2. Crie um grupo e configure a herança
lp creategroup vip
lp group vip parent add default
lp group vip permission set essentials.fly true
lp user NomeDoJogador parent add vip
O grupo vip herda as permissões básicas de default e recebe a permissão de voo do EssentialsX. parent add adiciona um grupo sem remover os demais. Não troque por parent set se quiser preservar outros cargos.
LuckPerms já possui um grupo default para permissões padrão; não é necessário atribuí-lo manualmente a cada jogador novo. Configure nele somente o que todos devem poder fazer. Consulte a documentação de grupos padrão.
3. Verifique com uma conta sem OP
lp user NomeDoJogador permission check essentials.fly
lp user NomeDoJogador parent info
Confira se o jogador está no grupo VIP e se a checagem retorna a permissão esperada. Entre com uma conta de teste sem OP e execute /fly. Teste também com uma conta comum: ela deve seguir as permissões padrão configuradas. OP e permissões concedidas por outros grupos podem mascarar erros.
Se a checagem estiver correta mas o comando não existir, confirme que EssentialsX carregou sem erros. Se o resultado variar entre mundos ou servidores, investigue os contextos das permissões e da herança. Não conceda * como tentativa de correção.
4. Desfaça a alteração sem apagar outros cargos
lp user NomeDoJogador parent remove vip
lp group vip permission unset essentials.fly
O primeiro comando remove apenas o vínculo VIP daquele jogador. O segundo remove a permissão explícita do grupo, afetando todos os seus membros. Uma permissão pode continuar concedida por outra origem; repita a checagem para confirmar o resultado.
5. Use o editor para revisar configurações maiores
Execute lp editor, abra o endereço gerado, faça as alterações e salve. Execute no console o comando de aplicação fornecido pelo editor. Abrir ou editar a página sozinho não aplica as mudanças no servidor.
Trate o endereço da sessão como acesso administrativo e não o compartilhe publicamente. Confira os grupos e jogadores afetados antes de aplicar. O manual do editor explica o fluxo.
6. Evite os erros mais comuns
- Não dê
luckperms.*, OP ou permissões globais a cargos comuns. Use apenas os nós necessários e documentados pelos plugins. - Não suponha que todo plugin consulta LuckPerms: alguns recursos usam regras próprias ou exigem uma integração.
- Prefira comandos e editor para dados de permissões. Não edite arquivos internos nem bancos manualmente para ajustar cargos.
- Separe benefícios VIP de poderes de moderação. Um grupo pago não precisa herdar um cargo administrativo.
Consulte a documentação de uso para ampliar a configuração. Para planejar os cargos, veja o guia de ranks VIP e as boas práticas de moderação.