LuckPerms - Permissões Simples para Servidores Minecraft

Se você já tentou gerenciar um servidor Minecraft com jogadores constantemente perguntando "por que não consigo quebrar blocos?" ou "quando vou ganhar status de mod?", você sabe que sistemas de permissão são a espinha dorsal de qualquer servidor decente. LuckPerms cuida disso para você, transformando o caos de permissões em algo realmente gerenciável.

O Que Este Projeto Faz

Servidores Minecraft não são como mundos single-player onde você controla tudo. No momento em que você tem outras pessoas jogando, você precisa decidir quem pode construir, quem pode usar comandos de admin, quem pode vender itens em lojas e centenas de outras coisas. É aí que entram as permissões.

LuckPerms é um plugin que fica entre seus jogadores e os comandos que eles tentam executar. Em vez de editar manualmente arquivos infinitos de permissões ou usar ferramentas de UI desajeitadas, você define grupos (como "Moderador", "VIP", "Construtor"), atribui permissões a esses grupos e então coloca jogadores nos grupos corretos. Pronto.

Parece simples, mas a execução importa. LuckPerms faz isso rápido o suficiente para não causar lag, confiável o suficiente para que centenas de milhares de jogadores confiem nele, e flexível o suficiente para suportar tudo, desde pequenos servidores de sobrevivência até redes enormes com milhares de jogadores simultâneos. O projeto existe há anos e tem 2.253 estrelas no GitHub porque realmente resolve o problema bem.

Na verdade, deixa eu voltar um pouco. Se você está executando um pequeno servidor com lista branca com amigos, provavelmente não precisa disso. Mas se você está construindo algo real com ranks, moderadores e diferentes conjuntos de regras para diferentes tipos de jogadores, isso é exatamente o que você procura.

Por Que Você Usaria

Há alguns motivos pelos quais as pessoas acabam instalando LuckPerms.

Primeiro: você está crescendo. Começou com cinco amigos, mas agora tem 30 jogadores. De repente você precisa de mods que possam ajudar, construtores que possam colocar blocos mas não destruí-los, e VIPs que pagaram por benefícios cosméticos. Gerenciar tudo isso à mão é doloroso.

Segundo: você está executando uma rede. Talvez tenha um servidor de sobrevivência, um servidor criativo e uma arena PvP em diferentes máquinas, mas quer que os jogadores mantenham seu rank nos três. LuckPerms cuida disso através de bancos de dados compartilhados, então um sistema de configuração controla sua rede inteira.

Terceiro: você quer algo com o qual não tenha que lutar. Alguns plugins de permissões são notoriamente bugados ou lentos. Já vi servidores travarem apenas verificando permissões durante horas de pico. LuckPerms foi construído para evitar isso.

O plugin também permite que você use um editor web em vez de editar arquivos de configuração em um editor de texto. Sério, se você já bagunçou uma indentação YAML e se trancou de seu próprio servidor, você apreciará não ter que fazer isso toda vez que promove alguém.

Instalação e Configuração Básica

Colocar o LuckPerms em funcionamento depende do tipo de servidor que você está usando. O projeto suporta Bukkit, Spigot, Paper, Velocity, BungeeCord, Fabric e alguns outros. Para a configuração mais comum (servidor Paper), é isso que você faz:

1. Baixe o plugin JAR do site oficial
2. Coloque-o em sua pasta de plugins
3. Reinicie seu servidor
4. Execute os comandos de configuração inicial

/lp create default
/lp group default permission set essentials.home
/lp group default permission set essentials.sethome

Isso cria um grupo básico "default" que todos os jogadores entram automaticamente, e lhes dá permissão para usar comandos de home do Essentials.

Se você está em uma rede BungeeCord com vários servidores, você vai querer configurar um banco de dados compartilhado (MySQL ou PostgreSQL funcionam ambos) para que as permissões se sincronizem em todo seu proxy e todos os servidores conectados. A documentação explica bem a configuração do banco de dados.

Uma coisa a ter em mente após a instalação: certifique-se de que as outras configurações do seu servidor estão configuradas corretamente. O criador de MOTD pode ajudá-lo a configurar uma mensagem de servidor atraente, e o gerador de propriedades de servidor o poupa de ajustar manualmente cada configuração.

Principais Recursos Explicados

Nós de permissão são o fundamento. Um nó é apenas uma string de texto como essentials.home ou minecraft.command.say. Você atribui esses a grupos e eles cascata para os jogadores. Conceito simples, mas há poder real em como você pode organizá-los flexivelmente.

Grupos são onde o trabalho real acontece. Você cria "Moderador", "VIP", "Construtor", qualquer estrutura que faça sentido para seu servidor. Então você atribui permissões a esses grupos. Um VIP pode obter shop.discount mas não admin.ban. Um moderador obtém admin.ban mas não admin.restart. Cada grupo pode herdar de outros grupos, o que o impede de duplicar as mesmas permissões em cinco configurações de rank diferentes.

O editor web (geralmente em localhost:8080 enquanto você está configurando) permite que você crie grupos, adicione permissões e veja o que cada rank pode realmente fazer sem mergulhar em arquivos de configuração ou executar dezenas de comandos. Para mim, isso era muito mais intuitivo do que a linha de comando, especialmente ao aprender o sistema pela primeira vez.

As opções de armazenamento são flexíveis. Você pode armazenar permissões em um arquivo YAML (simples para pequenos servidores), um banco de dados SQLite, MySQL ou até MongoDB. Para qualquer coisa maior que um servidor único, usar um banco de dados torna sincronizar permissões entre vários servidores muito mais fácil.

A herança de permissão merece sua própria menção porque é inteligente. Se seu grupo "Helper" herda de "Member", então Helper obtém tudo que Member tem mais quaisquer extras que você defina. Isso é poderoso para servidores grandes com hierarquias de rank complexas.

Wildcards são outro recurso que economiza tempo. Em vez de listar essentials.home, essentials.sethome, essentials.teleport individualmente, você pode apenas atribuir essentials.* para dar acesso a todos os comandos Essentials. A maioria dos plugins suporta isso, embora você deva verificar os documentos para seus plugins específicos.

Armadilhas Comuns

Nós de permissão diferenciam maiúsculas de minúsculas. Já vi administradores passar uma hora se perguntando por que as permissões não funcionavam, apenas para descobrir que digitaram Essentials.home em vez de essentials.home. É irritante, mas também é consistente.

A ordem de herança também pode surpreendê-lo. Se você tem permissões sobrepostas (um grupo permite algo, outro nega), a ordem importa. Geralmente, negar tem precedência, mas você precisa pensar em sua hierarquia de grupo cuidadosamente.

Testar permissões antes de deixar os jogadores soltos é fácil de pular. Use /lp user [playername] permission check [node] para verificar se alguém realmente tem uma permissão antes que reclamem que está quebrada. Economiza tempo de depuração depois.

A compatibilidade do tipo de servidor importa. Um plugin Bukkit é diferente de um plugin proxy Velocity. Ambos usam LuckPerms, mas têm recursos e conjuntos de comandos ligeiramente diferentes. Certifique-se de estar baixando a versão correta para sua configuração.

O cache pode causar comportamento estranho se você não tiver cuidado. Se você editar permissões diretamente nos arquivos de configuração em vez de usar comandos, às vezes precisa executar /lp sync para recarregar tudo. Usar o editor web ou comandos evita esse problema inteiramente.

Alternativas

PermissionsEx era o padrão antigo antes que LuckPerms assumisse. Então funciona, mas é mais lento e não recebe tanto amor de manutenção. Se você já está usando, migrar para LuckPerms é possível.

GroupManager é outra opção, especialmente se você está executando um servidor Bukkit mais antigo. É mais simples, o que é bom para pequenos servidores, mas não escala tão bem quanto LuckPerms para redes maiores.

Há também algumas ferramentas de gerenciamento baseadas na web de terceiros que se conectam ao LuckPerms, mas honestamente, uma vez que você aprenda os comandos ou o editor web integrado, você realmente não precisa de uma ferramenta separada.