Types de recettes

Minecraft Bedrock a sept sortes de recettes. Chacune est un fichier JSON dans le pack de comportements, et chacune a un type qui décide des champs nécessaires et de la station qui peut l'utiliser. Cette page est un aide-mémoire rapide pour les sept, avec un exemple en rubis pour chacune.

Tu débutes avec les recettes ? Lis d'abord Recettes d'artisanat et de fourneau. Ce guide explique pas à pas les motifs, les clés, les tags d'objets, le livre de recettes (unlock) et priority. Cette page ne répète pas ces parties.

Les fichiers

Toutes les recettes vont dans un même dossier. Les noms de fichiers sont libres, et tu peux créer des sous-dossiers pour garder tout bien rangé.

BP/
  recipes/
    ruby_block.json
    ruby_from_block.json
    smelt_raw_ruby.json
    brew_ruby_strength.json
    brew_ruby_splash.json
    ruby_sword_upgrade.json

Les sept types en un coup d'œil

Tous les types partagent la même structure extérieure :

{
  "format_version": "1.20.10",
  "minecraft:recipe_shaped": {
    "description": {
      "identifier": "wiki:ruby_block"
    },
    "tags": ["crafting_table"]
  }
}

• La clé sous la racine (ici minecraft:recipe_shaped) est le type.
• description.identifier est l'ID propre à la recette. Il doit être unique, et ce n'est pas l'ID de l'objet.
• tags liste les stations qui l'acceptent. Voir Le champ tags plus bas.

Avec forme

Les objets doivent être placés selon un motif.

{
  "format_version": "1.20.10",
  "minecraft:recipe_shaped": {
    "description": {
      "identifier": "wiki:ruby_block"
    },
    "tags": ["crafting_table"],
    "pattern": [
      "RRR",
      "RRR",
      "RRR"
    ],
    "key": {
      "R": { "item": "wiki:ruby" }
    },
    "unlock": [{ "item": "wiki:ruby" }],
    "result": { "item": "wiki:ruby_block" }
  }
}

result peut aussi être une liste. Le premier objet va dans l'emplacement de sortie, et les autres te sont aussi rendus. Le gâteau vanilla fait ça : tu obtiens le gâteau et tu récupères tes trois seaux vides.

"result": [
  { "item": "wiki:ruby_cake" },
  { "item": "minecraft:bucket", "count": 3 }
]

Sans forme

Seuls les ingrédients comptent, pas leur position.

{
  "format_version": "1.20.10",
  "minecraft:recipe_shapeless": {
    "description": {
      "identifier": "wiki:ruby_from_block"
    },
    "tags": ["crafting_table"],
    "ingredients": [
      { "item": "wiki:ruby_block" }
    ],
    "unlock": [{ "item": "wiki:ruby_block" }],
    "result": { "item": "wiki:ruby", "count": 9 }
  }
}

Les recettes du tailleur de pierre sont aussi sans forme

Le tailleur de pierre n'a pas de type à lui. Il utilise des recettes sans forme avec un seul ingrédient et le tag stonecutter :

{
  "format_version": "1.20.10",
  "minecraft:recipe_shapeless": {
    "description": {
      "identifier": "wiki:ruby_bricks_stonecutting"
    },
    "tags": ["stonecutter"],
    "ingredients": [{ "item": "wiki:ruby_block" }],
    "unlock": [{ "item": "wiki:ruby_block" }],
    "result": { "item": "wiki:ruby_bricks", "count": 1 }
  }
}

Chaque choix du menu du tailleur de pierre est un fichier de recette séparé. Le jeu vanilla en a des centaines.

Fourneau

Un objet entre, un autre sort. Il n'y a pas de result : on utilise input et output à la place.

{
  "format_version": "1.20.10",
  "minecraft:recipe_furnace": {
    "description": {
      "identifier": "wiki:smelt_raw_ruby"
    },
    "tags": ["furnace", "blast_furnace"],
    "input": "wiki:raw_ruby",
    "output": "wiki:ruby"
  }
}

Le combustible ne fait pas partie de la recette. N'importe quel combustible normal marche.

Mélange d'alchimie

Un mélange d'alchimie (brewing mix) transforme un effet de potion en un autre. La fiole reste de la même sorte : une potion reste une potion, une potion jetable reste une potion jetable.

{
  "format_version": "1.20.10",
  "minecraft:recipe_brewing_mix": {
    "description": {
      "identifier": "wiki:brew_ruby_strength"
    },
    "tags": ["brewing_stand"],
    "input": "minecraft:potion_type:awkward",
    "reagent": "wiki:ruby",
    "output": "minecraft:potion_type:strength"
  }
}

Ici, un rubis transforme une potion étrange en potion de force, exactement comme la poudre de blaze.

Les noms de potions sont en minuscules, avec _ entre les mots. Quelques-uns utiles : water, awkward, mundane, thick, strength, swiftness, healing, regeneration, fire_resistance, slow_falling, water_breathing, invisibility et leaping. La vision nocturne s'écrit nightvision. Les versions plus longues commencent par long_ (long_strength) et les plus puissantes par strong_ (strong_strength).

Contenant d'alchimie

Une recette de contenant d'alchimie (brewing container) change la fiole et garde l'effet. Le jeu vanilla s'en sert pour la poudre à canon (potion vers potion jetable) et le souffle du dragon (potion jetable vers potion persistante).

{
  "format_version": "1.20.10",
  "minecraft:recipe_brewing_container": {
    "description": {
      "identifier": "wiki:brew_ruby_splash"
    },
    "tags": ["brewing_stand"],
    "input": "minecraft:potion",
    "reagent": "wiki:ruby_dust",
    "output": "minecraft:splash_potion"
  }
}

Transformation de forge

Améliore un objet en un autre à la table de forgeron. Les enchantements, le nom et l'usure de l'ancien objet sont conservés sur le nouveau. Le jeu vanilla s'en sert pour transformer l'équipement en diamant en netherite.

{
  "format_version": "1.20.10",
  "minecraft:recipe_smithing_transform": {
    "description": {
      "identifier": "wiki:ruby_sword_upgrade"
    },
    "tags": ["smithing_table"],
    "template": "wiki:ruby_upgrade_template",
    "base": "minecraft:diamond_sword",
    "addition": "wiki:ruby",
    "result": "wiki:ruby_sword"
  }
}

"minecraft:tags": {
  "tags": ["minecraft:transform_templates"]
}

Un seul exemplaire de chaque modèle et de chaque matériau est consommé, même si la pile est plus grande.

Garniture de forge

Ajoute un motif de garniture à une armure. Il n'y a pas de résultat : l'armure revient avec la garniture dessus. Voici à quoi ça ressemble :

{
  "format_version": "1.20.10",
  "minecraft:recipe_smithing_trim": {
    "description": {
      "identifier": "wiki:ruby_armor_trim"
    },
    "tags": ["smithing_table"],
    "template": { "tag": "minecraft:trim_templates" },
    "base": { "tag": "minecraft:trimmable_armors" },
    "addition": { "tag": "minecraft:trim_materials" }
  }
}

Chaque champ accepte un objet, ou un tag d'objet comme ci-dessus. C'est la même structure que l'unique recette de garniture du jeu vanilla : comme elle n'utilise que des tags, elle couvre tous les modèles, toutes les armures et tous les matériaux d'un coup.

Le champ tags

tags est une liste des stations qui peuvent utiliser une recette. Chaque type n'a de sens qu'avec certains tags :

Quelques règles :

• Liste toutes les stations voulues. Une recette de fourneau avec seulement le tag furnace ne marche pas dans un fumoir.
• Mélange librement à l'intérieur d'un type. La nourriture liste en général furnace, smoker, campfire et soul_campfire ensemble.
• Ignore deprecated. Certains fichiers vanilla utilisent ce tag pour garder d'anciennes recettes sans les afficher. Tes recettes n'en ont pas besoin.

Tu trouveras plus de détails sur chaque station, et sur la grille 2x2 de l'inventaire, dans Recettes d'artisanat et de fourneau.

Quand quelque chose ne marche pas

Tu trouveras plus d'aide dans Dépannage. Besoin d'objets à utiliser dans tes recettes ? Commence par Ton premier objet personnalisé.