Dados do mundo do Minecraft danificados ou impossíveis de guardar: como resolver as mensagens

O mundo do teu servidor Minecraft é composto por muitos ficheiros: level.dat com os dados base, ficheiros de região com os chunks (secções do mundo de 16 × 16 blocos), dados dos jogadores e listas como ops.json. Se algo correr mal ao guardar ou se um ficheiro não for compatível com a versão do servidor, o servidor escreve uma mensagem no registo. Cada secção abaixo trata exatamente uma destas mensagens: o seu aspeto, o que está por trás dela e o que podes fazer. Primeiro surgem os erros em que o progresso do mundo se pode perder, depois os avisos em que o servidor normalmente continua a funcionar.

A mensagem completa, com as linhas anteriores, encontras na Consola ou em Ficheiros, em logs/latest.log. Antes de qualquer intervenção nos ficheiros do mundo ou de configuração, cria uma cópia em Cópias de segurança. O que for substituído na próxima gravação só consegues recuperar a partir de uma cópia de segurança.

Não foi possível guardar os dados do mundo

Este é o aspeto da mensagem:

Could not save data to raids_end.dat
java.nio.file.NoSuchFileException: ./<World>/DIM1/data/raids_end.dat
Failed to save level ./<World>

Uma terceira forma é Failed to save player data for <Player>.

O que está por trás disto: O servidor quis escrever dados do mundo, como o ficheiro principal do mundo, dados adicionais como raids ou os dados de um jogador. Faltava um ficheiro ou uma pasta que ele esperava encontrar. NoSuchFileException significa exatamente isso: o ficheiro não existe. Tudo o que aconteceu desde a última gravação bem-sucedida pode perder-se. Causas frequentes são o espaço de armazenamento cheio ou uma pasta do mundo que foi apagada, renomeada ou substituída por upload enquanto o servidor estava a funcionar.

Como resolver:

1. Verifica se o espaço de armazenamento do teu servidor está cheio. Se no registo aparecer também No space left on device, começa por libertar espaço (secção "Sem espaço de armazenamento livre").
2. Altera as pastas do mundo apenas com o servidor parado. Um upload ou uma eliminação com o servidor em funcionamento leva precisamente a esta mensagem.
3. Reinicia o servidor e introduz save-all na Consola. Assim forças a gravação. Se a mensagem deixar de aparecer, o problema está resolvido.
4. Se voltar a aparecer ou se faltarem construções, inventários ou progresso, restaura em Cópias de segurança um estado anterior ao erro.

Mais detalhes: Espaço de armazenamento cheio: resolver "No space left on device"

O mundo provém de uma versão mais recente do Minecraft

Este é o aspeto da mensagem:

java.lang.RuntimeException: Server attempted to load chunk saved with newer version of minecraft! 5023 > 4903

O que está por trás disto: Cada chunk, ou seja, cada secção do mundo de 16 × 16 blocos, guarda com que versão de dados foi escrito. O primeiro número é a versão de dados do chunk, o segundo a do teu servidor. Se o primeiro for maior, o mundo correu pela última vez numa versão do Minecraft mais recente do que a atual. Estes chunks não podem ser carregados. Continuar a jogar na versão mais antiga não é solução, pois um downgrade pode danificar o mundo.

Como resolver:

1. Pára o servidor.
2. Em Versão, volta a definir a versão do Minecraft com que o mundo correu pela última vez, ou uma mais recente.
3. Se carregaste o mundo por upload, usa a versão com que ele foi jogado pela última vez em modo de um jogador ou no servidor antigo.
4. Se realmente queres voltar à versão mais antiga, restaura em Cópias de segurança uma cópia anterior à mudança de versão e só depois define a versão antiga.

Bom saber: Os números não são números de versão como 1.21, mas versões de dados internas. Um número mais alto representa sempre uma versão mais recente. Mais informações: Mudar a versão do Minecraft e o modloader em segurança

O ficheiro principal do mundo (level.dat) está danificado

Este é o aspeto da mensagem:

Failed to load world data from ./<World>/level.dat

O que está por trás disto: O level.dat contém os dados base do teu mundo. Se o servidor não os conseguir ler, recorre à cópia de segurança level.dat_old. Se esta também estiver danificada, o servidor encerra e deixa de arrancar. Normalmente, o servidor foi terminado à força durante a gravação, ou um upload ficou incompleto.

Como resolver:

1. Pára o servidor, caso ainda esteja a correr.
2. Em Cópias de segurança, cria uma cópia do estado atual, mesmo que esteja defeituoso. Assim podes anular qualquer tentativa seguinte.
3. Em Cópias de segurança, restaura o mundo a partir de um estado anterior ao erro. Se queres manter o progresso mais recente, muitas vezes basta o level.dat isolado: tira-o de uma cópia de segurança descarregada e carrega-o em Ficheiros para a pasta do mundo.
4. Se foste tu a carregar o mundo por upload, volta a carregá-lo por completo e espera até o upload estar mesmo concluído.
5. Inicia o servidor e verifica na Consola se o mundo carrega.

Bom saber: Pára o servidor normalmente com stop na Consola, em vez de o terminar à força. É a melhor proteção contra esta mensagem. Sobre o upload: Carregar um mundo de Minecraft e mudá-lo em segurança

O mundo não é guardado: ficheiro de bloqueio session.lock ocupado

Este é o aspeto da mensagem:

Couldn't save chunk; already in use by another instance of Minecraft?
Failed to check session lock for world <World>

O que está por trás disto: O Minecraft cria na pasta do mundo o ficheiro session.lock. Indica que um servidor está neste momento a trabalhar com esse mundo. Se o servidor julgar que outro processo está a usar o mundo, deixa de guardar chunks. Normalmente, o ficheiro ficou para trás após uma falha ou um upload. O que foi construído desde a última gravação bem-sucedida pode perder-se no reinício.

Como resolver:

1. Pára o servidor.
2. Em Ficheiros, abre a pasta do mundo indicada na mensagem e apaga aí o ficheiro session.lock. Se o teu servidor tiver várias pastas de mundo, por exemplo para o Nether e o End, verifica também essas.
3. Reinicia o servidor.
4. Introduz save-all na Consola e verifica se a mensagem deixa de aparecer.

Bom saber: Se carregares um mundo por upload, podes simplesmente omitir o session.lock. O servidor volta a criar o ficheiro por si no arranque.

Sem espaço de armazenamento livre

Este é o aspeto da mensagem:

java.io.IOException: No space left on device

O que está por trás disto: O espaço de armazenamento do teu servidor está cheio. Todas as operações de escrita falham: o mundo deixa de ser guardado, os registos são interrompidos e não é possível criar novas cópias de segurança. Mesmo que o servidor pareça continuar a funcionar, as alterações perdem-se silenciosamente.

Como resolver:

1. Pára o servidor, para que não continue a escrever no mundo enquanto limpas.
2. Em Ficheiros, apaga primeiro o que se pode remover sem risco: ficheiros de registo antigos em logs/, relatórios de falhas já lidos em crash-reports/ e arquivos carregados (.zip, .tar.gz) cujo conteúdo já extraíste.
3. Limpa as cópias de segurança antigas de que já não precisas.
4. Não apagues ficheiros de região individuais do mundo para libertar espaço. Assim estarias a remover partes do teu mundo.
5. Inicia o servidor e verifica na Consola se a mensagem deixa de aparecer.
6. Se o armazenamento for constantemente escasso, escolhe um pacote maior em Definições e subscrição → Plano.

Mais detalhes: Espaço de armazenamento cheio: resolver "No space left on device"

„Detected unsafe terrain read during worldgen“: acesso inseguro durante a geração do mundo

Este é o aspeto da mensagem:

Detected unsafe terrain read during worldgen: reading from chunk [<x>, <z>] while generating chunk [<x>, <z>] (distance: 2, write radius: 1), step: minecraft:features, currently generating: ResourceKey[minecraft:worldgen/placed_feature / minecraft:sculk_patch_deep_dark]
Detected unsafe terrain read during worldgen: reading from chunk [<x>, <z>] while generating chunk [<x>, <z>] (distance: 2, write radius: 1), step: minecraft:features, currently generating: ResourceKey[minecraft:worldgen/placed_feature / wythers:vegetation/local/trees/dark_forest_river_oaks]

O que está por trás disto: Um passo da geração do mundo lê de um chunk vizinho fora do raio de escrita previsto. currently generating indica o conteúdo em causa: por exemplo, sculk do Vanilla ou uma árvore do Wythers. O servidor continua a funcionar; podem ocorrer picos de lag e, raramente, transições inconsistentes nos limites dos chunks. Os datapacks e mods de worldgen alteram a geração do mundo, mas também conteúdos do Vanilla podem desencadear a mensagem.

Como resolver:

1. Para o servidor e cria uma cópia de segurança em Cópias de segurança.
2. Atualiza o software de servidor que realmente utilizas, em Versão, para uma build atual da tua versão do Minecraft.
3. Atualiza os datapacks afetados em Ficheiros ou os mods em Mods, de forma correspondente.
4. Testa primeiro a desativação dos conteúdos de worldgen afetados com uma cópia do mundo, pois os mundos existentes podem precisar desses conteúdos.
5. Se a mensagem continuar a aparecer em massa, abre um ticket e indica a hora da mensagem.

Bom saber: Pré-gerar o mundo tira esse trabalho do decorrer do jogo: Chunky: pré-gerar o mundo de Minecraft

„JsonSyntaxException“: lista de whitelist, OP ou banimentos com erros

O que a mensagem mostra:

Unable to read file <File>.json, backing it up to <File>.json.backup and creating new copy.
Failed to load white-list:
com.google.gson.JsonSyntaxException: Expected entry to be a JsonObject, was "<Player>"

O que está por trás disto: whitelist.json, ops.json, banned-players.json e banned-ips.json usam JSON, um formato de texto com regras de estrutura rígidas. Além das vírgulas e das aspas, a estrutura também tem de estar correta: um simples nome de jogador não substitui uma entrada completa. Em "backing it up", o Minecraft guarda o ficheiro danificado como .backup e cria uma lista vazia; em "Failed to load white-list", deves verificar o ficheiro original. O servidor continua a funcionar, mas podem faltar entradas da whitelist, permissões de OP ou banimentos.

Como resolver:

1. Pára o servidor e faz uma cópia de segurança do ficheiro afetado, bem como de um eventual ficheiro .backup.
2. Em Ficheiros, abre o ficheiro .backup, se existir; caso contrário, abre o ficheiro original.
3. Corrige a estrutura: a lista fica entre parênteses retos, cada entrada entre chavetas; as vírgulas separam as entradas. Presta atenção à linha e à coluna, se forem indicadas.
4. Repõe a lista corrigida com o nome de ficheiro original e inicia o servidor.
5. Em alternativa, volta a adicionar as entradas através da Consola, por exemplo whitelist add <Player> ou op <Player>.

Bom saber: o Minecraft escreve o formato corretamente por si quando usas comandos: Configurar a whitelist.

„world gen settings file“ ilegível: valores predefinidos ativos

O que a mensagem mostra:

Unable to read or access the world gen settings file! Falling back to the default settings with a random world seed. ./<World>/data/minecraft/world_gen_settings.dat

O que está por trás disto: o ficheiro world_gen_settings.dat define como o mundo é gerado, por exemplo a seed e o tipo de mundo. Se o servidor não o conseguiu ler, arranca com valores predefinidos e uma seed aleatória; as tuas definições personalizadas não são aplicadas. As áreas já geradas são carregadas tal como foram guardadas. No entanto, as novas áreas são criadas com os valores predefinidos e podem não combinar com o resto.

Como resolver:

1. Se o mundo é novo e não definiste nada de especial, a mensagem normalmente não é crítica.
2. Se definiste uma seed ou um tipo de mundo próprios, guarda novamente esses valores em Definições e reinicia o servidor.
3. Se o ficheiro pertence a um mundo existente com construções, pára o servidor antes de serem geradas novas áreas e recupera o ficheiro ou o mundo a partir de uma cópia de segurança em Cópias de segurança.
4. Depois de reiniciares, verifica na Consola se a mensagem deixa de aparecer.

Bom saber: o procedimento para verificar e alterar a seed depende do software do servidor. Mais informações: Encontrar e definir a seed do mundo

„Unknown registry key“: blocos ou biomas desconhecidos no mundo

Como aparece a mensagem:

Recoverable errors when loading section […]: (Unknown registry key in ResourceKey[minecraft:root / minecraft:block]: <Mod>:<Bloco> -> using default)
Recoverable errors when loading section […]: (Unknown registry key in ResourceKey[minecraft:root / minecraft:block]: minecraft:<Bloco> -> using default)
Recoverable errors when loading section […]: (Unknown registry key in ResourceKey[minecraft:root / minecraft:worldgen/biome]: <Datapack>:<Bioma> -> using default)

O que está por trás: O servidor já não reconhece um bloco ou bioma guardado, normalmente depois de um mod ou datapack ter sido removido ou substituído. Uma versão mais antiga do Minecraft também pode tornar blocos desconhecidos. O Minecraft usa um valor de substituição: no caso de blocos desconhecidos é ar, no caso de biomas é um bioma predefinido. O servidor continua a carregar o resto do mundo; os blocos afetados desaparecem ou as atribuições de biomas mudam.

Como resolver:

1. Verifica a entrada a seguir a Unknown registry key: minecraft:block diz respeito a blocos, minecraft:worldgen/biome à atribuição da paisagem.
2. Se queres preservar os conteúdos, para o servidor e guarda o estado do mundo em Cópias de segurança. As áreas já carregadas podem ser guardadas ao parar.
3. Repõe a versão do mod, do datapack ou do Minecraft que usavas anteriormente. Encontras os mods em Mods e os datapacks em Ficheiros, na pasta datapacks do mundo.
4. Se as áreas afetadas já foram guardadas com valores de substituição, repõe também uma cópia de segurança anterior à alteração.

Bom saber: Se removeste os conteúdos de propósito, esta mensagem é esperada até as áreas afetadas serem guardadas novamente.

Uma entidade com erro foi removida para evitar uma falha

Este é o aspeto da mensagem:

Entity threw exception at minecraft:overworld:<x>,<y>,<z>
java.lang.NullPointerException

O que está por trás: Uma entidade é tudo o que se move no mundo ou transporta dados próprios: mobs, aldeões, NPCs, itens largados. No cálculo de um tick, um dos 20 passos de cálculo por segundo, uma delas provocou um erro. O Paper removeu-a para que o servidor não falhasse. O servidor continua a funcionar, mas a entidade nessa posição desapareceu. Normalmente, um plugin ou um mod alterou-a antes.

Como resolver:

1. Em Ficheiros, abre logs/latest.log e lê as linhas por baixo da mensagem. Este stacktrace é a lista dos pontos do programa que levaram ao erro.
2. O Paper escreve, no fim de muitas destas linhas, o nome do ficheiro entre parênteses retos, por exemplo ~[<Plugin>-<Versão>.jar:?]. Assim reconheces o plugin envolvido.
3. Atualiza esse plugin em Plugins ou o mod em Mods.
4. Se a mensagem se repetir na mesma posição, havia aí uma entidade danificada. Agora está removida e, normalmente, não são precisos mais passos.

Mais sobre erros de plugins: Plugin gera erros durante o funcionamento

Os dados POI não correspondem ao chunk

Este é o aspeto da mensagem:

POI data mismatch: never registered at BlockPos{x=<x>, y=<y>, z=<z>}

O que está por trás: POI significa Point of Interest (ponto de interesse). É assim que o Minecraft memoriza blocos especiais, como camas, postos de trabalho de aldeões, ninhos de abelhas ou portais do Nether. Estas entradas ficam guardadas separadamente dos blocos, na pasta poi do mundo. Na posição indicada, o Minecraft não encontrou nenhuma entrada correspondente. Mensagens isoladas podem surgir ao carregar ou após uma mudança de versão. Se a mesma zona aparecer repetidamente, os dados POI ou do chunk estão inconsistentes.

Como resolver:

1. Cria uma cópia de segurança do mundo em Cópias de segurança.
2. Atualiza o Paper em Versão para a build mais recente da tua versão do Minecraft.
3. Anota as coordenadas e observa se a mesma região é afetada repetidamente.
4. Só nesse caso deves verificar a região com uma ferramenta de mundos adequada, sempre numa cópia do mundo. Se não conseguires avançar, abre um ticket e indica a hora da mensagem.

Bom saber: Podes ignorar mensagens isoladas sem repetição. Sobre ferramentas e procedimentos: Chunks do Minecraft em falta: verificar danos e recuperar

Teletransporte invulgar de uma entidade entre mundos

Este é o aspeto da mensagem:

Illegal Entity Teleport Zombie['Zombie'/<ID>, l='ServerLevel[<Mundo>_nether]', x=<x>, y=<y>, z=<z>, …] to ServerLevel[<Mundo>]:(<x>, <y>, <z>)
java.lang.Throwable: null

O que está por trás: O Minecraft detetou que uma entidade, neste caso um zombie, foi teletransportada entre mundos ou chunks num estado inesperado, por exemplo através de um portal. As linhas com java.lang.Throwable por baixo não são uma falha. Mostram apenas de que ponto do programa veio o teletransporte. A mensagem, por si só, não prova um erro de plugin, e o servidor continua a funcionar.

Como resolver:

1. Atualiza o Paper em Versão para a build mais recente da tua versão do Minecraft.
2. Observa se a mensagem volta a aparecer. Podes ignorar uma mensagem isolada.
3. Se se repetir, lê o stacktrace completo em logs/latest.log. Se aparecer aí um plugin de portais ou de teletransporte, atualiza-o em Plugins.
4. Se a atualização não ajudar, desativa temporariamente, na configuração desse plugin, a função em causa e observa de novo.

Não foi possível guardar uma entidade

Este é o aspeto da mensagem:

Entity type entity.minecraft.villager failed to serialize
net.minecraft.ReportedException: Saving entity NBT

O que está por trás disto: Ao guardar, o servidor escreve cada entidade com os respetivos dados nos ficheiros do mundo. NBT é o formato de armazenamento que o Minecraft utiliza para isso. No caso de uma entidade, neste exemplo um aldeão, a operação falhou porque os dados dela contêm algo que o servidor não consegue escrever. Muitas vezes trata-se de um item de um plugin ou mod, por exemplo numa oferta de comércio. O servidor continua a funcionar, mas a entidade pode desaparecer após um reinício.

Como resolver:

1. Em logs/latest.log, lê as linhas abaixo da mensagem. Uma linha com Caused by indica a causa real.
2. Se envolver comerciantes, verifica os plugins que alteram ofertas de comércio, por exemplo plugins de loja ou de comerciantes, e atualiza-os em Plugins.
3. Mantém o Paper em Versão na build mais recente da tua versão do Minecraft.
4. Reinicia o servidor e observa se a mensagem volta a aparecer.

Bom saber: Se uma entidade importante desapareceu, só uma cópia de segurança a recupera. No entanto, isso repõe o mundo inteiro nesse estado.

Dados adicionais do mundo ilegíveis: valores predefinidos ativos

Este é o aspeto da mensagem:

Failed to parse saved data for 'SavedDataType[minecraft:<DataType>]': <Reason>

O que está por trás disto: Além dos chunks, um mundo guarda dados adicionais em ficheiros próprios, por exemplo regras de jogo, horas ou sequências aleatórias. Um desses ficheiros não é compatível com a versão do servidor. Normalmente, o mundo foi guardado antes com outra versão do Minecraft ou com uma seleção de mods diferente. O servidor arranca na mesma e usa valores predefinidos para essa parte. Por isso, as regras de jogo personalizadas podem voltar ao valor predefinido.

Como resolver:

1. Consulta na Consola as regras de jogo alteradas com gamerule <Rule>.
2. Define novamente os valores diferentes com gamerule <Rule> <Value>.
3. Nunca uses um mundo numa versão mais antiga do que aquela com que foi guardado pela última vez. Em Versão, volta a definir a versão adequada.
4. Se quiseres recuperar totalmente o estado anterior, em Cópias de segurança restaura uma cópia anterior à mudança.

Bom saber: O tipo de dados na mensagem mostra qual a área afetada. Sobre as regras de jogo: Regras de jogo do Minecraft explicadas

Dados de chunks danificados num ficheiro de região

Este é o aspeto da mensagem:

Chunk [<x>, <z>] header is truncated: expected <Number> but read <Number>
Ignoring absolute chunk [<x>, <z>] in regionfile …
Failed to parse light data for chunk [<x>, <z>] …

O que está por trás disto: O Minecraft guarda o mundo em ficheiros de região com a extensão .mca na pasta region. Cada um contém até 32 × 32 chunks. Uma parte desse ficheiro está incompleta ou está no sítio errado. O servidor tenta reparar o ficheiro ou recarrega o chunk afetado. Nesse processo, uma parte do mundo pode ser gerada de novo, juntamente com tudo o que lá estava construído. A causa é normalmente um encerramento forçado durante o processo de gravação.

Como resolver:

1. Anota as coordenadas do chunk da mensagem. Multiplicadas por 16, dão as coordenadas de bloco onde podes verificar no jogo.
2. Se estiver tudo lá, não é preciso fazer mais nada.
3. Se faltar uma parte do mundo, pára o servidor e restaura o ficheiro de região afetado a partir de uma cópia de segurança. O nome dele é r.<x>.<z>.mca, onde x e z são as coordenadas do chunk divididas por 32, arredondadas para baixo. Assim, a região volta ao estado da cópia de segurança.
4. No futuro, pára o servidor normalmente com stop em vez de o terminares à força.

Em detalhe: Chunks do Minecraft em falta: verificar danos e recuperar

Chunk numa coordenada errada

Este é o aspeto da mensagem:

Chunk file at <x>,<z> is in the wrong location; relocating.

O que está por trás disto: Num ficheiro de região, um chunk encontra-se numa coordenada diferente da que o Minecraft espera nesse ponto. O Minecraft move-o para o local correto e continua a carregar. No entanto, a mensagem indica dados do mundo danificados ou copiados incorretamente, por exemplo se ficheiros de região foram renomeados ou copiados de outro mundo.

Como resolver:

1. Pára o servidor e cria uma cópia de segurança do mundo em Cópias de segurança.
2. Se copiaste ou renomeaste ficheiros de região manualmente há pouco tempo, desfaz isso.
3. Verifica a região afetada com uma ferramenta de reparação de mundos, sempre numa cópia e nunca na única versão do teu mundo.
4. Se a mensagem aparecer repetidamente, em Cópias de segurança restaura uma cópia que saibas estar boa.

Bom saber: Uma única mensagem após um upload é um sinal de aviso, mas ainda não uma perda. Vê o local no jogo antes de restaurares seja o que for.

Em detalhe: Chunks do Minecraft em falta: verificar danos e recuperar

Cabeçalho danificado de um ficheiro de região a ser reparado

Este é o aspeto da mensagem:

Corrupt regionfile header detected! Attempting to re-calculate header offsets for regionfile <File>
Recalculating regionfile <File>, header gave erroneous offsets

O que está por trás disto: Cada ficheiro de região começa com um cabeçalho. É uma espécie de índice que regista em que posição do ficheiro está cada chunk. O Paper encontrou um cabeçalho danificado e reconstrói-o. Normalmente isto resulta sem perdas e o servidor continua a funcionar. A causa é muitas vezes uma interrupção forçada durante a escrita, por exemplo um crash ou um servidor terminado à força.

Como resolver:

1. Normalmente não é preciso fazer nada.
2. Se quiseres ter a certeza, vê a zona no jogo. O nome do ficheiro r.<x>.<z>.mca indica a localização: x e z multiplicados por 512 dão as coordenadas de bloco de um canto da região.
3. Se faltarem partes do mundo, pára o servidor e restaura o ficheiro de região afetado a partir de uma cópia de segurança.
4. No futuro, pára o servidor normalmente com stop na Consola em vez de o terminares à força.

Em detalhe: Chunks do Minecraft em falta: verificar danos e recuperar

“Invalid block entity”: Stored data does not match the block

What the message looks like:

Failed to create block entity <Block type> for block BlockPos{x=<x>, y=<y>, z=<z>} at position Block{<Block>}
Failed to create block entity naturesaura:aura_bloom
java.lang.IllegalStateException: Invalid block entity <BlockType> // <Class> state at BlockPos{x=<x>, y=<y>, z=<z>}, got Block{<Block>}

What's behind it: Some blocks carry additional data, a so-called BlockEntity: chests store their contents, signs their text, furnaces their progress. At the given position, this stored data doesn't match the block standing there. This can happen after updates, after world editing, for example with WorldEdit, or through inconsistent chunk data. Modded blocks such as naturesaura:aura_bloom can also be affected. Don't let the order confuse you: after for block comes the position, after at position the block.

How to fix it:

1. Create a world backup under Backups. Stop the server before changing files.
2. For Paper, update under Version within your Minecraft version. For Fabric or NeoForge, check for compatible updates to your server software and the affected mods.
3. Look at the given position in the game, but don't change the block blindly.
4. If the message repeats, remove the invalid block data with a suitable world tool or restore the region from a backup.

If you get stuck, open a ticket and include the time of the message.

Erro de alteração simultânea de dados de blocos

Como é a mensagem:

BlockEntity threw exception at <World>:<x>,<y>,<z>
java.util.ConcurrentModificationException

O que está por trás: Os blocos com dados próprios, como funis, fornalhas ou baús, chamam-se BlockEntity. Durante um tick, uma coleção desses dados foi alterada enquanto o servidor a estava a percorrer. O Java interrompe a operação com uma ConcurrentModificationException, literalmente um erro de alteração simultânea. A mensagem isolada não mostra com certeza se a alteração foi provocada pelo próprio jogo, pelo estado do mundo ou por um plugin.

Como resolver:

1. Atualiza o Paper em Versão e os teus plugins em Plugins.
2. Observa se a mensagem volta a aparecer.
3. Se se repetir, lê o stacktrace completo em logs/latest.log e anota a posição indicada.
4. Só uma classe de plugin mencionada aí, reconhecível pelo nome do pacote ou pelo nome do ficheiro de um plugin, permite fazer a associação. Atualiza então exatamente esse plugin ou comunica o erro ao respetivo programador.

Bom saber: Se não houver nenhum nome de plugin no stacktrace, não deves remover plugins por suspeita.

Item com propriedade inválida, por exemplo um encantamento desconhecido

Como é a mensagem:

[CraftMagicNumbers] Exception modifying ItemStack
… Not a valid resource location: …

O que está por trás: Um item proveniente da configuração de um plugin, de um kit ou de um menu tem uma propriedade que esta versão do Minecraft não consegue ler. Muitas vezes trata-se de um encantamento de um plugin que entretanto foi removido. Uma Resource Location é um nome no formato namespace:name, por exemplo minecraft:sharpness. O item é carregado sem a propriedade defeituosa. O servidor continua a funcionar, mas o item comporta-se de forma diferente do previsto.

Como resolver:

1. Descobre que plugin disponibiliza o item, por exemplo um plugin de kits, menus ou loja.
2. Em Ficheiros, abre a respetiva configuração na pasta plugins/<Plugin>/ e remove a propriedade indicada ou corrige o seu nome.
3. Em alternativa, recria o item, por exemplo criando-o de novo no jogo e guardando-o outra vez no plugin.
4. Se a propriedade pertencer a um plugin de encantamentos personalizados que removeste, volta a instalá-lo em Plugins.
5. Reinicia o servidor e verifica a Consola.

Saber mais: A configuração do plugin está com erros

O item guardado contém uma propriedade desconhecida

Como é a mensagem:

Tried to load invalid item: 'No component with type: '<namespace>:<property>'

O que está por trás: Os itens guardam as suas propriedades como componentes de dados, por exemplo nome, encantamentos ou durabilidade. Um item guardado, por exemplo nos dados de jogadores, em caixas ou nos dados de plugins, contém um componente que esta versão do Minecraft não conhece. É típico que o mundo ou os dados de plugins tenham sido criados com uma versão mais recente e depois carregados numa mais antiga. O item não pode então ser carregado corretamente e pode perder-se.

Como resolver:

1. Antes de fazeres mais alterações, cria uma cópia de segurança em Cópias de segurança.
2. Em Versão, define novamente a versão do Minecraft com que o mundo foi jogado pela última vez.
3. Se um plugin gerar estes itens, atualiza-o em Plugins para uma versão compatível com a versão do teu servidor.
4. Reinicia o servidor e verifica na Consola se a mensagem deixa de aparecer.

Bom saber: Se o nome começar por minecraft:, a propriedade provém de uma versão mais recente do Minecraft. Um nome diferente aponta para um plugin ou um mod. Saber mais: O plugin não é compatível com a versão do servidor

Item de mod guardado com campos obrigatórios em falta („No key … in MapLike“)

Este é o aspeto da mensagem:

Tried to load invalid item: 'No key <Field> in MapLike[<ItemData>]'

O que está por trás: Ao ler um item guardado, o software espera determinados campos obrigatórios. Pelo menos um deles está em falta nos dados do item. A mensagem indica com „No key“ o campo em falta; „MapLike“ designa a coleção de campos de dados lida. O item afetado não pode ser carregado por completo neste formato.

Como resolver:

1. Em Cópias de segurança, cria uma cópia de segurança do estado atual antes de alterares mods ou dados guardados.
2. Lê a mensagem completa na Consola ou em logs/latest.log, em Ficheiros. Procura o identificador do item e o mod correspondente.
3. Em Mods, compara a combinação instalada com o estado anterior à primeira ocorrência. Consulta as indicações do mod responsável sobre a migração de dados antigos de itens.
4. Testa primeiro uma combinação de mods adequada ou uma restauração numa cópia do mundo. Se nenhuma solução documentada servir, envia a mensagem completa ao autor do mod.

Bom saber: Apagar inventários ou dados de jogadores de forma generalizada remove também itens que ainda são utilizáveis.

As atualizações de blocos agendadas contêm identificadores de bloco desconhecidos

Este é o aspeto da mensagem:

Failed to read field (block_ticks=[<Data>]): Unknown registry key in ResourceKey[minecraft:root / minecraft:block]: <Mod>:<Block>

O que está por trás disto: Os block ticks são atualizações de blocos agendadas. Ao carregar esta lista, o servidor não encontra um identificador de bloco nela mencionado. Não consegue aplicar as atualizações afetadas. Por isso, compara o conjunto de mods atual com aquele com que o mundo foi guardado.

Como resolver:

1. Para o servidor e guarda o estado atual em Cópias de segurança. Mantém as cópias de segurança mais antigas que já existam.
2. Em Ficheiros, lê o identificador do bloco em logs/latest.log. A parte antes dos dois pontos ajuda-te a encontrar o mod correspondente.
3. Em Mods, verifica as versões instaladas e repõe o conjunto que corresponde ao mundo guardado.
4. Testa com uma cópia do mundo. Se os dados afetados já tiverem sido guardados novamente, usa uma cópia de segurança anterior à alteração.

O Forge indica itens, entidades ou blocos desconhecidos no mundo

Este é o aspeto da mensagem:

There are unidentified mappings in this world - we are going to attempt to process anyway
Unidentified mapping from registry minecraft:block
    <Mod>:<Block>: <Number>

O que está por trás disto: O Forge compara os identificadores de conteúdo guardados do mundo com os mods atualmente carregados. Para alguns identificadores falta a atribuição correspondente. O carregamento continua a ser tentado, mas os conteúdos afetados ficam em risco se estiverem em falta e o mundo for guardado novamente.

Como resolver:

1. Para o servidor. Guarda o estado atual em Cópias de segurança e não substituas nenhuma cópia de segurança anterior à alteração.
2. Na Consola, lê as entradas em „Unidentified mapping“. A parte antes dos dois pontos ajuda-te a identificar o mod afetado.
3. Em Mods, compara o conjunto com a versão do Modpack que pertence ao mundo e repõe os ficheiros adequados.
4. Testa primeiro com uma cópia do mundo. Se faltarem conteúdos depois de o mundo já ter sido guardado, usa uma cópia de segurança anterior à alteração.

O Anti-Xray falha na paleta de blocos de uma secção do mundo

Este é o aspeto da mensagem:

java.lang.IllegalArgumentException: Unexpected palette resize, bits = <Count>, added value = Block{<Block>}
    at io.papermc.paper.antixray.ChunkPacketBlockControllerAntiXray.obfuscate(<File>:<Line>)

O que está por trás: O Anti-Xray altera os dados dos blocos que o Paper envia aos jogadores, para que os minérios escondidos não fiquem diretamente visíveis. Neste caso, esse processamento falha na paleta de blocos, ou seja, a lista dos estados de bloco de uma secção do mundo. A tarefa em segundo plano afetada é interrompida; no jogador, a secção pode faltar ou aparecer com atraso.

Como resolver:

1. Em Cópias de segurança, cria uma cópia de segurança antes de alterares o software ou as definições.
2. Em Versão, verifica se está disponível uma build do Paper mais recente para a tua versão do Minecraft.
3. Se o erro persistir, verifica as definições do Anti-Xray em Ficheiros com base na documentação do Paper. Se a proteção for desativada temporariamente, os dados dos minérios voltam a ser transmitidos sem ocultação.
4. Guarda o rasto de erro completo de logs/latest.log e comunica-o à Paper. Não elimines a secção do mundo afetada como primeira tentativa de reparação.

Um bloco não consegue guardar os seus dados adicionais

Este é o aspeto da mensagem:

A BlockEntity type <BlockType> has thrown an exception trying to write state. It will not persist, Report this to the mod author

O que está por trás: Uma BlockEntity é um bloco com dados adicionais, por exemplo um inventário ou um estado interno. Ao converter esses dados para o formato de armazenamento, ocorre um erro. O servidor continua a funcionar, mas as alterações atuais deste bloco não são guardadas de forma permanente e desaparecem depois de um novo carregamento. A exceção logo abaixo descreve o valor inválido ou o erro técnico.

Como resolver:

1. Em Cópias de segurança, cria uma cópia de segurança antes de alterares o bloco afetado ou os mods.
2. Em logs/latest.log, lê a exceção completa e o rasto de erro que se segue, ou seja, a lista das chamadas de programa envolvidas.
3. Em Mods, verifica se existem atualizações adequadas para os mods envolvidos. Num Modpack, mantém as versões previstas.
4. Comunica o erro ao autor do mod, com o rasto de erro completo. Só edites os dados do mundo com um guia de reparação adequado e uma cópia de segurança disponível.

Os dados guardados das abelhas contêm indicações de tempo incompletas

Este é o aspeto da mensagem:

Failed to parse bees: 'No key min_ticks_in_hive in MapLike[<Dados>]; No key ticks_in_hive in MapLike[<Dados>]'

O que está por trás disto: Nos dados guardados das abelhas faltam indicações obrigatórias sobre o tempo passado na colmeia. Por isso, o Minecraft não consegue ler corretamente estas entradas. As abelhas deste conjunto de dados são as afetadas; a origem exata surge no contexto da mensagem.

Como resolver:

1. Cria uma cópia de segurança em Cópias de segurança antes de alterares blocos ou dados guardados.
2. Em Ficheiros, lê as linhas à volta em logs/latest.log e verifica se a mensagem surge após uma mudança de versão ou uma ação de um mod.
3. Acerta o jogo, os mods e os dados importados para versões compatíveis. Se for necessária uma reparação, trabalha de forma direcionada com uma cópia de segurança adequada e conserva o estado atual.

O bloco de mod guardado não tem um tipo de dados adicionais conhecido

Este é o aspeto da mensagem:

Skipping block entity with invalid type: "<Mod>:<Bloco>"
Failed to read field (id="<Mod>:<Bloco>"): Unknown registry key in ResourceKey[minecraft:root / minecraft:block_entity_type]: <Mod>:<Bloco>

O que está por trás disto: Um bloco tem dados adicionais guardados, por exemplo de uma máquina ou de um contentor. O tipo necessário para isso não está registado na seleção atual de mods. O Minecraft ignora a entrada, pelo que esta função do bloco falha e os respetivos dados guardados ficam em risco.

Como resolver:

1. Para o servidor e guarda o estado atual em Cópias de segurança.
2. Verifica em Mods e Modpack se o mod pertencente ao mundo está em falta ou foi trocado por outra versão. Repõe uma seleção compatível.
3. Só depois disso reinicia e verifica a Consola. Se os dados já tiverem sido substituídos, compara com uma cópia de segurança anterior adequada antes de restaurares de forma direcionada.

O item guardado contém dados no formato errado

Este é o aspeto da mensagem:

Tried to load invalid item: 'Not a string missed input: {"minecraft:item_name":<Dados>}'

O que está por trás disto: Um item guardado contém, numa posição de texto, um objeto de dados aninhado. O leitor da versão atual do Minecraft não consegue processar esta entrada assim. O afetado é o carregamento deste item; as linhas anteriores ajudam a determinar a sua origem.

Como resolver:

1. Cria uma cópia de segurança em Cópias de segurança antes de editares dados de itens ou do mundo.
2. Em Ficheiros, lê em logs/latest.log as linhas anteriores ao erro. Verifica se um mod, um ficheiro importado ou um comando criou o item.
3. Ajusta a origem ao formato de dados da tua versão do jogo. Verifica versões de mods compatíveis em Mods; se necessário, substitui os dados guardados de forma direcionada a partir de uma cópia de segurança adequada.

O Minecraft não consegue ler o nome de apresentação de uma entidade

O aspeto da mensagem:

Failed to parse entity custom name <Text>
com.google.gson.JsonParseException: Invalid color name: <Color>

O que está por trás disto: o Minecraft está a ler um nome de apresentação guardado de uma entidade. Para este nome, a versão afetada espera JSON, um formato de texto estruturado. Um texto simples com códigos de cor antigos ou um valor de cor inválido não pode ser aceite. O afetado é o nome de apresentação; a mensagem descreve um erro ao ler este campo de texto.

Como resolver:

1. Faz uma cópia de segurança do mundo em Cópias de segurança, antes de editares dados guardados.
2. Abre a mensagem na Consola ou em logs/latest.log. Distingue entre JSON com erros e uma indicação de cor inválida.
3. Verifica o plugin, o mod ou o modelo que gera o nome. Corrige aí o formato do texto de acordo com a versão do servidor e utiliza valores de cor válidos.
4. Atualiza uma extensão desatualizada em Plugins ou Mods. Depois, verifica se os nomes recém-gerados são carregados corretamente.

Bom saber: não elimines um ficheiro de mundo inteiro por causa de um nome com erros. Faz uma cópia de segurança dos dados existentes antes de uma correção direcionada.

O Minecraft não consegue carregar os dados guardados de uma entidade

O aspeto da mensagem:

Exception loading entity:
net.minecraft.ReportedException: Loading entity NBT

O que está por trás disto: o Minecraft não consegue carregar por completo os dados guardados de uma entidade. NBT é o formato de dados em que o Minecraft guarda, entre outras coisas, as propriedades das entidades. Ao processar estes dados, o jogo ou um mod envolvido lança um erro. O rasto de erro seguinte mostra qual etapa de processamento é afetada.

Como resolver:

1. Para o servidor e cria, em Cópias de segurança, uma cópia de segurança do estado atual, antes de alterares dados ou mods.
2. Em Ficheiros, lê o bloco de erro completo em logs/latest.log e um relatório correspondente em crash-reports/, se existir. Procura em especial por "Caused by", a mensagem de erro subjacente.
3. Verifica em Mods a compatibilidade de um mod aí mencionado com a Versão, o loader e as dependências necessárias.
4. Envia o relatório completo ao autor do mod, se a causa estiver no processamento de dados do mesmo. Edita ou remove os dados de mundo afetados só depois de um diagnóstico direcionado e com cópia de segurança.

A tua mensagem não está aqui?

Lê a mensagem completa em logs/latest.log, com as linhas anteriores: muitas vezes é aí que se vê o que correu mal primeiro. No stacktrace, os nomes de pacotes, ou seja, os nomes de pastas separados por pontos, como com.<Entwickler>.<Plugin>, e os nomes de ficheiros, como <Plugin>.jar, indicam que plugin ou mod está envolvido. Trabalha nos ficheiros do mundo apenas com o servidor parado e cria antes uma cópia em Cópias de segurança. Se não conseguires avançar, abre um ticket e indica a hora da mensagem.