Como instalar um mod Fabric

A instalação de um mod Fabric segue um processo simples de três etapas: certifique-se de que o Fabric Loader está instalado para a sua versão do Minecraft, adicione a Fabric API à sua pasta de mods e, em seguida, coloque o arquivo JAR do mod ao lado dela. A maioria dos problemas de instalação são causados por incompatibilidades de versão, portanto, verifique se cada componente é direcionado à mesma versão do Minecraft

Pré-requisitos

Antes de instalar um mod:

• Fabric Loader instalado para a sua versão do Minecraft (veja Como instalar o Fabric Loader)
• Você já iniciou o perfil do Fabric pelo menos uma vez para que a pasta de mods exista
• O arquivo JAR do mod foi baixado

O processo de três etapas

1. Tenha o carregador Fabric instalado

   Certifique-se de que você instalou e iniciou o Fabric Loader para a sua versão do Minecraft. Caso contrário, siga o guia de instalação do Fabric Loader primeiro.

2. Baixe e adicione a API Fabric

   Baixe o arquivo JAR da API Fabric correspondente à sua versão do Minecraft. Coloque-o na pasta de mods. A maioria dos mods depende deste.

3. Adicione o arquivo JAR da modificação

   Baixe o arquivo JAR da modificação e coloque-o na mesma pasta de mods, ao lado da API Fabric. Não o descompacte — ele permanece como um JAR.

Inicie o Minecraft usando o perfil Fabric e os mods são carregados automaticamente na inicialização.

A pasta de mods

Sua pasta de mods está localizada em:

Se a pasta não existir, execute o perfil Fabric uma vez e ela será criada para você.

Fabric API: por que você precisa dela

A maioria dos mods Fabric dependem da Fabric API, uma biblioteca compartilhada que fornece utilitários comuns para modders. Instalar primeiro evita travamentos por bibliotecas ausentes. Mesmo que um mod específico afirme que não precisa da API, adicioná-la não prejudica e evita surpresas.

O que fazer quando um mod não carregar

• ✓O mod não aparece na lista de mods: o JAR está na pasta errada, ou você iniciou o jogo vanilla em vez do Fabric. Confirme o caminho e o perfil.
• ✓Falha com o erro "classe ausente": a API Fabric está ausente ou é a versão errada. Baixe a versão correta da API para a sua versão do Minecraft.
• ✓Erro de incompatibilidade de versão nos logs: o carregador, a API ou o mod visam diferentes versões do Minecraft. Todos os três devem corresponder exatamente (por exemplo, 1.21, não 1.21.1 se o mod for direcionado a 1.21).
• ✓O mod carrega, mas o jogo trava quando usado: o mod pode estar em conflito com outro mod ou com uma configuração. Tente iniciar o jogo com apenas esse mod para isolar o problema.

Correspondência de versão

Este é o maior problema. Cada componente deve ser direcionado para a mesma versão:

Minecraft version: 1.21
Fabric loader version: 1.21 ✓
Fabric API version: 1.21 ✓
Mod version: 1.21 ✓
All match → no crash

Se o seu Minecraft for 1.21, mas um mod for direcionado para 1.20.1, ele não será carregado. Verifique a página de download do mod para a versão exata que ele suporta.

Executando vários mods

Depois de ter um mod funcionando, adicionar mais é simples:

1. Baixe cada arquivo JAR do mod
2. Arraste-os todos para a pasta mods
3. Inicie o Fabric
4. Todos os mods são carregados juntos (assumindo que não haja conflitos)

Alguns mods entram em conflito uns com os outros. Se ocorrerem falhas após adicionar um novo mod, desative-o para confirmar se é a causa, e então verifique se o autor do mod documenta o conflito.

Perguntas frequentes