Guia do LuckPerms: grupos, ranks e comandos

Instale o LuckPerms e dê acesso a você mesmo

1. Baixe a build certa em luckperms.net: Bukkit para Paper e Spigot, ou a build Fabric, NeoForge ou Velocity para essas plataformas. Ela exige Java 11 ou mais recente, que todo servidor atual já tem.
2. Coloque o jar em plugins (ou em mods no Fabric e no NeoForge), remova qualquer outro plugin de permissões e reinicie o servidor por completo.
3. Dê acesso a você mesmo pelo console. No começo ninguém consegue usar os comandos do LuckPerms, nem você:

lp user YourName permission set luckperms.* true

A partir daí você pode usar /lp dentro do jogo. Na primeira inicialização o LuckPerms baixa algumas bibliotecas, então o servidor precisa de acesso à internet.

Grupos, herança, peso e tracks

• Os nós de permissão são as chaves, como essentials.home ou minecraft.command.gamemode. Cada um pode ser true, false ou não definido.
• Os grupos guardam permissões. Todo jogador está em default; os outros você adiciona.
• Herança: um grupo pode ter grupos pai e recebe tudo o que eles têm. Se admin herda de mod, e mod herda de default, os admins têm os três.
• O peso decide qual grupo vence quando dois discordam: ganha o número maior. Usar intervalos de 100 deixa espaço para grupos que você criar depois.
• Os tracks são escadas de promoção, como default → helper → mod → admin, usadas com promote e demote. Sozinhos, eles não alteram a herança.
• Os contextos limitam uma permissão a um servidor ou mundo, por exemplo com world=survival no final de um comando.

Uma configuração pronta de jogador, moderador e admin

Crie os grupos, encadeie-os e dê a cada um as permissões de que ele precisa. Os nomes de nós abaixo são de comandos do EssentialsX; troque pelos nós dos plugins que você usa.

lp creategroup mod
lp creategroup admin
lp group mod parent add default
lp group admin parent add mod
lp group mod setweight 100
lp group admin setweight 200

lp group default permission set essentials.home true
lp group default permission set essentials.sethome true
lp group default permission set essentials.spawn true
lp group default permission set essentials.tpa true
lp group default permission set essentials.tpaccept true
lp group default permission set essentials.msg true

lp group mod permission set essentials.kick true
lp group mod permission set essentials.mute true
lp group mod permission set essentials.tempban true

lp group admin permission set essentials.* true
lp group admin permission set luckperms.* true

lp user Steve parent add mod

Depois, um track para as promoções:

lp createtrack staff
lp track staff append default
lp track staff append mod
lp track staff append admin

lp user Steve promote staff sobe o Steve um degrau. A lista completa de comandos e nós do EssentialsX está no guia do EssentialsX.

Prefixos e ranks no chat

Defina um prefixo em um grupo:

lp group admin meta setprefix "&c[Admin] "

O LuckPerms armazena o prefixo, mas quem precisa exibi-lo é um plugin de chat. Instale o Vault e um plugin de chat que leia dele, como o EssentialsX Chat. Se um jogador tiver vários grupos, é usado o prefixo com a maior prioridade; defina-a com meta setprefix 100 "...".

O editor web do LuckPerms

Para mudanças maiores, o editor é mais fácil que os comandos. Execute /lp editor, abra o link que aparece e edite grupos, usuários e tracks no navegador. Ao salvar, o editor mostra um comando: execute-o no jogo ou no console e as mudanças são aplicadas. Nada muda no servidor até você executar esse comando.

Comandos do LuckPerms que você vai usar

Não sabe de qual nó um comando precisa? Execute /lp verbose record, use o comando como o jogador e depois /lp verbose upload: o relatório mostra todas as permissões que foram verificadas.

LuckPerms em um servidor ou rede da HytHost

• Instale enviando o jar para plugins pelo gerenciador de arquivos ou via SFTP e reinicie pelo painel. Execute o primeiro comando lp user ... luckperms.* na aba Console.
• Um único servidor: o armazenamento H2 padrão já basta.
• Uma rede: instale o LuckPerms no proxy e em cada backend, e aponte todos para o mesmo banco de dados MySQL com storage-method: mysql no config.yml. Todos os planos Minecraft da HytHost incluem bancos de dados MySQL; a configuração do próprio proxy está em como configurar um proxy Velocity.