Fabric Example Mod: compile seu primeiro mod Java funcional

Transforme a base de código-fonte do Fabric em um JAR de mod funcional, veja onde ficam os arquivos e faça sua primeira pequena mudança sem alterar seu jogo principal.

Idioma do conteúdo

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.

Fabric Example Mod carregado no Minecraft Java 26.2 e selecionado no Mod Menu dentro do jogo.

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

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
Ainda sem avaliações

Arquivos

Filtrar arquivos Arquivos: 4Todos os tipos de versão

Versão 26.2-source-1ce1c77a

Estável

fabric-example-26.2-1ce1c77a.zip

0 downloads
Baixar · 62,7 KB
Requisitos e detalhes
  • Formato de arquivo: .zip

ZIP de código-fonte para Minecraft 26.2, não um mod instalável. Extraia, use JDK 25, execute a compilação com o wrapper de Gradle e instale o JAR normal resultante em uma instância Fabric correspondente.

Requisitos e observações
Atualizar a partir de uma versão anterior
Comece uma pasta de desenvolvimento separada para cada versão de jogo pretendida. Guarde o código-fonte editável e o JAR pronto separadamente.

Versão 1.21.1-source-684b5812

Estável

fabric-example-1.21.1.zip

0 downloads
Baixar · 64,6 KB
Requisitos e detalhes
  • Formato de arquivo: .zip

Versão 1.20.1-source-cf6a5284

Estável

fabric-example-1.20.1.zip

2 downloads
Baixar · 64,6 KB
Requisitos e detalhes
  • Formato de arquivo: .zip

Versão 1.19.2-source-3ea0867c

Estável

fabric-example-1.19.2.zip

2 downloads
Baixar · 64,6 KB
Requisitos e detalhes
  • Formato de arquivo: .zip

Novidades das versões

Versão 26.2-source-1ce1c77a

Estável

Código-fonte oficial de exemplo do Fabric fixado para Minecraft 26.2. Compilado com JDK 25 e carregado como um JAR normal no guia que o acompanha. Os alvos de código-fonte anteriores permanecem no histórico.

Ver arquivos

Versão 1.21.1-source-684b5812

Estável

Snapshot de código-fonte para Minecraft 1.21.1; o projeto original não atribui uma versão numerada a esse ramo.

Fonte: Arquivos-fonte de Fabric Example Mod
Os detalhes de compatibilidade abaixo refletem os alvos declarados pelo autor. Consulte a fonte vinculada para informações completas sobre versões e dispositivos.

Ver arquivos

Versão 1.20.1-source-cf6a5284

Estável

Snapshot de código-fonte para Minecraft 1.20.1; o projeto original não atribui uma versão numerada a esse ramo.

Fonte: Arquivos-fonte de Fabric Example Mod
Os detalhes de compatibilidade abaixo refletem os alvos declarados pelo autor. Consulte a fonte vinculada para informações completas sobre versões e dispositivos.

Ver arquivos

Versão 1.19.2-source-3ea0867c

Estável

Snapshot de código-fonte para Minecraft 1.19.2; o projeto original não atribui uma versão numerada a esse ramo.

Fonte: Arquivos-fonte de Fabric Example Mod
Os detalhes de compatibilidade abaixo refletem os alvos declarados pelo autor. Consulte a fonte vinculada para informações completas sobre versões e dispositivos.

Ver arquivos

Comentários 0

Compartilhe o que funcionou, peça ajuda ou responda a outro jogador.

Participe da conversa

1Seu nome e e-mail

Não é preciso ter uma conta. Confirme seu e-mail com um código antes do primeiro comentário. Somente um endereço parcialmente oculto aparece com seu nome. Os comentários de visitantes são revisados antes da publicação.

2Verificar e publicar

Ainda não há comentários. Compartilhe o que funcionou para você.

Buscar no Modonix

Buscar em