O Fabric Loader inicia mods Fabric; a Fabric API é uma biblioteca de mods adicional. Um novo Loader não substitui uma API em falta nem um ficheiro de mod para a versão errada do Minecraft. Num servidor Fabric na mcfreehost, verificas por isso primeiro o conjunto completo de versões e a mensagem de arranque concreta. Só depois alteras o componente afetado e testas com um cliente adequado.
Conteúdo verificado em: 7 de outubro de 2026. Este guia trata de Java com Fabric. Plugins Paper, ficheiros Forge/NeoForge e servidores Bedrock nativos são outros caminhos de software. Não é recomendada nenhuma versão específica do Loader como adequada a todos os packs.
Minecraft, Loader e API são três indicações diferentes
| Componente | O que determina | Onde o comparas |
|---|---|---|
| Minecraft | Versão do jogo e base de dados do mundo | Log de arranque do servidor e a instância de cliente efetivamente iniciada |
| Fabric Loader | O carregamento dos mods e a verificação dos requisitos declarados | Log de arranque, gestão de software e especificação do pack |
| Fabric API | Funções de biblioteca para mods que precisam delas | Ficheiro do mod na pasta mods e os metadados da sua transferência |
| Modpack e mods individuais | Conteúdos, dependências e lado necessário | Versão do pack, pacote de servidor, dados do ficheiro/projeto |
| Java | Ambiente de execução com que o Minecraft e os mods arrancam | Log de arranque/crash e requisito da versão de jogo escolhida |
Os três componentes têm de corresponder aos requisitos do teu pack. A versão mais recente de uma biblioteca não é um número de versão comum a todos os três.
Na instalação de mods, o Fabric explica que tens de verificar a versão do jogo, a família do Loader e a edição Java. Um ficheiro da Fabric API para outro ramo do Minecraft não se torna compatível só por ser renomeado. Do mesmo modo, colocar um mod Forge na pasta do Fabric não o transforma num mod Fabric.
1. Registar o conjunto de versões real
Antes de qualquer intervenção, anota estes dados para o servidor e a instância de cliente utilizada:
Minecraft: versão exata do jogo
Fabric Loader: versão efetivamente carregada
Fabric API: nome do ficheiro e versão publicada
Modpack: nome e versão concreta do pack
Java: ambiente de execução usado no log de arranque
Última alteração: o que mudou desde o último arranque bem-sucedido
Isto é um modelo para as tuas notas, não um conjunto de versões compatível já pronto. Especialmente com várias instâncias do launcher, não basta ter a versão certa instalada em algum lado: tens de iniciar exatamente essa instância. Uma atualização do launcher, uma versão do pack e uma atualização do Minecraft são alterações diferentes.
Num modpack pronto, começa pelo pacote de servidor documentado e pela versão de cliente prevista. Não atualizes cada mod individualmente para a "mais recente". A composição do pack pode usar intencionalmente um ficheiro mais antigo. Para a transferência e a entrada do cliente, ajuda o guia de entrada em modpacks.
2. Escolher o ficheiro de API e a página do mod certos
Abre a lista de ficheiros do projeto oficial Fabric API e filtra pela tua versão do Minecraft. Depois verifica se o ficheiro selecionado cumpre os requisitos do pack e dos mods afetados. A data de publicação por si só não responde a esta pergunta; uma publicação nova pode destinar-se a outro ramo do jogo.
Para cada outro ficheiro, verifica:
- Está publicado para Fabric e liberado para a tua versão do Minecraft?
- Pertence ao cliente, ao servidor dedicado ou a ambos os lados?
- Que bibliotecas adicionais exige exatamente esta versão?
- Ainda existe na pasta do servidor uma versão mais antiga do mesmo mod?
Um segundo ficheiro de API ao lado do antigo não é uma substituição limpa. Guarda o ficheiro anterior fora da pasta mods ativa antes de colocares a versão adequada. Um JAR renomeado arbitrariamente ainda pode ser carregado; remove mesmo o ficheiro ativo antigo dessa pasta.
Mods puramente gráficos ou de interface muitas vezes só são necessários no cliente. Por isso, não copies a pasta inteira do cliente para o servidor sem verificar. Os metadados de mods Fabric distinguem os ambientes client, server e *. As indicações do projeto ou do pacote de servidor continuam a ser decisivas; um mod declarado incorretamente pode, ainda assim, falhar só mais tarde.
3. Ler a mensagem corretamente
Abre a saída de arranque na gestão do servidor. Se a falha começar com uma lista de dependências como Incompatible mods found!, regista: que mod, que requisito e que versão existente são indicados.
| Observação | Significado | Próximo passo direcionado |
|---|---|---|
| Falta um mod necessário | Uma dependência obrigatória não está cumprida | Obter a biblioteca em falta para o mesmo ramo do Minecraft |
| A API existente é demasiado antiga | O mod exige outra versão ou intervalo de versões da API | Escolher um ficheiro de API liberado para isso; substituir a versão ativa antiga |
| Um mod exige outra versão do Minecraft | O ficheiro de mod transferido não corresponde ao ramo do jogo | Procurar a versão adequada do mod; não atualizar às cegas o mundo existente por causa disso |
| O Loader não cumpre o requisito | A versão carregada do Loader não corresponde à especificação do pack | Preparar a troca de Loader como alteração do software de arranque |
| O mesmo identificador de mod aparece várias vezes | Dois ficheiros ativos podem oferecer o mesmo mod | Verificar a lista de ficheiros e o conteúdo do pack quanto a versões duplicadas |
| O arranque avança e só falha com uma exceção | A verificação de dependências não explica totalmente o erro | Analisar o relatório de arranque/crash e a última alteração |
A lista pode conter vários requisitos interligados. Resolve o conflito indicado como um conjunto coeso; a linha de cima não é automaticamente a única causa. Depois verificas a nova saída de arranque, em vez de continuares a seguir a mensagem antiga.
Um erro de Mixin ou NoClassDefFoundError não prova, por si só, que falta a Fabric API. O guia do Fabric sobre relatórios de crash explica cadeias de erros relevantes, dados do sistema e lista de mods. O mod mencionado primeiro pode estar envolvido sem ser o único responsável. Se o servidor não arranca de todo, o guia de falhas de arranque também delimita causas fora da escolha de versões.
4. Alterar na mcfreehost e testar com caminho de volta
Guarda primeiro o mundo, a configuração e o conjunto de versões anterior. Uma cópia apenas dos ficheiros de mods não basta para um caminho de volta após uma conversão do mundo. Planeia a alteração para uma altura em que o teu grupo não esteja a jogar e pára o servidor de forma limpa pela gestão.
O Loader faz parte do software de arranque. Usa para isso o caminho de software/versão previsto do teu servidor; não coloques um JAR de Loader como suposta API em mods. Numa troca ou reinstalação, lê o aviso apresentado sobre a preservação de dados. Pára antes de confirmar se ainda não existir uma cópia de segurança completa. A API e outras bibliotecas de mods, por outro lado, pertencem à pasta mods como ficheiros de mod adequados.
Num modpack gerido, respeita o respetivo caminho de atualização e instalação. Uma atualização posterior do pack pode voltar a substituir uma troca manual de ficheiros. Por isso, regista as tuas alterações e esclarece se são sequer compatíveis com a versão desejada do pack. O guia de atualizações descreve como controlar as atualizações automáticas.
Depois da alteração, verifica por esta ordem:
- O servidor chega ao estado operacional; o novo log de arranque mostra o estado esperado do jogo e do Loader.
- Um cliente com a versão prevista do pack consegue realmente entrar.
- Uma função de mod importante para o vosso grupo funciona no mundo certo.
- Após um reinício limpo, o mundo e as definições mantêm-se.
Um arranque bem-sucedido ainda não confirma uma entrada bem-sucedida no modpack. Inversamente, uma API mais recente não resolve a falta de RAM. Se o arranque funciona e só novos chunks ou muitas entidades sobrecarregam o servidor, separa esta questão de recursos do erro de versão. Para servidores gratuitos aplicam-se os limites da entrada gratuita; uma biblioteca adicional não aumenta a RAM disponível.
Se o novo estado falhar, pára outras alterações e restaura o estado de software antigo documentado em conjunto com a cópia de segurança de antes da alteração. Não inicies um mundo já carregado com um Minecraft mais recente como um downgrade improvisado com software mais antigo. Para pedir ajuda, anota a versão do pack, a última alteração e as linhas de log relevantes; verifica os logs quanto a dados de acesso antes de os partilhar.
FAQ
Posso definir sempre o Fabric Loader para a versão mais recente?
Um Loader suporta várias versões do jogo, mas isso não é garantia para qualquer composição de pack. Verifica as especificações do pack e dos mods, guarda o estado atual e testa a troca. Uma atualização do Loader não substitui um ficheiro de mod escolhido incorretamente.
A Fabric API tem de ter o mesmo número de versão que o Minecraft?
Não. A Fabric API tem o seu próprio número de versão. O que importa são as versões do Minecraft indicadas para esse ficheiro e os requisitos dos mods que a utilizam.
A Fabric API tem de existir no servidor e no cliente?
Depende dos mods de cada lado. Se precisarem da Fabric API, tem de existir aí uma versão adequada. As indicações do pack e do projeto dizem-te que ficheiros estão previstos para o cliente e quais para o servidor.
O cliente e o servidor têm de ter o mesmo Loader?
O número do Loader por si só não decide a entrada. Ambos os lados têm de cumprir os seus requisitos de mods. Para um pack pronto, usas em ambos os lados a versão prevista e manténs a versão do Minecraft compatível; não troques o Loader independentemente do pack.
Posso simplesmente desativar uma dependência obrigatória em falta?
Desativar a verificação de dependências não torna disponíveis as funções em falta. Procura o ficheiro adequado ou volta ao estado funcional do pack. Alterações ao ficheiro de metadados não são um caminho de reparação normal para este guia.
Porque não consigo entrar apesar de o servidor ter arrancado com sucesso?
O arranque do servidor verifica o seu próprio ambiente. Uma instância de cliente iniciada incorretamente, outra versão do pack ou conteúdos comuns em falta só podem ser notados na entrada. Compara então as versões reais e a mensagem de erro concreta do cliente.
Fontes e base de verificação
- Fabric: instalar mods — versão do jogo, família do Loader e instalação.
- Fabric: instalação e launcher de servidor — o Loader como parte da instalação de arranque.
- Fabric API: ficheiros publicados — associação às versões do jogo.
- Fabric: metadados de mods — ambientes e dependências declaradas.
- Fabric: ler relatórios de crash — cadeias de erros e dados de sistema/mods.
As fontes foram verificadas em 7 de outubro de 2026. Um conjunto de versões concreto continua a ser uma decisão para o teu pack; este artigo não afirma ter feito um novo teste de arranque ou de entrada no teu mundo individual.