Guia
Como criar um mod de Minecraft sem programar
Atualizado em 18 de outubro de 2026
Um mod adiciona coisas que o jogo vanilla não tem: blocos, itens, ferramentas, armaduras e mobs novos. É um projeto Java para um mod loader, Fabric ou Forge, e normalmente isso significa aprender Java, Gradle e a API do loader. Com o Codexe, você descreve o mod, e ele escreve o projeto e o compila em um .jar de mod.
Troque o exemplo pelo mod que você quer.
Gere isto com o CodexePasso a passo
1.Escolha o loader e a versão
Use o loader e a versão do Minecraft que o seu jogo ou modpack usa, por exemplo "Fabric 1.21.1" ou "Forge 1.20.1". Para NeoForge, diga NeoForge explicitamente. Sem uma versão, os mods são feitos para a 1.20.1.
2.Descreva o que o mod adiciona
Cada item ou bloco com o nome, o que ele faz, os atributos (dano, durabilidade, velocidade de mineração) e como é craftado. Um comportamento preciso vale mais que histórias longas.
3.Diga onde ele roda
Só no cliente (HUD, atalhos de teclado), só no servidor ou nos dois. Mods que adicionam conteúdo precisam ser instalados no servidor e em todos os clientes.
4.Deixe o Codexe escrever e compilar
O Codexe escreve o projeto Gradle, o descritor do mod (
fabric.mod.jsonoumods.toml), o código, as receitas e o arquivo de idioma, e compila. O primeiro build de um mod muitas vezes leva alguns minutos enquanto a toolchain é baixada.5.Adicione as suas texturas
Os mods gerados vêm com texturas provisórias. Substitua os arquivos PNG em
assets/<modid>/textures/pelos seus, mantendo os mesmos nomes, e compile de novo.6.Instale e jogue
Baixe o .jar do mod e coloque na pasta
mods/de um jogo com o mesmo loader e a mesma versão instalados (no Fabric, também a Fabric API). Os servidores de teste ainda não rodam mods, então teste no seu próprio cliente.7.Peça mudanças no chat
"O martelo quebra bedrock, não deveria" já basta. O Codexe edita o código e compila de novo.
O que escrever
- Conteúdo: cada item, bloco, ferramenta, peça de armadura ou mob, com um nome.
- Comportamento: o que acontece ao usar, ao acertar, enquanto está na mão ou vestido, com números.
- Receitas: o padrão de crafting ou o item de fundição de cada item.
- Geração de mundo: para minérios, a dimensão e a faixa de altura.
- Aba do criativo e nomes: onde os itens aparecem e os nomes em inglês.
- Outros mods: qualquer dependência além da Fabric API, como Cloth Config ou Mod Menu.
Exemplo de descrição
"Um mod para Fabric no Minecraft 1.21.1 chamado Gems. Adiciona um minério de safira que é gerado no overworld entre Y -60 e 16, uma gema de safira que ele dropa e ferramentas de safira (espada, picareta, machado, pá) com força entre ferro e diamante. Um Sapphire Staff que dá Velocidade II por 10 segundos com o clique direito, cooldown de 30 segundos. Receitas de crafting para tudo, todos os itens em uma aba do criativo Gems, nomes em inglês. As texturas podem ser provisórias."
O que você recebe
Gerar e compilar é de graça no plano Free (50.000 tokens renovados a cada 24 horas). Baixar o .jar ou o código-fonte exige um plano ou um pacote de downloads.
| Arquivo | O que é |
|---|---|
| .jar do mod | O mod compilado para a pasta mods/, verificado para conter o fabric.mod.json ou o mods.toml |
| ZIP do código-fonte | O projeto Gradle inteiro, para continuar editando ou entregar a um desenvolvedor |
| Assets | Arquivo de idioma, modelos e texturas provisórias que você pode substituir |
Perguntas
É parecido com o MCreator?
Os dois criam mods sem código. O MCreator monta os mods elemento por elemento em um editor; o Codexe escreve o código a partir de uma descrição e o compila. Veja Codexe vs MCreator.
Fabric ou Forge?
Use o loader que o seu modpack ou os seus amigos já usam. O Fabric é mais leve e costuma atualizar primeiro; o Forge e o NeoForge têm listas grandes de mods em algumas versões. Veja Fabric vs Forge.
Posso jogar em um servidor com amigos?
Sim. Coloque o mesmo .jar na pasta mods/ do servidor e na de cada jogador, todos com o mesmo loader e a mesma versão.
Eu preciso mesmo de um mod?
Se você só quer regras, comandos ou receitas novas em um servidor, um plugin ou um datapack permite que os jogadores entrem sem instalar nada. Veja plugin vs mod.
Descreva o seu mod
Este prompt abre pronto para enviar:
“Um mod para Fabric no Minecraft 1.21.1 chamado Gems: minério de safira no overworld entre Y -60 e 16, uma gema de safira, ferramentas de safira entre ferro e diamante, um Sapphire Staff que dá Velocidade II por 10 segundos com o clique direito e cooldown de 30 segundos, receitas para tudo, uma aba do criativo Gems e nomes em inglês.”
Gere isto com o Codexe