Como configurar LuckPerms no servidor Minecraft
LuckPerms é o padrão de permissões em servidores Paper. Este guia organiza instalação, hierarquia de grupos, prefixos no tab, herança segura e rotina de auditoria antes de abrir whitelist pública.
Instalação e storage
Baixe LuckPerms na versão estável compatível com sua build Paper. Coloque o jar em plugins/, inicie o servidor e aguarde log confirmar carregamento. Na primeira execução, LuckPerms cria config em plugins/LuckPerms/ e pergunta implicitamente qual backend usar via config.yml.
- Pare servidor antes de editar storage em produção.
- Para teste: storage H2 embutido, zero config externa, backup copiando pasta do plugin.
- Para comunidade real: MySQL com credencial dedicada, charset utf8mb4, backup diário junto ao mundo.
- Reinicie e execute
/lp infopara validar conexão.
Se você ainda está subindo o servidor, siga ordem lógica em como criar servidor Minecraft. Instale LuckPerms antes de plugins de proteção de terreno e economia: eles registram centenas de nodes na primeira boot.
Hospede em plano com backup automático como Minecraft Pro: banco LuckPerms corrompido sem snapshot vira pesadelo de permissão aleatória para centenas de jogadores.
Grupos, pesos e herança
Modelo mental: grupos são cargos, peso resolve conflito de prefixo, herança importa permissões de baixo para cima. Estrutura mínima saudável separa jogador, staff junior, staff senior e owner técnico.
| Grupo | Peso sugerido | Herda de |
|---|---|---|
| default | 10 | nenhum |
| vip | 20 | default |
| helper | 30 | default |
| mod | 40 | helper |
| admin | 50 | mod |
| owner | 100 | admin |
Comandos ilustrativos no console ou in game com permissão adequada:
lp creategroup helpercria grupo vazio.lp group helper setweight 30define precedência visual.lp group helper parent add defaultherda permissões base.lp group mod parent add helperevita duplicar nodes.
Evite lp group helper permission set * true. Wildcard destrói isolamento e é motivo número um de staff mal intencionado derrubar economia inteira em uma tarde.
Tracks para progressão
Tracks ligam grupos em trilha: jogador sobe de vip para vip_plus sem remover manualmente parent antigo. Útil em season pass e sistemas de grind. Documente trilha no wiki interno do staff para ninguém promover rank errado durante evento.
Prefixos, tab e chat
Meta prefix e suffix definem aparência no chat e no tab quando integrados via PlaceholderAPI. Exemplo conceitual: grupo vip recebe meta prefix com cor e tag curta; grupo mod recebe prefix distinto para jogadores identificarem staff instantaneamente.
- Instale PlaceholderAPI se tab ou chat plugin exigir placeholders dinâmicos.
- Defina meta:
lp group vip meta setprefix 20 "&a[VIP] "ajustando peso de prefixo. - Configure plugin de tab para ler
%luckperms_prefix%ou equivalente documentado. - Entre com conta teste em cada grupo e valide cor e ordem.
Whitelist e operadores vanilla convivem com LuckPerms, mas não substituem controle fino. Leia configurar whitelist e ops para camada de acesso antes do join. Lista de plugins que dependem de permissões está em plugins mais usados.
Comandos do dia a dia
Staff precisa de cola curta, não manual de trezentas páginas. Comandos abaixo cobrem oitenta por cento das operações em servidor survival ou hub brasileiro médio.
| Situação | Comando exemplo | Nota |
|---|---|---|
| Promover jogador a mod | lp user NICK parent add mod | Use nick exato ou UUID |
| VIP temporário 30d | lp user NICK parent addtemp vip 30d | Teste expiry com alt |
| Remover rank | lp user NICK parent remove vip | Não apaga permissões diretas |
| Permissão pontual | lp user NICK permission set plugin.node true | Prefira grupo quando repetir |
| Editor web | lp editor | Gera link temporário seguro |
| Export backup LP | lp export file backup.json | Guarde off site semanalmente |
/lp user NICK infomostra parents e permissões efetivas./lp group mod listmembersaudita staff ativo./lp verbose user NICKdepura node negado em tempo real.
Crie canal Discord interno só com cola de comandos aprovados pelo owner. Padronização evita helper inventar wildcard na pressa do ticket.
Loja VIP e auditoria
Monetização saudável depende de grupos LuckPerms espelhando pacotes da loja. Guia completo em monetizar servidor Minecraft. Webhook Tebex deve executar lp user {uuid} parent add vip ou variante temporária idêntica ao grupo configurado manualmente.
- Nomes de grupo idênticos entre LP, tab e loja.
- Teste compra real antes de anunciar VIP.
- Auditoria mensal: lp listgroups e membros de admin.
- Remova parent de ex staff no mesmo dia da saída.
- Export JSON LuckPerms antes de wipe de season.
Servidor estável reduz incidentes de banco corrompido. Para projetos pequenos, Minecraft Fácil basta; networks com proxy Velocity e vários subservidores podem precisar VPS Ryzen ou dedicado. Modpack usa linha modpack; Bedrock, Minecraft Bedrock. Integre alertas de compra com bot Discord e explore hospedagem Minecraft da StreetHosting. LuckPerms bem feito no dia zero evita tickets infinitos sobre terreno protegido e kit que não chega: permissão clara é experiência de jogador.
Perguntas frequentes
- LuckPerms funciona em Paper e Purpur?
- Sim. LuckPerms suporta forks Bukkit e Paper, além de Fabric e Forge em setups específicos. Para servidores Java com plugins tradicionais, Paper é o cenário mais comum e totalmente compatível.
- H2 ou MySQL para LuckPerms?
- H2 basta em teste local ou mundo descartável. Produção com staff, loja VIP e dezenas de plugins deve usar MySQL ou MariaDB com backup automatizado, especialmente se você reinicia instância com frequência.
- Como dar VIP temporário de trinta dias?
- Use permissão ou parent temporário com sintaxe de expiry do LuckPerms, por exemplo parent add vip por duração. Loja Tebex costuma emitir comando equivalente no webhook; teste expiração com conta secundária antes de vender.
- Prefixo não aparece no tab: o que checar?
- Confirme integração do plugin de tab com PlaceholderAPI, placeholder luckperms prefix, ordem de carregamento e se jogador possui parent com meta prefix definida. Reinicie tab após alterar meta e limpe cache do cliente se necessário.
Próximo passo
Criar servidor Minecraft
Planos simples para iniciantes, com ativação em 60s, AntiDDoS e suporte em português.
Guias relacionados
Como criar um servidor de Minecraft do zero (passo a passo)
Este guia organiza a criação de um servidor em ordem lógica: contratar recurso certo, subir o jar, aceitar EULA, apontar domínio, configurar mundo e convidar jogadores com segurança.
Como configurar whitelist e ops no servidor Minecraft
Whitelist e ops são duas camadas simples para controlar quem entra e quem administra o servidor. Este guia mostra um fluxo seguro para iniciantes.
Plugins Minecraft mais usados em servidores Paper: lista prática para começar bem
Este guia lista plugins que aparecem em quase todo servidor sério com Paper: permissões, utilidades, economia, edição de mundo, auditoria e placeholders. A ideia não é instalar tudo de uma vez, mas saber o papel de cada jar antes de poluir o servidor.