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"

Acesso inseguro a chunks 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]

O que está por trás disto: Ao gerar um novo chunk, o servidor coloca elementos como árvores, minérios ou zonas de sculk. Cada elemento só pode ler numa pequena área à sua volta. A mensagem mostra que um deles foi além disso. Depois de currently generating aparece qual: minecraft: indica Vanilla, outro nome indica normalmente um datapack de worldgen (um datapack que altera a geração do mundo) ou um mod. O servidor continua a funcionar. Podem ocorrer picos de lag ao explorar e, raramente, transições imperfeitas nos limites dos chunks.

Como resolver:

  1. Atualiza o Paper ou o teu fork do Paper em Versão para a build mais recente da tua versão do Minecraft.
  2. Se depois de currently generating aparecer o nome de um datapack ou de um mod, atualiza esse datapack ou o mod em Mods.
  3. Se isso não ajudar, desativa-o para testar. Antes disso, cria uma cópia em Cópias de segurança, porque um mundo existente pode reagir mal à falta de conteúdos de worldgen.
  4. Se a mensagem continuar a aparecer em massa depois disso, abre um ticket e indica a hora da mensagem.

Bom saber: Quem gera o mundo previamente tira este trabalho do decorrer do jogo: Chunky: pré-gerar o mundo de Minecraft

A lista de whitelist, OP ou banimentos está danificada

Este é o aspeto da mensagem:

Unable to read file ops.json, backing it up to ops.json.backup and creating new copy.
com.google.gson.JsonSyntaxException: com.google.gson.stream.MalformedJsonException: … at line 21 column 2 path $

O que está por trás: whitelist.json, ops.json, banned-players.json e banned-ips.json são listas em formato JSON, um formato de texto rigoroso com parênteses, vírgulas e aspas. Basta faltar uma vírgula para o ficheiro ficar ilegível, normalmente depois de uma edição manual. O Minecraft guarda então o ficheiro danificado como .backup e cria uma lista vazia. O servidor continua a funcionar, mas, consoante o ficheiro, faltam permissões de OP, entradas da whitelist ou banimentos.

Como resolver:

  1. Pára o servidor.
  2. Em Ficheiros, abre o ficheiro com a extensão .backup, por exemplo ops.json.backup.
  3. A mensagem costuma indicar a linha e a coluna do erro. A lista inteira está entre parênteses retos, cada entrada entre chavetas, as entradas são separadas por uma vírgula e a última não leva nenhuma. Um simples nome de jogador sem chavetas não é uma entrada válida.
  4. Apaga o ficheiro vazio acabado de criar e renomeia o ficheiro .backup corrigido de volta, por exemplo para ops.json.
  5. Inicia o servidor. Em alternativa, podes voltar a registar as entradas por comando: whitelist add <Jogador> ou op <Jogador> na Consola.

Bom saber: Se geres estas listas apenas por comando, é o próprio Minecraft que escreve o formato. Mais informações: Configurar a whitelist

Definições do mundo ilegíveis: o servidor usa os valores predefinidos

Este é o aspeto da mensagem:

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

O que está por trás: O ficheiro world_gen_settings.dat guarda a forma como o mundo é gerado, como a seed e o tipo de mundo. Se o servidor não o conseguiu ler, arranca com os 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. As novas áreas, porém, são criadas com os valores predefinidos e podem não condizer com o resto.

Como resolver:

  1. Se o mundo é novo e não definiste nada de especial, a mensagem costuma ser inofensiva.
  2. Se definiste uma seed ou um tipo de mundo próprio, guarda de novo 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 reiniciar, verifica na Consola se a mensagem deixa de aparecer.

Bom saber: Com seed na Consola vês qual é a seed ativa neste momento. Mais informações: Encontrar e definir a seed do mundo

O mundo contém blocos de um mod ou datapack removido

Este é o aspeto da mensagem:

Recoverable errors when loading section [2, 11, 5]: (Unknown registry key in ResourceKey[minecraft:root / minecraft:block]: <mod>:<bloco> -> using default)

O que está por trás: Ao carregar uma secção do mundo, apareceram blocos ou objetos que o servidor já não conhece. Quase sempre foi removido ou substituído um mod ou um datapack. O nome antes dos dois pontos indica de onde vem o bloco. O Minecraft substitui esses locais por ar e carrega o resto do mundo normalmente. O servidor continua a funcionar, mas nos locais afetados faltam blocos.

Como resolver:

  1. Se removeste o mod ou o datapack de propósito, a mensagem é esperada. Deixa de aparecer assim que todas as áreas afetadas tiverem sido carregadas uma vez.
  2. Se faltam construções que queres manter, pára o servidor imediatamente e cria uma cópia de segurança em Cópias de segurança. Na próxima gravação, os blocos em falta desaparecem de forma permanente.
  3. Volta a instalar o mod em Mods na mesma versão, ou o datapack na pasta datapacks do mundo, e reinicia o servidor.
  4. Se continuarem a faltar blocos, as áreas já foram guardadas. Nesse caso, só ajuda uma cópia de segurança anterior à remoção.

Bom saber: Se antes dos dois pontos estiver minecraft:, o bloco costuma vir de uma versão do Minecraft mais recente do que a do teu servidor.

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

Os dados do bloco já não correspondem ao bloco no mundo

Este é o aspeto da mensagem:

Failed to create block entity <BlockType> for block BlockPos{x=<x>, y=<y>, z=<z>} at position Block{<Block>}

O que está por trás disto: Alguns blocos transportam dados adicionais, uma chamada BlockEntity: os baús guardam o conteúdo, as placas o texto, os fornos o progresso. Na posição indicada, esses dados guardados não correspondem ao bloco que lá está. Isto pode acontecer após atualizações, após uma edição do mundo, por exemplo com WorldEdit, ou devido a dados de chunks inconsistentes. Não te deixes confundir pela ordem: depois de for block está a posição e depois de at position está o bloco.

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. Vê a posição indicada no jogo, mas não alteres o bloco às cegas.
  4. Se a mensagem se repetir, remove os dados de bloco inválidos com uma ferramenta de mundo adequada ou restaura a região a partir de uma cópia de segurança.

Se não conseguires avançar, abre um ticket e indica a hora da mensagem.

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.

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.