Pular para o conteúdo
Plataformas

Mods Fabric

Mods Fabric com o Codexe: o que colocar no pedido, versões do Minecraft e do loader, como funciona o build com Gradle/Loom (Java 21 para mods da 1.20.1), mixins e problemas comuns.

Atualizado

Nesta página
  1. O que colocar no pedido
  2. O que o Codexe gera
  3. Como o build funciona
  4. Verificação
  5. Problemas comuns

O Fabric é um mod loader leve que costuma suportar rápido as novas versões do Minecraft. O Codexe gera um projeto Gradle completo usando o plugin Loom do Fabric.

#O que colocar no pedido

  • Versão do Minecraft: "Fabric para 1.20.1", "1.21.1". Sem ela, é usada a 1.20.1.
  • O que o mod adiciona: blocos, itens, entidades, comandos, atalhos de teclado, elementos de HUD. Seja preciso sobre o comportamento.
  • Cliente ou servidor: diga se é só do cliente (HUD, atalhos de teclado), só do servidor ou dos dois.
  • Dependências: a Fabric API está incluída. Cite as outras (Cloth Config, Mod Menu…).
Text
A Fabric mod for 1.21.1: a "Magnet" item that pulls nearby dropped items to the player within 8 blocks while held in the offhand. Toggle with a keybind (default M). Crafting: iron ingots around a redstone block. English lang file and item model.

#O que o Codexe gera

  • build.gradle, gradle.properties (versões do Minecraft, do Yarn, do loader e da Fabric API) e settings.gradle.
  • fabric.mod.json com os entrypoints separados por ambiente (main, client).
  • Configuração e classes de mixin quando o recurso precisa delas.
  • Assets: arquivos de idioma, modelos, texturas provisórias.

#Como o build funciona

  • O Codexe fixa uma versão estável do Loom (as versões -SNAPSHOT antigas somem do repositório do Fabric e quebram os builds).
  • Se a versão pedida do loader, do Yarn ou da Fabric API não existir, o Codexe a substitui por uma real para aquela versão do Minecraft.
  • O Loom precisa de um runtime Java 21 para rodar o Gradle. Em um mod para a 1.20.1 (que usa Java 17), o Codexe roda o Gradle no Java 21, mas o seu mod continua compilado para Java 17. O JAR funciona em um servidor com Java 17.

O primeiro build de um mod demora mais (muitas vezes alguns minutos): o Loom baixa o Minecraft e os mappings. Os builds de mods param depois de 10 minutos.

#Verificação

O mod é compilado antes de ficar Pronto, e o JAR precisa conter o fabric.mod.json (ou quilt.mod.json). Compilar prova que ele compila, não que roda sem travar, então teste em um cliente.

#Problemas comuns

SintomaCausa provável
Crash em um servidor dedicado citando classes do clienteCódigo exclusivo do cliente no entrypoint main. Peça ao chat para passá-lo para o entrypoint client.
"Incompatible mods found", versão errada do MinecraftO mod foi feito para uma versão do Minecraft diferente da do seu jogo. Informe a versão exata.
Fabric API ausente durante a execuçãoInstale a Fabric API em mods/ junto com o mod.
Mods Fabric | Codexe Docs