O primeiro mod mais útil é aquele que você consegue compilar, encontrar e iniciar novamente. O projeto de exemplo do Fabric oferece esse ponto de partida: uma pequena pasta de código-fonte com código, recursos e configuração de compilação já conectados. Sua tarefa é transformar esse começo funcional em uma ideia própria.
O que você recebe na primeira inicialização
O exemplo sem alterações não adiciona uma espada, máquina ou bioma novo. Seu primeiro sucesso é o projeto compilar e carregar. Mod Menu é uma ferramenta separada que pode mostrar os mods carregados; não é um recurso fornecido pela própria base do projeto.

O exemplo 26.2 sem alterações, compilado em um JAR e carregado em um jogo Fabric separado. Buscar Example no Mod Menu facilita encontrá-lo. Example Mod e Me! são o nome e o autor provisórios da base; você vai substituí-los quando tornar o projeto seu.
Escolha o código-fonte para o jogo que quer atender
Abra Arquivos e escolha primeiro a versão de Minecraft pretendida. A nova snapshot de código-fonte 26.2 é a usada aqui. As snapshots anteriores continuam disponíveis para suas próprias versões do jogo; use-as se o seu projeto precisa ficar naquela versão.
Para a snapshot 26.2, use JDK 25. As snapshots antigas desta página têm seus próprios requisitos de compilação. Mudar só o número de Minecraft em um arquivo de compilação não atualiza automaticamente todo o código e as dependências ao redor.
Do ZIP de código-fonte a um mod em execução
- Extraia o ZIP de código-fonte em uma nova pasta de desenvolvimento. Abra a pasta que realmente contém build.gradle, gradlew.bat e gradle.properties. Um arquivo de repositório baixado pode ter uma pasta extra ao redor deles.
- Abra um terminal nessa pasta. No Windows, execute .\gradlew.bat build. No macOS ou Linux, use ./gradlew build. Deixe a primeira execução terminar de baixar as dependências de compilação.
- Quando a compilação terminar com sucesso, abra build/libs. Escolha o JAR normal do mod. O -sources.jar contém código-fonte e não é o arquivo para instalar para jogar normalmente.
- Coloque o JAR normal na pasta mods de uma instância Fabric correspondente. Instale as dependências declaradas no fabric.mod.json daquele exemplo e inicie essa instância.
- Confira se o exemplo carrega antes de mudar sua estrutura. Guarde essa primeira compilação funcional para ter com o que comparar depois.
Para um jogo de desenvolvimento separado, execute .\gradlew.bat runClient no Windows ou ./gradlew runClient no macOS/Linux. Essa é a inicialização de desenvolvimento da base do projeto, não um motivo para copiar arquivos-fonte para a pasta dos seus saves cotidianos.
Faça uma mudança reconhecível
Comece pelo nome exibido e pelo autor em src/main/resources/fabric.mod.json, compile novamente e procure seu novo nome na lista de mods. É uma mudança pequena com um resultado evidente. Quando esse ciclo estiver confortável, passe ao primeiro item ou outro recurso.
Renomear um ID de mod é um passo maior do que mudar um nome exibido: pontos de entrada, pacotes Java, recursos e referências a mixins podem depender dele. Mantenha esses nomes consistentes e faça uma mudança por vez. Um recurso pequeno que funciona é uma base melhor para crescer do que uma pasta grande de mudanças parcialmente conectadas.
Se sua ideia precisar de um modelo ou textura, nosso passo a passo de Blockbench começa com uma pequena lanterna. Decida o que o objeto faz no seu mod separadamente de sua aparência.
Quando a primeira compilação trava
- Erro de versão de Java: execute .\gradlew.bat --version e confira a JVM que Gradle realmente está usando. Instalar um novo JDK nem sempre o seleciona no seu editor.
- Uma dependência não pode ser baixada: leia o primeiro download que falhou e tente novamente quando houver conexão. Mudar a extensão do ZIP não ajuda.
- O JAR existe, mas o jogo não o vê: confira a instância iniciada, a versão de Minecraft e o carregador. Nosso guia de instalação de Fabric mostra onde colocar o arquivo pronto.
- Nada novo aparece no mundo: o exemplo original é um projeto inicial, não um pacote de conteúdo. Confira se ele carrega antes de esperar um recurso que você ainda não adicionou.
Comentários 0
Compartilhe o que funcionou, peça ajuda ou responda a outro jogador.
Use sua conta Modonix para participar da conversa e gerenciar seus comentários.
Entre para comentarAinda não há comentários. Compartilhe o que funcionou para você.