Forge, NeoForge e Fabric são loaders de mods: ao iniciar, carregam todos os mods da pasta mods/ e verificam se são compatíveis entre si e com a versão do Minecraft. Se algo correr mal, surge uma mensagem no registo do servidor. Cada secção abaixo trata exatamente de uma dessas mensagens. Primeiro vêm os erros que impedem o arranque e, depois, os avisos em que o servidor continua a funcionar.
Encontras a mensagem completa na Consola ou em Ficheiros, em logs/latest.log; os relatórios de falha estão na pasta crash-reports/. Por baixo de muitas mensagens aparece um stacktrace: uma lista de pontos do programa que mostra onde o erro surgiu. Os nomes de pacotes e pastas aí indicados revelam frequentemente o mod envolvido. Antes de qualquer intervenção em ficheiros do mundo ou de configuração, cria uma cópia de segurança em Cópias de segurança.
Mods incompatíveis impedem o arranque („Incompatible mods found“)
Este é o aspeto da mensagem:
Incompatible mods found!
net.fabricmc.loader.impl.FormattedException: Some of your mods are incompatible with the game or each other!
- Install <Mod>, version <Version> or later.
O que está por trás disto: O mod loader verifica todos os mods antes do arranque e encontrou dependências em falta ou inadequadas. Uma dependência é outro mod de que um mod precisa para funcionar, muitas vezes uma biblioteca. O servidor não arranca assim. Logo abaixo da mensagem aparece o que falta ou o que está a causar problemas.
Como resolver:
- Na Consola ou em
logs/latest.log, lê as linhas abaixo deA potential solution has been determined. Install <Mod>, version <Version> or latersignifica: este mod está em falta ou é demasiado antigo. Instala-o em Mods, pelo menos nesta versão, compatível com a versão do Minecraft e o loader.Replace 'Minecraft' (minecraft) <Version> with any <Version> versionsignifica: um mod foi criado para outra versão do Minecraft. Obtém a edição dele para a tua versão ou remove-o. A versão do servidor em Versão só deves alterá-la se todos os mods forem compatíveis e apenas depois de fazeres uma cópia de segurança.- Se uma linha mencionar
'OpenJDK 64-Bit Server VM' (java), um mod exige outra versão do Java. Normalmente, também aqui ajuda a edição do mod para a tua versão do Minecraft.
Bom saber: Resolve a lista toda e só depois reinicia, assim poupas tentativas de arranque. Em detalhe: Configurar corretamente mods e modpacks de Minecraft.
O NeoForge interrompe o arranque („Couldn't find Minecraft server thread“)
Este é o aspeto da mensagem:
net.neoforged.fml.startup.FatalStartupException: Couldn't find Minecraft server thread. Startup likely failed.
at net.neoforged.fml.startup.Server.main(Server.java:23)
O que está por trás disto: Esta mensagem é uma consequência, não a causa. Um erro anterior de um mod ou do loader terminou o arranque antes de o NeoForge conseguir criar o servidor de Minecraft propriamente dito. Por isso, o servidor não arranca. A própria linha não indica nenhum mod; a pista está mais acima no log.
Como resolver:
- Em Ficheiros, abre o ficheiro
logs/latest.log. Se existir um relatório de falha, vê também o ficheiro mais recente emcrash-reports/. - A partir desta mensagem, sobe até à primeira linha com
Exception,ERRORouCaused by. A primeira é a decisiva; os erros seguintes costumam ser consequência dela. - Procura aí o nome do mod. Aparece na própria mensagem, como nome de ficheiro com
.jarou como nome de pacote no stacktrace abaixo. - Atualiza ou remove esse mod em Mods. Se ele exigir outra versão do NeoForge, define uma compatível em Versão.
- Reinicia o servidor e verifica se a mensagem desapareceu.
Bom saber: Se mais acima encontrares uma mensagem de outra secção deste artigo, resolve primeiro essa. A linha daqui desaparece por si.
Mod Fabric falha ao arrancar („Could not execute entrypoint stage“)
Este é o aspeto da mensagem:
Failed to start the minecraft server
java.lang.RuntimeException: Could not execute entrypoint stage 'main' due to errors, provided by '<mod-id>' at '<Class>'!
O que está por trás disto: Um entrypoint é o ponto em que o Fabric inicia o programa de um mod. O mod indicado em provided by falhou logo nesta fase inicial, por isso o servidor não arranca por completo. O motivo exato está nas linhas com Caused by: abaixo, muitas vezes uma dependência em falta ou uma versão inadequada.
Como resolver:
- Na Consola ou em
logs/latest.log, lê o nome depois deprovided by, por exemplogeyser-fabric. - Vê as linhas
Caused by:abaixo. Mostram se falta algo ou se algo não é compatível. - Atualiza o mod e as respetivas dependências em Mods, de acordo com a tua versão do Minecraft e do Fabric. Muitos mods Fabric precisam também da Fabric API.
- Se o erro surgiu logo após uma instalação, remove o mod a título de teste e reinicia. Se o servidor arrancar, o problema está nesse mod.
Bom saber: Fabric Loader e Fabric API: resolver erros de versão de forma direcionada explica como o Fabric Loader, a Fabric API e os mods se articulam.
Mod Fabric tem uma configuração Mixin inválida
Este é o aspeto da mensagem:
Error parsing or using Mixin config <mod-id>.mixins.json for mod <mod-id>
O que está por trás disto: Mixin é uma técnica com que os mods alteram, no arranque, pontos específicos do programa do Minecraft. Que pontos são esses está definido numa configuração Mixin dentro do ficheiro do mod. O Fabric não consegue ler ou aplicar esta configuração do mod indicado, e o arranque do servidor é interrompido. Em regra, o ficheiro do mod não corresponde exatamente à tua versão do Minecraft ou do Fabric Loader.
Como resolver:
- Na Consola ou em
logs/latest.log, lê o nome do mod depois defor mod. - Em Versão, verifica que versão do Minecraft o teu servidor usa.
- Substitui o mod em Mods pela edição disponibilizada exatamente para essa versão do Minecraft e para Fabric. Garante que o ficheiro antigo desaparece de
mods/. - Reinicia o servidor.
Bom saber: Mesmo pequenas diferenças de versão contam: um mod para outra subversão do Minecraft pode causar exatamente este erro, apesar de a versão principal ser a mesma.
O Forge interrompe o carregamento dos mods (LoaderException)
Este é o aspeto da mensagem:
net.minecraftforge.fml.common.LoaderException: <Reason>
O que está por trás disto: O Forge não conseguiu carregar um mod e interrompeu o arranque. As causas típicas são um mod que não é compatível com a versão do Minecraft ou do Forge, uma dependência em falta ou um valor inválido na configuração de um mod. Neste estado, o servidor não arranca. Este formato de mensagem aparece sobretudo em versões mais antigas do Forge, como as que muitos modpacks clássicos usam.
Como resolver:
- Na Consola ou em
logs/latest.log, lê as linhas logo abaixo da mensagem. Aí costumam estar o nome do mod e o motivo concreto. - Se acabaste de adicionar um mod, remove-o em Mods ou substitui-o pela versão para a tua versão do Minecraft e do Forge.
- Se o erro surgiu logo após uma alteração a um ficheiro na pasta
config/, desfaz essa alteração. - Reinicia o servidor.
Bom saber: Se as linhas indicarem um mod em falta, Plugin ou mod precisa de uma extensão em falta também ajuda.
O servidor não arranca: erro ao carregar os mods
Este é o aspeto da mensagem:
Failed to start the minecraft server
Missing or unsupported mandatory dependencies:
Mod ID: '<mod-id>', Requested by: '<Mod>', Expected range: '[<Version>,)', Actual version: '[MISSING]'
O que está por trás disto: O servidor interrompe o arranque porque falta um mod, está na versão errada ou falha ao carregar. Enquanto o erro existir, o servidor não está acessível. As linhas abaixo da mensagem indicam o mod e a versão exigida.
Como resolver:
- Na Consola ou em
logs/latest.log, lê as linhas abaixo da mensagem.Mod IDé o mod necessário,Requested byo mod que o exige eExpected rangea versão pedida. Actual version: '[MISSING]'significa: não instalado. Se aparecer um número de versão, a edição existente é demasiado antiga ou demasiado recente.- Instala a dependência em Mods na versão exigida ou remove o mod que a exige.
- Se a linha se referir a
forge,neoforgeouminecraft, a versão do loader ou do jogo não é compatível. Define-a corretamente em Versão ou Mudar software / loader. - Reinicia o servidor.
Bom saber: [<Version>,) significa „esta versão ou mais recente“. Se aparecer apenas Exception in thread "main" java.lang.reflect.InvocationTargetException, procura mais abaixo por Caused by:. Mais informações: Mudar o software e a versão do servidor no painel.
Forge: o ficheiro de mod ou de configuração (.toml) não é legível
Este é o aspeto da mensagem:
com.electronwill.nightconfig.core.io.ParsingException: Failed to parse data from Reader
O que está por trás disto: TOML é um formato de texto simples para definições (name = wert). Ao iniciar, o Forge lê a descrição de cada mod (mods.toml no ficheiro da mod) e todos os ficheiros de configuração .toml com a codificação de caracteres UTF-8. Se um ficheiro tiver outra codificação, por exemplo com tremas ou carateres chineses vindos de um editor do Windows, ou se tiver ficado danificado durante o carregamento, o Forge aborta antes de o mundo carregar. O servidor desliga-se então poucos segundos após o arranque. Muitas vezes a culpa é da última mod adicionada, sobretudo de uma que se destina apenas ao cliente do jogo.
Como resolver:
- Cria uma cópia de segurança em Cópias de segurança.
- Em Mods, remove a última mod adicionada e reinicia. Se o servidor arrancar, foi ela a causa. Instala então uma versão de servidor dessa mod ou outra versão.
- Se continuar a não arrancar, abre em Ficheiros o ficheiro
.tomleditado mais recentemente na pastaconfig/. Guarda-o novamente sem carateres especiais (UTF-8) ou apaga-o. O Forge volta a criá-lo com os valores predefinidos no próximo arranque, pelo que as tuas alterações nele se perdem. - Se não conseguires avançar, abre um ticket e indica a hora da mensagem e o nome da última mod instalada.
Bom saber: Como abrir e guardar ficheiros no painel está explicado em Editar ficheiros do servidor no painel e ligar por SFTP.
Não foi possível carregar a receita („Parsing error loading recipe“)
Este é o aspeto da mensagem:
Parsing error loading recipe <mod>:<rezept>: com.google.gson.JsonSyntaxException: Unknown item '<other-mod>:<item>'
O que está por trás disto: Uma receita refere-se a um item ou a um tipo de receita que não existe no modpack atual. Isto acontece muitas vezes após a atualização de uma mod ou quando falta uma extensão que a receita exige. O servidor continua a arrancar normalmente, apenas falta essa receita no jogo. Em modpacks grandes, estas linhas são frequentes, porque muitas mods trazem receitas para mods parceiras que nem sequer estão instaladas.
Como resolver:
- Lê a linha da esquerda para a direita: depois de
loading recipe, antes dos dois pontos, está a mod que traz a receita. Depois deUnknown itemestá o item em falta; a parte antes dos dois pontos é a mod a que pertence. - Se precisas do item ou da receita no jogo, verifica em Mods se a mod correspondente está em falta ou desatualizada.
- Instala-a ou atualiza-a de acordo com a tua versão de Minecraft e do loader e reinicia.
- Se não precisas da receita, podes ignorar a mensagem.
Bom saber: Se o motivo for No key id in …, a receita foi escrita para um formato de receitas mais antigo. Normalmente ajuda uma versão da mod para a tua versão de Minecraft.
Cobblemon: dados do jogador danificados
Este é o aspeto da mensagem:
.old File cobblemonplayerdata for [<UUID>] is corrupt or missing. Data is lost
.old File pokedex for [<UUID>] is corrupt or missing. Data is lost
O que está por trás disto: O Cobblemon guarda ficheiros próprios para cada jogador, por exemplo para a Pokédex, a equipa e os dados de spawn. Um deles está danificado, normalmente após uma falha durante a gravação, e a cópia de substituição com a extensão .old também está inutilizável ou em falta. Os dados do Cobblemon desse jogador perderam-se e o Cobblemon volta a criá-los. O servidor em si continua a funcionar.
Como resolver:
- Descobre quem é afetado: o ficheiro
usercache.jsonna pasta principal associa o UUID da mensagem a um nome de jogador. - Se os dados forem importantes, pára o servidor e restaura em Cópias de segurança uma cópia anterior ao incidente. Os dados encontram-se em
world/pokemonouworld/cobblemonplayerdata(worldé o nome predefinido da pasta do mundo). - Atenção: restaurar uma cópia de segurança completa repõe o mundo inteiro no estado dessa altura, incluindo tudo o que os outros jogadores construíram entretanto.
- No futuro, cria cópias de segurança regularmente, sobretudo antes de atualizações.
Bom saber: Se estas mensagens se repetirem, o servidor provavelmente falha com frequência. Procura então a causa em Saúde do servidor e em crash-reports/. Guia: Criar e restaurar uma cópia de segurança do servidor.
O ficheiro de dados de uma mod contém JSON inválido
Este é o aspeto da mensagem:
Couldn't parse data file <mod>:<name> from <mod>:recipes/<name>.json
com.google.gson.JsonParseException: com.google.gson.stream.MalformedJsonException: Unterminated object at line 9 column 40
O que está por trás disto: JSON é um formato de texto para dados com chavetas, aspas e vírgulas. Uma mod ou um datapack fornece um ficheiro de receita, de dados ou de configuração em que falta um carácter ou há um a mais. O Minecraft ignora esse conteúdo e o resto do servidor continua a funcionar.
Como resolver:
- Lê a primeira linha: a parte antes dos dois pontos a seguir a
fromindica a mod ou o datapack, e depois segue-se o caminho do ficheiro. - Se o ficheiro vier de uma mod, atualiza essa mod em Mods.
- Se editaste o ficheiro tu próprio, por exemplo num datapack teu em
world/datapacks/, abre-o em Ficheiros.lineecolumnindicam a linha e a coluna do erro. - É típico faltar uma vírgula ou haver uma chaveta por fechar. Se não encontrares o erro, volta a carregar o ficheiro original.
- Reinicia o servidor.
Bom saber: Unterminated object significa que, neste ponto, era esperada uma vírgula ou uma chaveta de fecho. Mais sobre datapacks: Erros de datapacks e resourcepacks.
Uma mod Forge contém um ficheiro de idioma inválido
Este é o aspeto da mensagem:
Skipped language file: <mod-id>:lang/en_us.json
com.google.gson.JsonSyntaxException: com.google.gson.stream.MalformedJsonException: Use JsonReader.setLenient(true) to accept malformed JSON at line 4 column 3 path $
O que está por trás disto: Os ficheiros de idioma contêm os textos de uma mod, por exemplo nomes de itens. O Forge não conseguiu ler um destes ficheiros JSON no ficheiro da mod (.jar) e ignorou-o. No stacktrace abaixo aparece LanguageHook, a parte do Forge que carrega ficheiros de idioma. O servidor continua a funcionar, apenas faltam no servidor os textos desse ficheiro.
Como resolver:
- Lê o ID da mod antes dos dois pontos a seguir a
Skipped language file:. Se esta linha não existir, usa a primeira mod mencionada na zona da mensagem. - Atualiza essa mod em Mods ou substitui-a por uma build para a mesma versão de Minecraft e de Forge. Uma build é uma versão já compilada da mod.
- Reinicia o servidor e verifica se a linha desapareceu.
Bom saber: A indicação Use JsonReader.setLenient(true) dirige-se aos programadores de mods, não podes definir nada com ela. O ficheiro está dentro do ficheiro da mod, por isso não compensa repará-lo tu próprio.
Falha no mixin de uma mod („Mixin apply for mod … failed“)
Este é o aspeto da mensagem:
Mixin apply for mod <mod-id> failed <mod-id>.mixins.json:<Class> from mod <mod-id> -> <Target-Class>:
org.spongepowered.asm.mixin.injection.throwables.InvalidInjectionException Critical injection failure: @Inject annotation on <Method> could not find any targets
O que está por trás disto: Através de mixins, as mods alteram certos pontos do programa Minecraft durante o arranque. A mod indicada procura um desses pontos, mas não o encontra. Normalmente a mod não é compatível com a versão de Minecraft, ou outra mod já alterou esse ponto. A função afetada da mod pode então não funcionar corretamente.
Como resolver:
- Lê o nome a seguir a
from mod. Essa é a mod cuja alteração falha. - Verifica na página da mod se existe uma versão para a tua versão do modpack ou do Minecraft e atualiza-a em Mods.
- Se pouco antes adicionaste outra mod que altera áreas semelhantes, por exemplo uma mod de desempenho, remove-a como teste e reinicia.
- Se o erro persistir, remove a mod ou comunica-o ao autor com a linha completa de
logs/latest.log.
Bom saber: Indicações como class_1799 ou m_77607_ são nomes internos de classes e métodos do Minecraft. Para ti, só interessa o nome da mod.
O Mixin não se aplica: os mods não são compatíveis entre si
Este é o aspeto da mensagem:
org.spongepowered.asm.mixin.injection.throwables.InvalidInjectionException: @At("INVOKE") on <Target> with priority 1000 cannot inject into <Target>
Mixin apply failed <mod-id>.mixins.json:<Class> -> <Target-Class>
O que está por trás: Um mod quer alterar um ponto através de um Mixin, ou seja, através de uma intervenção direcionada no programa do Minecraft. Nesta versão do mod ou do Minecraft, porém, não encontra o ponto esperado, muitas vezes porque um segundo mod já modificou precisamente esse local. Os mods envolvidos não são compatíveis entre si nestas versões.
Como resolver:
- Identifica os mods envolvidos: o nome do ficheiro Mixin (
<mod-id>.mixins.json) revela o primeiro. Se a linha contivermerged by, a seguir surge o ficheiro Mixin do segundo. - Cria uma cópia de segurança e atualiza em conjunto os mods indicados em Mods, de acordo com a tua versão do Minecraft e do loader.
- Se isso não ajudar, volta a uma versão de um dos dois que funcione com o outro. As páginas dos mods indicam muitas vezes incompatibilidades conhecidas.
- Reinicia o servidor e verifica na Consola se a mensagem desapareceu.
O Modlauncher do Forge entra em conflito ao iniciar (ConcurrentModificationException)
Este é o aspeto da mensagem:
Exception in thread "Thread-0" java.util.ConcurrentModificationException
at MC-BOOTSTRAP/cpw.mods.modlauncher@<Version>/cpw.mods.modlauncher.LaunchPluginHandler…
O que está por trás: O Modlauncher é a parte do Forge que carrega os mods e modifica as classes do Minecraft antes do arranque. Vários transformadores de mods, ou seja, componentes para essas modificações, alteraram em simultâneo a mesma lista interna, e o Java interrompe a operação. Isto aponta para coremods incompatíveis, isto é, mods que intervêm profundamente no loader, ou para um erro no próprio loader.
Como resolver:
- Cria uma cópia de segurança em Cópias de segurança.
- Atualiza o Forge e todos os coremods. No caso de um modpack já pronto, verifica primeiro em Modpack se existe uma versão mais recente, em vez de alterares o Forge isoladamente.
- Como teste, remove em Mods os mods de desempenho ou de Mixin adicionados mais recentemente e reinicia.
- Se o servidor voltar a arrancar sem problemas, volta a adicionar os mods um a um até descobrires o responsável.
Bom saber: Como se trata de acessos simultâneos, o erro não ocorre em todos os arranques. Se o servidor arrancar à segunda tentativa, a causa ainda assim não ficou resolvida.
O ficheiro de esquema de um mod tem metadados inválidos
Este é o aspeto da mensagem:
Couldn't deserialize schema file at <mod-id>:schemas/<name>.json because the json file has invalid schema metadata.
O que está por trás: Alguns mods descrevem conteúdos em ficheiros JSON próprios, os chamados ficheiros de esquema. Um ficheiro deste tipo do mod indicado não corresponde ao formato que o mod ou a sua biblioteca esperam e é ignorado. O servidor continua a funcionar, apenas falta o conteúdo desse ficheiro. Com frequência, o mod e o mod de biblioteca não são compatíveis entre si.
Como resolver:
- Lê o ID do mod antes dos dois pontos, a seguir a
schema file at. - Consulta o stacktrace abaixo para ver que outro mod está envolvido. Muitas vezes é uma biblioteca de que o mod precisa.
- Em Mods, coloca ambos em versões compatíveis entre si. A página do mod indica que versão da biblioteca ele espera.
- Se o ficheiro com erro estiver num datapack ou numa pasta criada por ti, podes removê-lo. Cria antes uma cópia de segurança.
- Reinicia o servidor.
YUNG's Better End Island: estado do mundo em falta
Este é o aspeto da mensagem:
key missing: bei_ExtraDragonFight in {BorderCenterX:0.0d,BorderCenterZ:0.0d,…}
O que está por trás: O mod YUNG's Better End Island cria nos dados do mundo uma entrada própria para o combate contra o dragão. De momento, não encontra essa entrada. Por isso usa um estado predefinido e volta a escrever a entrada na próxima gravação. Os restantes dados do mundo mantêm-se e o servidor continua a funcionar.
Como resolver:
- Verifica no jogo se a ilha do End e o combate contra o dragão funcionam normalmente. Se sim, basta um reinício limpo: pára o servidor normalmente e volta a iniciá-lo, sem o terminar à força.
- Se o estado do combate não estiver correto, atualiza o mod e a YUNG's API em Mods para versões compatíveis entre si.
- Cria uma cópia de segurança do mundo em Cópias de segurança.
- Só depois utiliza o comando oficial
/end_island reset. Antes, lê na página do mod o que ele repõe.
Bom saber: Se a mensagem aparecer uma vez e depois deixar de aparecer, o mod voltou a escrever a entrada. Consulta também Criar e restaurar uma cópia de segurança do servidor.
As propriedades de blocos de um mod não são legíveis
Este é o aspeto da mensagem:
Error while loading physics block properties entry: DataResult.Error['Not a JSON object: [{"selector":"<mod>:<block>","properties":{…}}]
O que está por trás: Um mod quis ler propriedades de determinados blocos, neste caso para a sua física, mas a entrada não tem a forma esperada. Not a JSON object seguido de um parêntese reto significa: o mod espera uma entrada entre chavetas, mas encontra uma lista. Normalmente, a indicação vem de uma configuração escrita para outra versão do mod. Os blocos afetados comportam-se então como blocos normais e o servidor continua a funcionar.
Como resolver:
- Identifica o mod: o responsável é o mod que lê as propriedades de física, não os mods cujos blocos constam da lista.
- Em Mods, coloca esse mod numa versão que corresponda ao teu modpack.
- Se alteraste tu mesmo a configuração dele, cria uma cópia de segurança, repõe o estado original de fábrica e depois aplica as tuas alterações uma a uma.
- Reinicia o servidor e verifica se a mensagem desapareceu.
A receita remete para um tipo de receita desconhecido
Este é o aspeto da mensagem:
Parsing error loading recipe <mod>:<rezept>: com.google.gson.JsonSyntaxException: Invalid or unsupported recipe type '<mod-id>:<recipe-type>'
O que está por trás: Um tipo de receita define como algo é fabricado, por exemplo na bancada de trabalho ou numa máquina de um mod. Esta receita usa um tipo que nenhum mod carregado conhece: o mod está em falta ou já não conhece o tipo na sua versão atual. O Minecraft ignora a receita e o servidor continua a funcionar.
Como resolver:
- Lê o ID do mod antes dos dois pontos em
recipe type '…'. Esse é o mod que deveria fornecer o tipo. - Se esse mod estiver em falta e precisares da receita, instala-o em Mods.
- Se já estiver instalado, coloca-o, bem como o mod ou o datapack com a receita, em versões compatíveis entre si.
- Se a receita vier de um datapack próprio em
world/datapacks/, podes removê-la aí. Depois, reinicia.
Bom saber: Se não te falta nada no jogo, a receita ignorada não afeta o funcionamento.
O mod Fabric refere-se a uma tag desconhecida
Este é o aspeto da mensagem:
Unknown tag: net.minecraft.class_<Number>@<Identifier>
O que está por trás: Uma tag é um grupo com nome de blocos, itens ou outros conteúdos, por exemplo „todos os troncos de madeira“. Os mods usam tags para reconhecer conteúdos de outros mods. Neste caso, um mod espera uma tag que esta versão do Minecraft ou do mod não criou. O conteúdo afetado pode faltar no jogo.
Como resolver:
- A própria linha não indica nenhum mod,
class_<Number>é um nome interno do Minecraft. Vê emlogs/latest.logas linhas à volta da mensagem. A primeira linha com o nome de um mod indica o causador. - Atualiza esse mod e a Fabric API em Mods para versões que sejam compatíveis com a tua versão do Minecraft e entre si.
- Reinicia o servidor e verifica se a mensagem desapareceu.
Bom saber: Como as versões se combinam, mostra-o Fabric Loader e Fabric API: resolver erros de versão de forma direcionada.
Não é possível carregar o plugin auxiliar de Mixin de um mod
Este é o aspeto da mensagem:
Error loading companion plugin class [<Class>] for mixin config [<mod-id>.mixins.json]
O que está por trás: Muitos mods controlam os seus Mixins, ou seja, as suas intervenções no programa do Minecraft, através de uma classe auxiliar. Ela decide quais as alterações que são aplicadas. Esta classe não pôde ser carregada, normalmente porque o mod não é compatível com outros mods ou com a tua versão. Algumas partes do mod podem, por isso, não funcionar.
Como resolver:
- Identifica o nome do mod pelo ficheiro Mixin (
<mod-id>.mixins.json). O nome do pacote da classe entre parênteses retos também contém normalmente o nome do mod. - Atualiza o mod em Mods de acordo com a versão do teu Modpack.
- Se a mensagem persistir, remove o mod a título de teste ou comunica o erro ao autor com a mensagem completa de
logs/latest.log. - Reinicia o servidor.
Bom saber: Se, depois do arranque, te faltar uma funcionalidade deste mod, esta mensagem é a explicação mais provável.
Arquivo (.zip, .rar, .7z) na pasta de mods
Este é o aspeto da mensagem:
Error for file:///home/container/mods/<File>.zip: java.nio.file.ProviderNotFoundException
O que está por trás: Na pasta mods/ encontra-se um arquivo compactado, por exemplo uma cópia de segurança da pasta ou um pacote descarregado. Os mods tentam ler cada ficheiro aí existente como se fosse um mod e comunicam um erro para o arquivo. /home/container/ é a pasta principal do teu servidor, tal como é mostrada em Ficheiros.
Como resolver:
- Em Ficheiros, abre a pasta
mods/. - Move o ficheiro indicado na mensagem para fora da pasta, por exemplo para a pasta principal. Se não precisares dele, podes apagá-lo.
- Se querias importar um Modpack completo, usa para isso a área Modpack.
- Reinicia o servidor.
Bom saber: Em mods/ só devem estar ficheiros de mods (.jar). Cria as cópias da pasta de preferência através de Cópias de segurança. Noções básicas: Instalar mods e plugins de Minecraft.
Referência a um tipo de entidade desconhecido
Este é o aspeto da mensagem:
Error: <mod-id>:<name> is not a valid entity ID!
Invalid or unknown entity type '<mod-id>:<name>'
O que está por trás: Entidade é o termo geral para mobs, animais e outros objetos móveis no mundo. Uma configuração, um datapack ou um comando indica um tipo de entidade, por exemplo ars_nouveau:wilden_hunter, que não existe neste servidor. O mod correspondente está em falta ou mudou o nome. A entrada é ignorada e o servidor continua a funcionar.
Como resolver:
- Lê a parte antes dos dois pontos: indica o mod a que a entidade pertence.
- Se este mod estiver em falta e a entidade deve existir no jogo, instala-o em Mods.
- Se removeste o mod de propósito ou a entidade entretanto mudou de nome, procura o nome nas configurações em
config/, nos datapacks emworld/datapacks/ou nas funções (ficheiros.mcfunction). - Cria uma cópia de segurança, corrige ou apaga a entrada e reinicia.
O mod está danificado ou não é compatível com a versão
Este é o aspeto da mensagem:
java.lang.VerifyError: <Details>
EntrypointException: Exception while loading entries for entrypoint '<Name>'
The mixin '<Class>' is missing an @Mixin annotation
O que está por trás: Um mod não se consegue carregar corretamente. O seu programa tem erros, foi criado para outra versão do Minecraft ou do loader, ou não é compatível com outro mod. Por trás desta mensagem há vários tipos de erro, por exemplo um VerifyError (o Java rejeita uma parte do programa carregada) ou um Entrypoint com falha, o ponto de arranque de um mod Fabric. A parte afetada falta e, no pior dos casos, o servidor não arranca.
Como resolver:
- Encontra o mod: aparece na própria mensagem ou como nome de pacote ou de pasta no stacktrace abaixo.
- Verifica se todos os mods pertencem à mesma versão do Minecraft e ao mesmo loader. Um mod Fabric não funciona sem mais em Forge ou NeoForge e vice-versa.
- Atualiza o mod em Mods ou remove-o a título de teste e reinicia.
- Se o servidor arrancar sem ele, procura uma versão adequada ou dispensa o mod.
Bom saber: Book … has use_resource_pack set to false diz respeito a manuais que funcionam através do mod Patchouli: o mod com o livro não é compatível com a versão instalada do Patchouli. Em detalhe: Configurar corretamente mods e modpacks de Minecraft.
Receita com demasiados fluidos como ingredientes
Este é o aspeto da mensagem:
Recipe has more fluid inputs (<Count>) than supported (<Count>).
O que está por trás: Uma receita de um datapack ou de uma integração de mods exige mais fluidos como ingrediente do que a máquina consegue processar nesta versão do mod. A receita é ignorada e o servidor continua a funcionar. Normalmente foi escrita para outra versão do mod com a máquina.
Como resolver:
- Vê em
logs/latest.logas linhas à volta da mensagem. Se aparecer um ID de receita no formato<mod>:<name>, a parte antes dos dois pontos indica de onde vem a receita. - Coloca o mod com a máquina e o mod ou datapack com a receita em Mods em versões compatíveis entre si.
- Se a receita vier de um datapack próprio, remove-a aí ou ajusta-a.
- Reinicia o servidor.
Bom saber: Se não precisares da receita, a mensagem não prejudica o servidor.
Slice and Dice: receita com demasiados fluidos
Este é o aspeto da mensagem:
java.lang.IllegalArgumentException: too many fluid ingredients
O que está por trás disto: O mod Slice and Dice converte automaticamente receitas de culinária de outros mods, por exemplo do Farmer's Delight, em receitas do Create. Pelo menos uma dessas receitas contém mais fluidos do que a conversão suporta. Por isso, algumas receitas convertidas podem não existir. O servidor continua a funcionar.
Como resolver:
- Verifica em Mods que versões do Slice and Dice, do Create e dos mods de culinária envolvidos estão instaladas.
- Atualiza-os para versões atuais e compatíveis entre si. Na página do Slice and Dice está indicado com que versões é compatível.
- Reinicia o servidor e verifica se a mensagem desapareceu.
Bom saber: Se, por causa disto, não te faltar nenhuma receita de que precises, podes ignorar a mensagem.
O Better Caves não consegue gerar corretamente as zonas de líquidos nas grutas
Este é o aspeto da mensagem:
Failed to fetch the AquiferContext.
This is a mod compatibility issue. Please report it to the Better Caves GitHub issue tracker!
O que está por trás: O YUNG's Better Caves precisa de dados adicionais da geração do mundo para as zonas subterrâneas de água e lava. Esses dados chamam-se AquiferContext e estão em falta no local pedido. A mod reporta um erro de compatibilidade; as zonas de líquidos recém-geradas podem, por isso, ter um aspeto incorreto. O servidor continua a funcionar.
Como resolver:
- Em Cópias de segurança, cria uma cópia de segurança do mundo antes de alterares a combinação de mods.
- Em Mods, verifica se o Better Caves e as bibliotecas necessárias são compatíveis com a tua versão do Minecraft e com o teu loader. Verifica também a compatibilidade de outras mods de geração de mundo.
- Testa primeiro uma combinação corrigida numa cópia do mundo e gera aí novas áreas.
- Se a mensagem continuar a aparecer, envia ao autor do Better Caves o ficheiro
logs/latest.logcompleto e a tua lista de mods. Indica também se foi feita uma pré-geração.
Bom saber: Alterar as mods não volta a gerar automaticamente as áreas já guardadas.
Curios: operação inválida numa definição de slot
Este é o aspeto da mensagem:
Parsing error loading curio slot <Mod>:<Slot>
java.lang.IllegalArgumentException: set is not a valid operation!
O que está por trás: O Curios gere espaços de equipamento adicionais, os chamados slots. Uma mod ou um pacote de dados fornece uma definição com uma operação que a tua versão do Curios não compreende. No exemplo, “set” é rejeitado. A definição em causa não é carregada corretamente; os respetivos espaços de equipamento podem, por isso, faltar ou estar mal configurados.
Como resolver:
- Na Consola ou em Ficheiros, em
logs/latest.log, lê o identificador completo a seguir a “curio slot”. - Verifica que mod ou pacote de dados fornece esta definição. Compara a versão do Curios que ela suporta com a versão instalada em Mods.
- Instala versões que sejam compatíveis entre si. Se editaste a definição tu próprio, corrige a operação de acordo com a documentação da tua versão do Curios.
- Reinicia o servidor e verifica se a mensagem desaparece e se os espaços de equipamento afetados voltam a funcionar.
Bom saber: Faz uma cópia de segurança das tuas alterações antes de substituíres mods ou pacotes de dados.
A tua mensagem não está aqui?
Lê a mensagem completa em logs/latest.log, incluindo as linhas anteriores: o primeiro erro costuma ser a causa e os seguintes são muitas vezes apenas consequências. Reconheces o mod envolvido pelos nomes de pastas e pacotes no stacktrace ou por um nome de ficheiro com .jar. Verifica se é compatível com a tua versão do Minecraft e do loader e cria uma cópia de segurança antes de qualquer alteração. Os erros que só ocorrem durante o jogo são tratados em Plugin ou mod gera erros durante o funcionamento. Se não conseguires avançar, abre um ticket e indica a hora da mensagem.