Voltar ao blog
Rangées de clés anciennes sur fond jaune, symbole des rangs et permissions gérés avec LuckPerms
Publicado em 19/10/2026

Tutorial LuckPerms: configure cargos e permissões passo a passo

O LuckPerms é o plugin de permissões mais usado em servidores de Minecraft com Spigot, Paper ou Purpur, mas os comandos costumam confundir no começo. Este tutorial leva você da instalação até uma hierarquia completa de Jogador, VIP, Moderador e Admin, com modelos para copiar e colar, o editor web e soluções para os problemas mais comuns.

O que o LuckPerms faz e o que ele não faz

O LuckPerms decide quem pode fazer o quê. Cada comando ou função de um plugin é protegido por uma permissão, uma string simples como essentials.fly. Uma permissão pode ser true (concedida), false (negada explicitamente) ou ficar indefinida, o que quase sempre equivale a uma negação.

Quatro conceitos bastam:

  • Grupo: um conjunto de permissões que você atribui aos jogadores. Um cargo é um grupo.
  • Herança (parent): um grupo pode herdar de outro. Se “admin” herda de “moderador”, recebe todas as permissões dele.
  • Peso (weight): um número que ordena os grupos. Quanto maior, maior a prioridade.
  • Contexto: uma condição, por exemplo world=world_nether para uma permissão que só vale no Nether.

O ponto que muitos guias esquecem: o LuckPerms guarda os prefixos, mas não os exibe. Para ver “[Admin]” antes de um nome no chat, você também precisa do Vault e de um plugin de formatação de chat, como o EssentialsX Chat. Veja mais abaixo.

Instalar o LuckPerms no Spigot, Paper ou Purpur

Em outubro de 2026, a versão atual é a 5.5.87 (série 5.5), compatível com Minecraft 1.8.9 até 26.3, segundo os metadados oficiais do projeto.

  1. Baixe a versão Bukkit na página oficial de downloads do LuckPerms. É ela que funciona no Spigot, Paper e Purpur.
  2. Inicie o servidor uma vez para criar a pasta plugins e envie o arquivo .jar para lá pelo gerenciador de arquivos do seu painel.
  3. Faça uma reinicialização completa (stop e iniciar de novo). Evite o /reload, que muitas vezes deixa os plugins instáveis.

Por padrão, o LuckPerms salva os dados em um banco H2 (o arquivo luckperms-h2-v2.mv.db, não apague). Se preferir arquivos legíveis, mude storage-method para yaml em plugins/LuckPerms/config.yml antes de criar os cargos. Para uma rede com vários servidores, use MySQL.

Passo 1: dar acesso total a você mesmo

Logo após a instalação, ninguém pode usar os comandos do LuckPerms, nem você. Abra o console do servidor (lá o comando vai sem barra):

lp user SeuNick permission set luckperms.* true

O curinga * concede todas as permissões que começam com luckperms.. Depois você pode continuar dentro do jogo com /lp.

Passo 2: planejar a hierarquia de cargos

Antes de digitar qualquer comando, defina sua estrutura. Esta é a que vamos montar:

CargoGrupoPesoHerda dePrefixo
Jogadordefault0nenhum&7[Jogador]
VIPvip10default&6[VIP]
Moderadormoderador50vip&9[Mod]
Adminadmin100moderador&c[Admin]

O grupo default já existe e todo jogador entra nele automaticamente. A documentação oficial não recomenda trocá-lo por outro grupo; se o nome incomoda, mude apenas o nome exibido com /lp group default setdisplayname Jogador.

Passo 3: criar os grupos e a herança

O comando creategroup aceita o peso como segundo argumento opcional:

/lp creategroup vip 10
/lp creategroup moderador 50
/lp creategroup admin 100

/lp group vip parent add default
/lp group moderador parent add vip
/lp group admin parent add moderador

A herança é recursiva: o admin recebe as permissões do moderador e, portanto, as do VIP e do jogador. Você nunca precisa repetir uma permissão em vários grupos. Em um grupo que já existe, o peso é ajustado com /lp group vip setweight 10.

Passo 4: modelos de cargos prontos para usar

Estes modelos usam as permissões do EssentialsX, o plugin de utilidades mais popular. Adapte-os aos seus próprios plugins: a documentação deles sempre lista as permissões disponíveis.

Jogador (grupo default)

/lp group default permission set essentials.spawn true
/lp group default permission set essentials.home true
/lp group default permission set essentials.sethome true
/lp group default permission set essentials.tpa true
/lp group default permission set essentials.tpaccept true
/lp group default permission set essentials.tpdeny true
/lp group default permission set essentials.msg true
/lp group default permission set essentials.balance true
/lp group default permission set essentials.pay true

VIP

O VIP ganha vantagens de conforto, nada que desequilibre o jogo:

/lp group vip permission set essentials.hat true
/lp group vip permission set essentials.workbench true
/lp group vip permission set essentials.back true
/lp group vip permission set essentials.nick true
/lp group vip permission set essentials.sethome.multiple true
/lp group vip permission set essentials.sethome.multiple.vip true

As duas últimas linhas liberam várias homes. A quantidade exata é definida na seção sethome-multiple do config.yml do EssentialsX (5 para “vip” na configuração padrão). As duas permissões são necessárias.

Moderador

/lp group moderador permission set essentials.kick true
/lp group moderador permission set essentials.mute true
/lp group moderador permission set essentials.tempban true
/lp group moderador permission set essentials.tp true
/lp group moderador permission set essentials.invsee true
/lp group moderador permission set essentials.vanish true
/lp group moderador permission set essentials.socialspy true

O moderador pode banir temporariamente, mas não de forma permanente: uma proteção simples contra erros e abusos.

Admin

/lp group admin permission set essentials.* true
/lp group admin permission set minecraft.command.* true
/lp group admin permission set luckperms.* true

Dê luckperms.* apenas a pessoas de total confiança: com ela, qualquer um pode se dar qualquer permissão. E nunca atribua a permissão global * a um cargo de moderação.

Bloquear uma permissão herdada

O valor false remove uma permissão herdada. Exemplo: VIPs podem voar em todo lugar, menos no Nether, graças a um contexto:

/lp group vip permission set essentials.fly true
/lp group vip permission set essentials.fly false world=world_nether

Passo 5: prefixos e exibição no chat

Adicione um prefixo a cada grupo. A prioridade (o primeiro número) define qual prefixo vence quando um jogador herda vários: o mais alto é usado. Usar o mesmo valor do peso deixa tudo mais claro.

/lp group default meta setprefix 0 "&7[Jogador] "
/lp group vip meta setprefix 10 "&6[VIP] "
/lp group moderador meta setprefix 50 "&9[Mod] "
/lp group admin meta setprefix 100 "&c[Admin] "

As aspas mantêm o espaço no final. setprefix substitui o prefixo existente no mesmo contexto, enquanto addprefix adiciona mais um.

Para os prefixos aparecerem de verdade, instale o Vault e um plugin de chat compatível com Vault: EssentialsX Chat se você já usa o EssentialsX, ou VaultChatFormatter para algo minimalista. Para a lista Tab e os nomes acima da cabeça, é preciso um plugin dedicado como o TAB.

Passo 6: dar cargos aos jogadores

# Adicionar um cargo (os outros continuam)
/lp user Steve parent add vip

# Substituir todos os cargos por um só
/lp user Steve parent set moderador

# VIP por 30 dias, removido automaticamente depois
/lp user Alex parent addtemp vip 30d

# Remover um cargo
/lp user Steve parent remove vip

As durações podem ser combinadas: 1mo3d12h significa um mês, três dias e doze horas. Para conferir, /lp user Steve info mostra os grupos, o grupo principal e o prefixo que os outros plugins realmente recebem.

Passo 7: uma track para promover a equipe

Uma track é uma escada ordenada de grupos. Ela evita tirar e colocar grupos na mão a cada promoção:

/lp createtrack equipe
/lp track equipe append moderador
/lp track equipe append admin

/lp user Steve promote equipe
/lp user Steve demote equipe

Se o Steve ainda não está em nenhum grupo da track, o promote o coloca no primeiro (moderador). A próxima promoção o torna admin e remove o grupo moderador automaticamente.

O atalho: o editor web /lp editor

Se os comandos parecem trabalhosos, o editor web faz tudo pelo navegador, com autocompletar de permissões:

  1. Digite /lp editor (ou /lp editor groups só para os grupos, /lp group vip editor para um único grupo).
  2. Clique no link recebido no chat ou no console.
  3. Adicione permissões no campo “Add Permission”; dá para colar várias de uma vez. Clique em um valor para editá-lo, ou em “Add Contexts” para limitá-lo a um mundo.
  4. Salve com “Save” ou Ctrl+S. O editor gera um comando /lp applyedits <código>: execute-o no servidor para aplicar as mudanças.

No editor, os cargos também podem ser geridos como nós: group.vip para um grupo pai, weight.10 para o peso, prefix.10.&6[VIP] para um prefixo, displayname.Jogador para um nome exibido. Nunca compartilhe publicamente o link de uma sessão: ele dá acesso aos seus dados de permissões.

Solução dos problemas mais comuns

“Não acho a permissão certa”

Use o modo verbose, o método mais confiável. Rode /lp verbose record Steve, peça ao Steve para executar o comando com problema e depois digite /lp verbose upload: você recebe a lista exata de permissões verificadas e o resultado de cada uma.

O prefixo não aparece no chat

Confira primeiro /lp user Steve info. Se o prefixo estiver lá, o LuckPerms está funcionando e o problema é na exibição: falta o Vault, ou o plugin de chat está ausente ou mal configurado. O comando /vault-info deve mostrar que os dados de chat vêm do LuckPerms.

Um jogador tem uma permissão que não deveria ter

Na maioria das vezes ele é operador (/op): OPs recebem automaticamente todas as permissões que um plugin reserva por padrão aos operadores. Tire o status com /deop e gerencie tudo pelo LuckPerms. Se não for isso, encontre a origem com /lp user Steve permission check essentials.fly.

Minhas alterações não são aplicadas

Se algo foi alterado fora do servidor (arquivos YAML editados à mão, banco de dados compartilhado), recarregue os dados com /lp sync.

Teste tudo em um servidor grátis

O LuckPerms quase não consome recursos. Você pode montar e testar toda a sua estrutura de cargos em um servidor de Minecraft grátis da MineServerGratis com Paper, Spigot ou Purpur antes de abri-lo para a sua comunidade.

Perguntas frequentes

O LuckPerms é gratuito?

Sim, o LuckPerms é gratuito e de código aberto em todas as plataformas suportadas.

Preciso do Vault para usar o LuckPerms?

Para as permissões em si, não. Sim, quando outro plugin (chat, economia, lista Tab) precisa ler grupos ou prefixos pelo Vault.

Como renomear o grupo default?

Ele não é renomeado: dê a ele um nome exibido com /lp group default setdisplayname Jogador, ou faça-o herdar de um grupo “membro” com /lp group default parent add membro.

Qual a diferença entre parent add e parent set?

parent add adiciona um grupo e mantém os outros; parent set remove todos os grupos existentes e deixa só o novo.

Dá para dar um cargo por tempo limitado?

Sim, com /lp user Nick parent addtemp vip 30d. O cargo some sozinho quando vence.