Guia
Como criar receitas de crafting personalizadas
Atualizado em 18 de outubro de 2026
Receitas personalizadas são o jeito mais fácil de mudar um servidor survival: craftar selas, descraftar lã, cozinhar carne podre e virar couro. Você pode adicioná-las com um datapack, que funciona no vanilla e no singleplayer, ou com um plugin, que faz mais coisas, como exigir um item personalizado específico como ingrediente.
Troque estas pelas suas receitas.
Gere isto com o CodexePasso a passo
1.Escolha entre datapack e plugin
Um datapack para receitas feitas de itens normais em qualquer servidor ou mundo. Um plugin quando os ingredientes precisam ser itens exatos (com um nome ou uma tag) ou a receita precisa de permissões ou outras condições.
2.Anote cada receita
O tipo (com formato, sem formato, fornalha, defumador, alto-forno, fogueira, cortador de pedras, mesa de ferraria), o padrão da grade, os ingredientes e o resultado com a quantidade.
3.Escreva no formato certo
Para um datapack, um arquivo JSON por receita em
data/<namespace>/recipe/(recipes/antes da 1.21). Para um plugin, umaShapedRecipeouShapelessRecipecom umaNamespacedKey, adicionada comBukkit.addRecipe.4.Decida se ela aparece no livro de receitas
As receitas funcionam assim que são carregadas. Para mostrá-las no livro de receitas, desbloqueie-as com um advancement (datapack) ou com
player.discoverRecipe(key)(plugin).5.Instale
Datapack: em
<world>/datapacks/e/reload. Plugin: o .jar emplugins/e um reinício.6.Crafte cada receita
Coloque os ingredientes em uma mesa de trabalho (ou fornalha) e confira o resultado, inclusive as disposições erradas que não deveriam funcionar.
Datapack ou plugin
| Recurso | Datapack | Plugin |
|---|---|---|
| Roda em | Vanilla, singleplayer, qualquer servidor | Spigot, Paper e forks |
| Ingredientes | Itens ou tags de itens | Itens, tags ou itens exatos com nome, lore ou dados |
| Resultado | Qualquer item, com componentes a partir da 1.20.5 | Qualquer item, inclusive os itens personalizados do seu plugin |
| Condições | Nenhuma durante o crafting | Permissões, mundos, cooldowns por meio de eventos |
O formato JSON mudou entre as versões
Uma receita com formato em um datapack da 1.21.4 fica assim: {"type": "minecraft:crafting_shaped", "pattern": ["GGG", "GHG", "GGG"], "key": {"G": "minecraft:gold_ingot", "H": "minecraft:heart_of_the_sea"}, "result": {"id": "minecraft:totem_of_undying", "count": 1}}.
As versões mais antigas escrevem de outro jeito: antes da 1.21.2 cada chave é um objeto como {"item": "minecraft:gold_ingot"}, e antes da 1.20.5 o resultado usa "item" em vez de "id". Uma receita copiada de um tutorial de outra versão é o motivo mais comum para uma receita não carregar. Diga a sua versão e o Codexe escreve o formato e os nomes de pastas que essa versão espera.
Exemplo de descrição
"Um datapack para Minecraft 1.21.4, namespace extras. Com formato: 3 couros em cima, linha e ferro na linha do meio = sela. Sem formato: 1 lã branca = 4 linhas. Fornalha: carne podre = couro, 0.1 de experiência. Cortador de pedras: 1 pedra = 4 tijolos de pedra. Um advancement que desbloqueia todas no livro de receitas quando o jogador pega couro."
O Codexe carrega os datapacks em um servidor real de Minecraft antes de marcá-los como Pronto, então um erro de JSON ou de pasta é pego e corrigido. Com o Teste agora, você pode entrar em um servidor com o pack instalado e craftar cada receita.
Perguntas
Uma receita de datapack pode exigir um item renomeado ou personalizado?
Não: os ingredientes de um datapack correspondem ao tipo do item ou a uma tag de item, não a nomes ou dados. Para isso, use um plugin com RecipeChoice.ExactChoice.
Posso remover uma receita vanilla?
Sim. Um datapack pode substituir o arquivo da receita vanilla no namespace minecraft, e um plugin pode removê-la com Bukkit.removeRecipe.
Por que a minha receita não aparece no livro de receitas?
Ela ainda não foi desbloqueada para aquele jogador. Ela continua funcionando na grade; desbloqueie com um advancement ou com discoverRecipe para mostrá-la.
Crie as suas receitas
Este prompt abre pronto para enviar:
“Um datapack para Minecraft 1.21.4, namespace extras: receita com formato para uma sela (3 couros em cima, linha, ferro, linha no meio), sem formato 1 lã branca = 4 linhas, fornalha carne podre = couro, cortador de pedras 1 pedra = 4 tijolos de pedra e um advancement que desbloqueia todas quando o jogador pega couro.”
Gere isto com o Codexe