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
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…).
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) esettings.gradle.fabric.mod.jsoncom 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
-SNAPSHOTantigas 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
| Sintoma | Causa provável |
|---|---|
| Crash em um servidor dedicado citando classes do cliente | Có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 Minecraft | O 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ção | Instale a Fabric API em mods/ junto com o mod. |