Início
» 🎮 Esportes eletrônicos
»
Erro de chave de registro desconhecida do Minecraft: Corrija incompatibilidades de dados do servidor e do mod
Erro de chave de registro desconhecida do Minecraft: Corrija incompatibilidades de dados do servidor e do mod
Erro de chave de registro desconhecida do Minecraft: Corrija incompatibilidades de dados do servidor e do mod
Para corrigir um erro de chave de registro desconhecida no Minecraft , identifique a chave exata no log e certifique-se de que o cliente, o servidor, o carregador de mods, os mods, os datapacks e o mundo salvo estejam usando dados compatíveis. Uma chave como essa examplemod:custom_blockpode ser uma pista: encontre qual mod ou pacote fornece esse namespace, restaure o conteúdo compatível correto e teste em uma cópia do mundo antes de alterar o jogo salvo.
A frase “Keys Unknown With Registries Send Server” (Chaves desconhecidas com registros do servidor) geralmente é uma descrição de pesquisa, e não uma mensagem de erro universal do Minecraft. Os logs podem reportar chaves desconhecidas durante a inicialização de um servidor, durante o carregamento de um mundo ou quando um cliente entra. Essas situações exigem verificações diferentes, portanto, comece analisando a linha de log exata em vez de excluir pastas de cache ou alterar configurações de rede irrelevantes.
O que significa uma chave de registro desconhecida?
Um registro é a tabela de consulta do Minecraft para dados do jogo, identificados por IDs com namespaces. Em `registry.json` namespace:path, a parte antes dos dois pontos aponta para um namespace de conteúdo; pode sugerir um mod ou pacote de dados, mas não prova qual arquivo é o responsável. A documentação do Fabric distingue registros de inicialização de registros dinâmicos, cujas entradas JSON vêm de pacotes de dados e são carregadas com um mundo. Ela também explica que um mod pode sincronizar os dados do registro quando um cliente entra. É por isso que o mesmo sintoma genérico pode vir de um mod ausente, um pacote incompatível ou dados específicos do mundo.
Aproveite o momento em que o erro aparece para identificar a causa:
Quando acontece
Primeiro lugar para investigar
O servidor para durante a inicialização.
Erros na lista de mods do servidor, no carregador e no carregamento de pacotes de dados
Apenas um jogador é desconectado ao entrar.
Versão do cliente, carregador, versão do pacote de mods e registro do cliente desse jogador.
Apenas um mundo mais antigo falha
Os datapacks ou conteúdo desse mundo provenientes de um mod que foi removido ou alterado.
Um mundo novo e mundos já existentes falham.
A instalação atual do servidor ou uma incompatibilidade de mods/carregadores compartilhados.
Como corrigir o erro de registro do Minecraft
1. Capture a chave completa e o primeiro erro relacionado.
Abra o log do cliente ou do servidor e copie a linha de erro completa, incluindo o tipo de registro e a chave com namespace. Para o Minecraft Launcher padrão, o Fabric documenta o log do cliente logs/latest.logdentro do diretório do jogo; launchers de terceiros podem manter um log separado para cada instância. No Windows, o diretório padrão geralmente é %appdata%\.minecraft`/etc/minecraft/`; macOS e Linux usam locais diferentes. Leia também algumas linhas antes do erro: a primeira falha de carregamento ou dependência ausente costuma ser mais útil do que mensagens subsequentes.
Anote se o erro aparece na inicialização do servidor, durante o carregamento do mundo ou apenas quando um cliente específico se conecta. Se ocorrer apenas com um jogador, colete o log desse cliente, bem como o log do servidor. A mensagem de desconexão exibida pode ser mais curta do que os detalhes registrados em qualquer um dos logs.
A chave com namespace é a pista útil nesta visualização de log de exemplo. Sua redação exata e sequência de log podem ser diferentes.
2. Verifique se as versões do software do cliente e do servidor são compatíveis.
Confirme se todos estão usando a versão do Minecraft Java Edition exigida pelo pacote de mods do servidor. Para um servidor com mods, verifique também o carregador (como Fabric, Forge ou NeoForge), a versão do pacote e a versão do jogo compatível com cada mod. Um cliente mais recente ou um mod criado para um carregador diferente não é automaticamente compatível. O guia de instalação de mods do Fabric menciona especificamente a versão do jogo, o carregador e a Java Edition como itens a serem verificados ao selecionar um mod.
Compare o pacote instalado no servidor com o perfil exato do cliente ou com a exportação do pacote de mods. Restaure as versões originais e as dependências necessárias do pacote em vez de atualizar apenas um dos lados. Alguns mods são exclusivos do cliente ou do servidor, portanto, não copie todos os arquivos JAR para ambas as pastas indiscriminadamente; siga as instruções do manifesto do pacote de mods ou as notas de instalação do autor do mod.
Compare o manifesto real do pacote em cada lado. Os números de versão e nomes de arquivo neste exemplo são apenas ilustrativos.
3. Rastreie o namespace até um mod ou pacote de dados.
Procure no log de inicialização pelo namespace correspondente à chave ausente. Busque pelo ID do mod correspondente na lista de mods carregados, por uma dependência com falha ou por um pacote de dados que foi instalado, removido ou atualizado recentemente. Se a chave começar com um namespace personalizado, verifique o mod ou pacote que contém esse conteúdo antes de modificar os arquivos originais do jogo. Uma entrada ausente também pode ser causada por um pacote cujos dados não correspondem mais à versão do Minecraft ou ao mod instalado.
Se você encontrar uma causa provável, pare o servidor antes de alterar os arquivos. Restaure o mod ou pacote de dados compatível esperado da mesma versão do pacote ou teste removendo temporariamente apenas o item suspeito de uma cópia separada. Altere um item por vez e reinicie para que você possa identificar qual alteração é relevante. Use uma fonte confiável e as notas de versão do próprio projeto ao substituir um mod.
Use o espaço de nomes para orientar a busca em arquivos de mods e datapacks; os exemplos de nomes aqui não identificam um mod realmente necessário.
4. Proteger o mundo e testar seus pacotes de dados
Se a falha se limitar a um mundo salvo, faça um backup antes de alterar os datapacks ou o conjunto de mods. Para um mundo Java de um jogador, a página de ajuda oficial do Minecraft explica a opção "Fazer backup" dentro do jogo . Para um servidor dedicado, desligue-o completamente e copie a pasta do mundo e os arquivos relevantes do servidor; não copie um mundo enquanto o servidor estiver gravando nele.
Execute uma cópia de teste com o pacote de dados ou mod suspeito restaurado, atualizado ou isolado. Você também pode iniciar um novo mundo temporário usando a mesma configuração do servidor. Se o novo mundo funcionar, mas o antigo não, concentre-se nos dados específicos do mundo e no histórico de pacotes daquele save. Não exclua playerdatao mundo ativo nem as pastas de "cache do registro". Remover um mod que fornecia blocos, entidades ou outros conteúdos salvos pode alterar o que o mundo carrega, portanto, mantenha um backup intacto e restaure o pacote de mods original, se necessário.
Mantenha o mundo original intacto durante os testes. Os nomes das pastas e a data mostrados são exemplos.
5. Teste novamente e compartilhe os registros úteis se o problema persistir.
Reinicie o servidor e o cliente com as versões corretas e repita a mesma ação de entrar ou carregar o mundo. Se o erro persistir, capture a mensagem atual latest.logde ambos os lados e qualquer relatório de falha. O guia de logs do Fabric explica onde o launcher padrão armazena os logs e como compartilhá-los para solucionar problemas. Inclua a versão do Minecraft, o loader e a versão, a versão do modpack, a chave completa que está faltando e se um novo mundo de teste funciona.
Antes de publicar registros publicamente, remova tokens de conta, endereços de servidores privados, endereços IP ou caminhos de arquivos pessoais. Um registro limpo e completo é mais útil do que uma captura de tela recortada, pois preserva o primeiro erro e o contexto ao seu redor.
Correções a evitar
Não considere a perda de pacotes como a causa padrão. A mensagem no registro do jogo por si só não comprova uma falha de rede; primeiro verifique quais dados do jogo estão faltando.
Não exclua pastas de registro ou cache aleatoriamente. Limpar o cache não restaura um mod, pacote de dados ou entrada de mundo ausente, e as pastas sugeridas não são uma solução universal para reparar o Minecraft.
Não altere server.propertiesopções irrelevantes. Configurações como a imposição de perfil seguro não fornecem definições de registro ausentes.
Não instale um mod aleatório de "sincronização de registro" como atalho. Use as versões exatas do carregador e do pacote de mods recomendadas pelo pacote do servidor.
Uma solução confiável começa com a chave de registro desconhecida completa , não com uma suposição sobre a configuração de cache ou rede. Identifique o software que fornece a chave, preserve a integridade dos dados e faça uma alteração controlada por vez.