Atualiza o LuckPerms com o arquivo da plataforma em que o plugin realmente está rodando. Um download para Velocity não deve ir para um servidor Paper. Antes, faz backup dos dados de permissões e da configuração e verifica depois da atualização, com uma conta de jogador normal, se os grupos e as permissões continuam funcionando como antes.
Identificar a plataforma e o local de armazenamento
Primeiro, anota onde o LuckPerms está instalado: no servidor Minecraft, no proxy ou em vários componentes. Verifica a plataforma iniciada e a versão no log. Não confies apenas no nome de arquivo de uma JAR enviada em algum momento.
Depois, verifica o armazenamento configurado para as permissões. Com um banco de dados externo, o conjunto de dados principal não fica necessariamente na pasta do plugin. Por isso, um simples backup de arquivos dessa pasta pode estar incompleto. Trata os dados de acesso da configuração como confidenciais e não os incluas em relatórios de erro públicos.
Consultar a plataforma e o armazenamento no jogo
Em vez de interpretar o nome do arquivo JAR, pergunta ao próprio plugin em execução. /lp info responde exatamente às três perguntas que importam antes de uma atualização:
- Plataforma — se o LuckPerms está rodando como variante Bukkit, Velocity, BungeeCord, Fabric ou NeoForge. Essa informação decide qual download precisas.
- Armazenamento — se os dados estão num arquivo H2 local ou num banco de dados externo, como MySQL. Só no primeiro caso um backup de arquivos da pasta do plugin é suficiente.
- Versão — a versão realmente carregada, contra a qual vais ler as notas de lançamento.
Anota os três valores antes de trocar qualquer coisa e repete a consulta depois da atualização. Se a plataforma ou o armazenamento forem diferentes depois disso, apanhaste o arquivo errado ou a configuração foi sobrescrita — assim percebes isso antes dos jogadores.
Backup antes da troca
Faz backup do arquivo atual do plugin, da configuração e do conjunto de dados de permissões realmente utilizado. Para os dados, usa um fluxo adequado de exportação ou backup de banco de dados e verifica se consegues ler a cópia de segurança novamente. Anota o horário e quais servidores ou proxies usam o mesmo conjunto de dados.
Para um pequeno teste, bastam exemplos documentados antes: um jogador normal sem permissões especiais, um membro de um grupo nomeado e uma conta com uma permissão adicional específica. Anota o comportamento esperado. Não concedas permissões wildcard globais nem permissões OP gerais para o teste; isso esconderia erros de permissão.
Atualização numa janela de manutenção
- Escolhe o download para a tua plataforma real pela página oficial do LuckPerms.
- Verifica os requisitos indicados ali e as observações sobre a mudança a partir da tua versão atual.
- Encerra corretamente o componente de servidor ou proxy afetado.
- Troca o arquivo do plugin; mantém a configuração e o armazenamento de dados, a menos que o guia concreto da atualização exija uma migração.
- Inicia o componente e verifica no log se há erros de carregamento ou armazenamento.
- Testa os casos de permissão documentados antes.
Ao atualizar vários componentes, faz isso de forma controlada e documenta as versões de cada um. Não transformes um novo build de proxy numa instrução genérica de upgrade para todos os servidores Minecraft.
Verificar o resultado
Não testes apenas com a tua conta de administrador. Verifica com um jogador comum se os comandos permitidos continuam funcionando e se as ações proibidas continuam sendo recusadas. Se usas permissões diferentes por servidor ou mundo, repete o teste exatamente nesses contextos.
Um início sem erros por si só não basta: o servidor pode estar acessível enquanto uma conexão ao banco de dados ou uma regra de permissão se comporta de modo diferente do esperado. Anota a plataforma, a versão do plugin, o resultado do teste e, se houver, a primeira mensagem de erro relevante.
Caminho seguro de retorno
Se surgirem permissões inesperadas, interrompe outras alterações administrativas e verifica primeiro o arquivo da plataforma e a conexão de armazenamento. Usa os dados salvos para um teste de restauração controlado. Não restaures às cegas um estado antigo do banco de dados se, entretanto, outros servidores gravaram alterações corretas no mesmo conjunto de dados.
FAQ
O arquivo publicado mais recentemente é sempre o certo?
Não. A plataforma, os requisitos e as notas de lançamento concretas precisam bater.
A pasta do plugin basta como backup?
Só se ela também contiver por completo o conjunto de dados realmente usado. Verifica a conexão de armazenamento.
Preciso recriar permissões depois de cada atualização?
Uma atualização regular não é motivo para reconstruir os teus grupos preventivamente. Verifica primeiro o conjunto de dados e as mensagens de erro.
Como descubro qual plataforma e qual armazenamento eu tenho?
/lp info mostra a plataforma, o tipo de armazenamento e a versão carregada do plugin em execução. Isso é mais confiável do que o nome de arquivo de uma JAR enviada em algum momento e também responde se um backup de arquivos da pasta do plugin é suficiente.
Preciso atualizar o proxy e o servidor Minecraft ao mesmo tempo?
Cada um precisa do arquivo da sua própria plataforma e, se ambos usam o mesmo conjunto de dados, as versões deles devem ser consideradas em conjunto. Atualiza de forma controlada, um após o outro, numa janela de manutenção, e documenta qual componente está rodando em qual versão.
Posso restaurar um estado antigo do banco de dados?
Só se, desde então, nenhum outro componente tiver gravado alterações corretas no mesmo conjunto de dados. Caso contrário, vais sobrescrever dados válidos com dados antigos. Verifica primeiro o arquivo da plataforma e a conexão de armazenamento — na maioria das vezes o erro está aí, não nos dados.