Guia do LuckPerms: grupos, ranks e comandos

Instala o LuckPerms e dá acesso a ti próprio

1. Descarrega a build certa em luckperms.net: Bukkit para Paper e Spigot, ou a build Fabric, NeoForge ou Velocity para essas plataformas. Precisa de Java 11 ou mais recente, que qualquer servidor atual tem.
2. Coloca o jar em plugins (ou em mods no Fabric e no NeoForge), remove qualquer outro plugin de permissões e reinicia o servidor por completo.
3. Dá acesso a ti próprio a partir da consola. No início ninguém pode usar os comandos do LuckPerms, nem tu:

lp user YourName permission set luckperms.* true

A partir daí podes usar /lp no jogo. No primeiro arranque o LuckPerms descarrega algumas bibliotecas, por isso 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. Todos os jogadores estão em default; os restantes és tu que os acrescentas.
• Herança: um grupo pode ter grupos pai e recebe tudo o que eles têm. Se admin herdar de mod, e mod herdar de default, os administradores têm os três.
• O peso decide que grupo prevalece quando dois discordam: ganha o número mais alto. Saltos de 100 deixam espaço para grupos que acrescentes mais tarde.
• Os tracks são escadas de promoção, como default → helper → mod → admin, usadas com promote e demote. Sozinhos não alteram a herança.
• Os contextos limitam uma permissão a um servidor ou mundo, por exemplo com world=survival no fim de um comando.

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

Cria os grupos, encadeia-os e dá a cada um as permissões de que precisa. Os nomes de nós abaixo são de comandos do EssentialsX; troca-os pelos nós dos plugins que usas.

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

Define um prefixo num grupo:

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

O LuckPerms guarda o prefixo, mas é um plugin de chat que o tem de mostrar. Instala 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 prioridade mais alta; define-a com meta setprefix 100 "...".

O editor web do LuckPerms

Para alterações maiores, o editor é mais prático do que os comandos. Executa /lp editor, abre o link que aparece e edita grupos, utilizadores e tracks no browser. Quando guardas, o editor mostra um comando: executa-o no jogo ou na consola e as alterações são aplicadas. Nada muda no servidor até executares esse comando.

Comandos do LuckPerms que vais usar

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

LuckPerms num servidor ou rede da HytHost

• Instala-o carregando o jar para plugins no gestor de ficheiros ou por SFTP e reinicia a partir do painel. Executa o primeiro comando lp user ... luckperms.* no separador Console.
• Um só servidor: o armazenamento H2 predefinido chega.
• Uma rede: instala o LuckPerms no proxy e em cada backend, e aponta todos para a mesma base de dados MySQL com storage-method: mysql no config.yml. Todos os planos Minecraft da HytHost incluem bases de dados MySQL; a configuração do próprio proxy está explicada em como configurar um proxy Velocity.