Guides / Commands & Data

Receitas personalizadas: com padrão, sem padrão e usando tags em vez de listar cada madeira

Uma receita com padrão que não funciona geralmente tem a chave errada ou o padrão preenchido. Aqui está o JSON, o truque da tag que transforma oito receitas em uma, e como testar.

2026-06-29

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

Com padrão (Shaped)

{
  "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:

• Cada caractere em pattern deve existir em key, exceto um espaço, que significa vazio.
• O padrão é relativo, não absoluto. Uma receita 2×2 deve ser escrita como duas linhas de dois, não preenchida em um 3×3 com espaços. O preenchimento faz com que ela seja criável apenas naquele canto exato da grade.
• Todas as linhas devem ter o mesmo comprimento. ["SS", "S"] é inválido.

Sem padrão (Shapeless)

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

A ordem é irrelevante. Duplicatas devem ser listadas uma vez cada — dois Carvões significam duas entradas.

Tags colapsam uma família em uma receita

Em vez de oito receitas para oito tipos de tábuas:

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

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

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

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

Note 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 de muitos. Também disponíveis: smelting, blasting, smoking, campfire_cooking, stonecutting, smithing_transform e smithing_trim. Os tipos de cozimento (cooking types) usam cookingtime e experience; o corte de pedra (stonecutting) usa um único ingrediente e uma contagem.

Testando

/reload e então tente a grade. Se nada acontecer:

1. Verifique o chat ao recarregar — JSON malformado é reportado lá.
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.

1. O desbloqueio de receita é separado da existência da receita. Uma receita funciona na grade mesmo que

nunca apareça no Livro de receitas.

Construa JSON de receita, predicado e kit com as chaves e tags verificadas nos Construtores de JSON de Datapack.

Construtores de JSON para pacotes de dados →