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.

TRtrolPublished 5 min read

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:

  1. Baixar o instalador oficial do Fabric de fabricmc.net
  2. Executá-lo e escolher sua versão do Minecraft
  3. Selecionar o novo perfil Fabric no seu launcher
  4. 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:

  1. Vá para fabricmc.net/use/api
  2. Encontre a versão correspondente à sua versão do Minecraft
  3. Baixe o JAR
  4. Mova-o para a sua pasta de mods
SOCaminho
Windows%appdata%\.minecraft\mods
macOS~/Library/Application Support/minecraft/mods
Linux~/.minecraft/mods

Passo 3: Baixe e adicione mods

  1. Baixar mods JAR

    Encontre mods em sites como Modrinth ou CurseForge. Baixe o arquivo JAR correspondente à sua versão do Minecraft.

  2. Mova para a pasta de mods

    Arraste cada JAR para a sua pasta de mods. Não os descompacte — eles permanecem como arquivos JAR.

  3. Lançamento Fabric

    Abra o Minecraft, selecione o perfil Fabric e clique em Jogar.

  4. 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:

  1. Remova todos os mods, exceto um
  2. Reinicie para confirmar se funciona sozinho
  3. Adicione os mods de volta um por um
  4. 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çaCorrespondência necessáriaExemplo
MinecraftVersão exata1.21
Fabric loaderVersão exata1.21
Fabric APIVersão exata1.21
Cada modVersão exata1.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:

  1. Siga todos os passos acima para configurar o Fabric e a API Fabric.
  2. Baixe o Terminus do seu painel de conta.
  3. Arraste o arquivo JAR do Terminus para a pasta de mods.
  4. Inicie o Fabric.

O Terminus é carregado como qualquer outro mod Fabric. Configure-o no jogo a partir do menu de mods.

Perguntas Frequentes