Learn · guides
Como instalar mods do Fabric no Minecraft
Guia completo para configurar o Fabric e instalar vários mods: pré-requisitos, instalação passo a passo e solução de problemas para travamentos.
O Fabric é um mod loader leve que permite executar mods ao lado do Minecraft vanilla sem modificar o jogo base. Este guia detalha a instalação do Fabric, a configuração da pasta de mods e a adição de mods para que sejam carregados automaticamente.
Pré-requisitos
Antes de começar:
- Minecraft Java Edition instalado e lançado pelo menos uma vez
- Java 17 ou superior instalado (Java 21 recomendado para a versão atual do Minecraft)
- Uma conexão com a internet
- Mods do Fabric baixados (como arquivos JAR)
Verifique sua versão do Java abrindo um terminal e executando java -version.
Passo 1: Instalar o Fabric Loader
Siga o guia de instalação do Fabric loader para:
- Baixar o instalador oficial do Fabric de fabricmc.net
- Executá-lo e escolher sua versão do Minecraft
- Selecionar o novo perfil Fabric no seu launcher
- Lançar uma vez para que a pasta de mods seja criada
Após este passo, você terá uma instalação do Fabric funcionando e uma pasta de mods pronta para mods.
Passo 2: Obter a Fabric API
A maioria dos mods do Fabric dependem da Fabric API, uma biblioteca compartilhada. Baixe-a:
- Vá para fabricmc.net/use/api
- Encontre a versão correspondente à sua versão do Minecraft
- Baixe o JAR
- Mova-o para a sua pasta de mods
| SO | Caminho |
|---|---|
| Windows | %appdata%\.minecraft\mods |
| macOS | ~/Library/Application Support/minecraft/mods |
| Linux | ~/.minecraft/mods |
Passo 3: Baixe e adicione mods
Baixar mods JAR
Encontre mods em sites como Modrinth ou CurseForge. Baixe o arquivo JAR correspondente à sua versão do Minecraft.
Mova para a pasta de mods
Arraste cada JAR para a sua pasta de mods. Não os descompacte — eles permanecem como arquivos JAR.
Lançamento Fabric
Abra o Minecraft, selecione o perfil Fabric e clique em Jogar.
Verifique os mods carregados
No menu principal, vá para Mods. Você deverá ver seus mods listados. Se um mod não aparecer, verifique se a versão dele corresponde à sua versão do Minecraft.
Após o lançamento, todos os mods na sua pasta são carregados automaticamente.
Organizando sua pasta de mods
Mantenha sua pasta de mods organizada:
.minecraft/mods/
├── fabric-api-X.X.X.jar
├── mod-name-1.jar
├── mod-name-2.jar
├── mod-name-3.jar
└── (all mods here)
Exclua um mod removendo seu arquivo JAR. Sem necessidade de configuração, basta reiniciar.
Lidando com conflitos de mods
Alguns mods entram em conflito uns com os outros. Sinais de conflito:
- Travamento ao iniciar com um mod específico carregado
- O jogo congela ou fica lento de forma incomum
- As funcionalidades de um mod não funcionam
Para identificar o culpado:
- Remova todos os mods, exceto um
- Reinicie para confirmar se funciona sozinho
- Adicione os mods de volta um por um
- Quando ocorrer um travamento, você encontrou o conflito
Verifique a documentação do mod—o autor geralmente lista conflitos conhecidos.
Correspondência de versões explicada
Este é o ponto de falha mais comum:
| Peça | Correspondência necessária | Exemplo |
|---|---|---|
| Minecraft | Versão exata | 1.21 |
| Fabric loader | Versão exata | 1.21 |
| Fabric API | Versão exata | 1.21 |
| Cada mod | Versão exata | 1.21 |
Se o Minecraft for 1.21, mas um mod suportar apenas 1.20.1, ele não será carregado. Sempre verifique a página de download do mod para as versões suportadas.
Problemas comuns e soluções
- O mod não aparece na lista de mods: verifique se ele está na pasta de mods correta (caminho acima) e se você iniciou o perfil Fabric, e não o vanilla.
- Falha com "não foi possível encontrar a classe": a API Fabric está ausente ou na versão errada. Baixe a versão correta da API para a sua versão do Minecraft.
- Erro de versão nos logs: seu Minecraft, Fabric, API ou mod têm versões diferentes. Todos devem corresponder exatamente.
- O mod carrega, mas o jogo trava quando usado: provavelmente há um conflito com outro mod. Desative os outros e teste-o isoladamente.
- O desempenho está muito lento: você pode ter muitos mods demais para o seu hardware. Tente desativar os mais exigentes.
Adicionando Terminus
Terminus é um mod Fabric que funciona em conjunto com outros mods. Para instalá-lo:
- Siga todos os passos acima para configurar o Fabric e a API Fabric.
- Baixe o Terminus do seu painel de conta.
- Arraste o arquivo JAR do Terminus para a pasta de mods.
- Inicie o Fabric.
O Terminus é carregado como qualquer outro mod Fabric. Configure-o no jogo a partir do menu de mods.
Perguntas Frequentes
Não. O lançador padrão do Minecraft funciona bem. Qualquer lançador de terceiros com suporte ao Fabric também funciona. Alguns clientes enviam seu próprio lançador, mas os mods rodam em qualquer lançador.
Não. Fabric e Forge são ecossistemas completamente separados com formatos de mod incompatíveis. Um mod é direcionado a um ou outro, não a ambos.
Para Minecraft moderno (1.20+), Java 17 ou superior. Para versões mais antigas, Java 8 é suficiente. Verifique os requisitos específicos da versão do seu Minecraft.
Não. As modificações estão isoladas na pasta de mods. Se algo der errado, exclua o arquivo JAR da modificação e reinicie. Seus mundos e salvamentos nunca são afetados.