O LuckPerms gerencia o que cada jogador pode fazer no seu servidor de Minecraft. Para um pequeno grupo de amigos, muitas vezes basta um cargo para os comandos do dia a dia e um segundo para uma ajuda combinada com precisão. Um amigo não precisa de OP geral para, por exemplo, se teletransportar para casa. Quais permissões são necessárias depende do plugin que oferece o respectivo comando.
Este passo a passo configura dois cargos simples em um servidor Paper e os testa no jogo. Os exemplos com /home, /sethome e /kick pressupõem o EssentialsX; o próprio LuckPerms não cria essas funções. Os nomes dos grupos são livres, não são cargos prontos da MCF.
Verificado em: 7 de outubro de 2026. As capturas de tela mostram um teste de funcionamento anterior e não são uma nova verificação do seu servidor.
Diferenciar permissões de jogo e acesso ao painel
| Área de acesso | Para que serve |
|---|---|
| Grupo de jogo | Permissões dentro do servidor de Minecraft |
| Operador | Administração ampla do jogo; o comportamento também depende dos plugins |
| Conta do painel | Funções selecionadas do painel para uma conta MCF própria |
| Whitelist | Autorização de entrada no servidor, não as permissões de jogo posteriores |
No escopo Free verificado, você pode adicionar um coadministrador no painel. Esse limite não restringe os seus grupos de jogo do LuckPerms. Não dê aos amigos uma senha de proprietário compartilhada. Quem apenas joga não precisa de acesso ao console nem da permissão para trocar plugins. O convite é descrito em Minecraft com amigos.
Anote primeiro duas tarefas concretas: "todos os amigos podem usar um ponto de casa" e, se necessário, "uma pessoa responsável pode remover um jogador em caso de quebra de regra combinada". Se a segunda tarefa não for necessária, deixe o cargo de ajudante de fora.
Instalar o LuckPerms corretamente
Para o Paper, escolha a versão Bukkit/Paper do LuckPerms na área de plugins. Uma versão para Fabric ou proxy não pertence à pasta de plugins do Paper. Depois da instalação, reinicie o servidor de forma ordenada e confira no log de inicialização atual o nome do plugin carregado e possíveis erros. Não use um reload geral de plugins como substituto de uma inicialização limpa.
Comprovação histórica do chat após a entrada: Paper 1.21.4 com LuckPerms 5.5.71. Ela mostra a saída do plugin dessa combinação, que o /lp exibe no jogo sem argumentos; para as versões que você instalou, vale o log de inicialização atual.
Use o console do servidor como proprietário para a configuração. Nele, você escreve lp sem a barra inicial; no jogo, o mesmo comando começa com /lp. A visão geral de comandos do LuckPerms explica os nomes por plataforma e os argumentos. Antes de alterar algo, verifique se já existem grupos, permissões diretas de usuários ou um sistema de armazenamento externo. Faça backup dos dados reais; uma cópia da pasta do plugin sozinha não inclui um banco de dados externo.
Dois cargos com poucas funções
O exemplo a seguir vale para uma configuração nova e com backup, usando o EssentialsX. É uma divisão de tarefas sugerida, não uma recomendação para todos os servidores públicos. Execute os comandos depois de definir as funções realmente necessárias:
lp creategroup freund
lp group freund permission set essentials.home true
lp group freund permission set essentials.sethome true
lp creategroup helfer
lp group helfer permission set essentials.kick true
O cargo helfer contém aqui exatamente uma função administrativa adicional. Ele não precisa de luckperms.*, worldedit.* nem *. Uma permissão coletiva pode liberar funções que não têm nada a ver com a tarefa em questão. Por isso, não conceda curingas só para fazer uma mensagem de erro desaparecer.
Mantenha o grupo existente default. O LuckPerms o descreve na documentação dos grupos padrão. Para este grupo pequeno, os amigos citados são atribuídos explicitamente ao novo cargo; com isso, você não altera automaticamente as permissões de todas as contas que entrarem no futuro.
Um plugin pode permitir certas ações por padrão. Por isso, duas novas permissões positivas ainda não formam uma lista completa do que um jogador pode fazer no total. Verifique o ambiente existente e a visão geral de comandos e permissões do EssentialsX antes de presumir que um comando está bloqueado.
Complementar grupos existentes
Substitua SPIELERNAME pela conta prevista. Só execute a atribuição quando conseguir identificar com segurança a conta no painel ou em um teste de jogo próprio:
lp user SPIELERNAME parent info
lp user SPIELERNAME parent add freund
lp user SPIELERNAME parent add helfer
A última linha é destinada apenas ao ajudante combinado. Segundo a documentação do LuckPerms sobre grupos pai, parent add acrescenta às associações existentes. Já parent set remove os grupos existentes no contexto em questão. Não o use como substituto casual se quiser manter as outras associações.
Não monte uma grande hierarquia com vários cargos administrativos antes de saber qual tarefa adicional realmente existe. Anote, para o seu grupo, qual conta recebeu qual cargo e por quê. Isso torna uma remoção posterior compreensível.
Testar uma permissão e um limite
Verifique primeiro os valores calculados e depois as ações reais com uma conta normal própria, sem OP e sem permissões curinga amplas. O OP influencia as permissões padrão e o comportamento dos plugins; afirmar de forma generalizada que os operadores contornam toda verificação do LuckPerms seria, porém, incorreto. Para um teste compreensível, ainda assim é necessária uma conta sem OP e sem curinga:
lp user SPIELERNAME permission check essentials.home
lp user SPIELERNAME permission check essentials.kick
Os comandos de permissão mostram como o LuckPerms define, remove ou verifica um valor. Uma entrada removida diretamente ainda pode ser herdada de outro grupo. Contextos de mundo e outras fontes de permissão também podem influenciar o resultado.
No teste em conjunto, um amigo define um ponto de casa e usa /home. No comando administrativo, vocês verificam apenas com uma conta de teste própria e consentida se o ajudante consegue executar a função planejada e se um amigo comum não a recebe. Interrompa o teste se mais coisas estiverem liberadas do que o combinado e verifique a origem da permissão.
A imagem mostra a chamada rejeitada bukkit:plugins. Para esse comando, verifique a permissão bukkit.command.plugins; a imagem sozinha não prova a causa da rejeição. A chamada rejeitada é um único efeito observado. Ela não prova uma proteção completa das permissões. O que importa são as ações realmente permitidas e negadas nas suas contas.
Remover novamente o acesso de ajudante
Remova o cargo adicional da conta em questão:
lp user SPIELERNAME parent remove helfer
Depois, verifique novamente a permissão correspondente e a ação no jogo. Se ela continuar permitida, procure outro grupo, uma entrada direta ou outra fonte. Não apague todas as permissões do usuário de uma vez para resolver um único acesso. Se a mesma pessoa também era coadministradora do painel, remova esse acesso separadamente no painel.
Para uma reformulação maior, você pode usar o editor web do LuckPerms. O lp editor cria uma sessão de edição. Se possível, abra apenas o grupo ou o usuário necessário, salve a sessão no editor e execute no seu servidor o comando de aplicação gerado ali. Uma aba do navegador alterada, por si só, não atualiza as permissões do servidor. Confira as alterações antes de aplicá-las e não compartilhe links de sessão publicamente: eles podem conter permissões e dados de contas do seu grupo. Este fluxo simples não exige uma sessão de editor compartilhada publicamente nem um banco de dados adicional.
FAQ
Todo amigo precisa receber OP?
Não. Descubra as permissões concretas do plugin e teste-as com uma conta normal. O OP não é um substituto adequado para um permission node individual que está faltando.
Por que o home não funciona apesar da permissão positiva?
O LuckPerms não fornece o comando. Verifique se o EssentialsX está instalado corretamente e carregado, e se a mensagem de erro atual se refere a uma permissão, a um ponto de casa inexistente ou a outra configuração. O LuckPerms também aceita nomes de nodes escritos incorretamente; por isso, compare o node com a documentação do plugin e verifique a participação em grupos, os contextos e o resultado real com permission check.
Uma conta Free pode ter vários grupos de jogo?
O limite verificado de um coadministrador MCF se refere ao acesso ao painel. Ele não é um limite para grupos do LuckPerms. RAM, armazenamento e os demais limites Free continuam valendo.
Por que um amigo pode fazer mais do que o novo cargo permite?
Grupos existentes, entradas diretas, permissões padrão de plugins e outras fontes de permissão continuam valendo. Verifique a origem e a ação real; um novo grupo não define automaticamente todo o resto como proibido.
O parent add apaga meus grupos antigos?
Não, o comando acrescenta uma associação. O parent set tem outro efeito e pode remover grupos existentes no contexto indicado. Faça backup e leia primeiro o estado inicial.
Depois de remover o cargo, todas as permissões de administração somem?
Somente se nenhuma outra fonte continuar concedendo essas permissões. Verifique a conta de jogo novamente e, se necessário, remova o acesso separado ao painel. Apenas renomear um cargo não retira nenhuma permissão.
LuckPerms: ver exemplo
Gravações próprias de um ambiente de demonstração. A versão e a configuração mostradas podem diferir do teu servidor.
LuckPerms 5.5.71 · 2026-09-12
LuckPerms 5.5.71 · 2026-09-12