Guias / Comandos e dados

Receitas personalizadas: com forma, sem forma e usando tags em vez de listar cada madeira

Uma receita com forma que não funciona geralmente tem a chave errada. Veja o JSON, o que o jogo corta do padrão por você, o truque de tag que transforma treze receitas em uma, e como testar.

2026-06-29

Receitas estão entre os arquivos de datapack mais fáceis de escrever e entre os mais fáceis de errar sutilmente, porque uma receita quebrada falha em silêncio — a grade de criação simplesmente não faz nada.

Com forma

{
  "type": "minecraft:crafting_shaped",
  "pattern": [ "SSS", "S S", "SSS" ],
  "key": { "S": "minecraft:stone" },
  "result": { "id": "minecraft:furnace", "count": 1 }
}

Três regras que causam a maioria das falhas:

• Todo caractere em pattern precisa existir em key, exceto o espaço, que significa vazio.
• O padrão é relativo, não absoluto. O jogo corta linhas e colunas em branco das bordas, então um 2×2 preenchido com espaços até virar 3×3 ainda funciona em qualquer lugar da grade — mas escrever como duas linhas de dois é mais claro.
• Todas as linhas precisam ter o mesmo comprimento. ["SS", "S"] é inválido.

Sem forma

{
  "type": "minecraft:crafting_shapeless",
  "ingredients": ["minecraft:stone", "minecraft:coal"],
  "result": { "id": "minecraft:torch", "count": 4 }
}

A ordem é irrelevante. Itens repetidos devem ser listados uma vez cada — dois carvões significa duas entradas.

Tags reduzem uma família inteira a uma receita

Em vez de treze receitas para treze tipos de tábua:

"key": { "P": "#minecraft:planks" }

O # marca uma tag de item. #minecraft:planks, #minecraft:logs, #minecraft:wool, #minecraft:stone_crafting_materials e dezenas de outras já existem. Definir a sua própria leva um arquivo:

data/<namespace>/tags/item/my_metals.json

{ "values": ["minecraft:iron_ingot", "minecraft:gold_ingot"] }

Repare em tags/item/ — singular item, plural tags. Essa inconsistência é real.

Resultado com componentes

"result": {
  "id": "minecraft:diamond_sword",
  "count": 1,
  "components": { "minecraft:custom_name": "Excalibur", "minecraft:enchantments": { "sharpness": 5 } }
}

É assim que um item personalizado se torna criável sem um mod.

Os outros tipos de receita

crafting_shaped e crafting_shapeless são dois entre muitos. Também disponíveis: smelting, blasting, smoking, campfire_cooking, stonecutting, smithing_transform e smithing_trim. Os tipos de cozimento usam cookingtime e experience; a cortadora de pedra usa um único ingrediente e uma quantidade.

Testes

/reload e depois teste a grade. Se nada acontecer:

1. Confira o log do jogo (latest.log) após /reload — JSON malformado é reportado lá, não no chat.
2. /recipe give @s <namespace>:<recipe> — se o id da receita estiver errado, isso gera um erro, o que indica que o arquivo não está sendo lido de forma alguma.
3. O desbloqueio de receita é separado da existência da receita. Uma receita funciona na grade mesmo que nunca apareça no livro de receitas.

Monte o JSON de receita, predicado e kit com as chaves e tags verificadas no Datapack JSON Builders.

Criadores de JSON para pacotes de dados →