教學:製作附加包/配方

配方

系列教學

所屬系列

製作附加包

難易度

初級

前置知識

• 開始之前
• 包的構建
• 執行、除錯與匯出

適用版本

國際版

≥ 1.16.100.59

實踐裝置

所需軟體

◄◄ 方塊

實體 ►

戰利品表 ►►

  本頁面介紹的是自訂配方教學。關於配方開發資訊，請見「配方」。

在閱讀本教學前，請先確保自身已有一定的附加包基礎。在瀏覽完本教學之後，你將學會如何自訂配方。

概述

配方使遊戲元素更加豐富，並為許多內容加入了取得途徑。在學習了自訂物品和方塊後，您已經為遊戲加入了一些新元素，現在將嘗試學習透過自訂配方來為它們加入取得的途徑。

配方儲存在行為包的recipes資料夾中。

在這之前

加入自訂配方首先需要了解一下自訂配方 行為部分的基本結構。 自訂配方組態檔的資料結構如下：

{
  "format_version": "1.12",
  "各配方适用组件": {
    "description": {  },//描述
    "tags": [ ],//标签(适用方块)
  }
}

如上，配方組態檔基本由描述、配方類別、配方輸入、配方材料與配方輸出五部分內容構成，而配方輸入、配方材料和配方輸出需要定義各型別配方自有的元件才能被定義。下面對上述基本內容進行了簡要闡述：
描述 (description) 物件儲存了用於描述該配方的基礎資訊，其資料結構如下：

//...
"description": {
  "identifier": "配方的赋命名空间标识符"
},
//...

該屬性用於在應用於某個世界的所有包中唯一標識配方。配方識別碼沒有名稱空間要求，只要單個包中沒有兩個相同的配方識別碼可以匹配即可。
配方標籤（tags）陣列儲存了用於描述該配方適用於哪種配方功能方塊，其內容如下：

//...
"tag": [
  "crafting_table",//说明该配方可适用于原版工作台
  ...//可多选
]
//...

你已經掌握了配方組態檔基本概念，接下來是各個配方的細微差異

合成配方

有序配方

主條目：有序配方

有序配方定義了一個需要固定合成形狀的配方，須使用"minecraft:recipe_shaped"才能被定義。

有序配方特殊的是需要定義形狀，因此和其他配方的定義格式不同，在於多了樣式陣列和各組成部分的定義，以下是詳細描述：

樣式 (pattern) 陣列儲存了用於描述該配方的排列樣式，其內容中有多組字串，每組字串代表合成表中的一行，字串由1-3個字元組成，每個字元在該配方中代表一個物品。 如果您需要將某一格留空，請使用空格，如果某一列為空，請刪除代表本列的空格。 下面是一個配方的樣式範例

    "pattern": [
      "XX",
      "X#",
      " #"
    ]

此配方代表一個類似於原版斧的配方排列方式。 配方材料（key）物件儲存了用於描述該配方樣式中的字元代表的物品，物品可以透過字串引用或items物件，字串引用的內容如下:

"字符":"物品的赋命名空间标识符:物品特殊值"//:物品特殊值为可选项，不填则所有特殊值均可

items物件的內容如下:

      "字符": {
        "item": "物品赋命名空间标识符"
        "data": "物品特殊值，支持Molang，可选项"
        "count": "物品数量，可选项"//此处不可用，物品数量仅在items对象作为工作台配方的合成结果时可用。
      }

下面是原版斧的配方

{
  "format_version": "1.12",
  "minecraft:recipe_shaped": {
    "description": {
    "identifier": "minecraft:diamond_axe"
    },
    "tags": [ "crafting_table" ],
    "pattern": [
      "XX",
      "X#",
      " #"
    ],
    "key": {
      "#": {
        "item": "minecraft:stick"
      },
      "X": {
        "item": "minecraft:diamond"
      }
    },
    "result": {
      "item": "minecraft:diamond_axe"
    }
  }
}

結果 (result) 物件儲存了用於描述該配方的製作結果的物品，物品可以透過字串引用或items物件，引用方法同上。

無序配方

主條目：無序配方

無序配方與有序配方的基本結構同理，只不過將"minecraft:recipe_shaped"元件替換成"minecraft:recipe_shapeless"元件以實現無序配方。

以下是原版合成打火石無序配方的json檔案：

{
  "format_version": "1.12",
  "minecraft:recipe_shapeless": {
    "description": {
    "identifier": "minecraft:flint_and_steel"
    },
    "tags": [ "crafting_table" ],
    //与有序配方不同处
    "ingredients": [
      {
        "item": "minecraft:iron_ingot"
      },
      {
        "item": "minecraft:flint"
      }
    ],
    "result": {
      "item": "minecraft:flint_and_steel"
    }
  }
}

由此可見，無序配方與有序配方的不同處是將"pattern"和"key"的子元件替換成"ingredients"的子元件。

"ingredients"子元件只需要建立若干個json物件存放"item"元件，輸入需要物品的賦命名空間識別碼即可。

熔爐配方

主條目：熔爐配方

熔爐配方同理，也是替換成熔爐配方所適用的"minecraft:recipe_furnace"元件。

下面以原版生雞肉透過熔爐等烹飪獲得烤雞的json檔案為例：

{
  "format_version": "1.12",
  "minecraft:recipe_furnace": {
    "description": {
    "identifier": "minecraft:furnace_chicken"
    },
    "tags": ["furnace", "smoker", "campfire", "soul_campfire"],
    //与其他配方不同处
    "input": "minecraft:chicken",//输入
    "output": "minecraft:cooked_chicken"//输出
  }
}

由此可見，熔爐配方僅需加入"input"和"output"元件，再輸入需要物品的賦命名空間識別碼即可。

釀造配方

主條目：釀造配方
釀造配方與其他配方類似，不過會依據原版特性細分，具體如下：

藥水容器型別配方

此為藥水改變瓶子型別的配方組態，須加入"minecraft:recipe_brewing_container"元件。 此為原版藥水透過火藥煉成飛濺型藥水的json組態檔：

{
"format_version": "1.12",
"minecraft:recipe_brewing_container": {
"description": {
  "identifier": "minecraft:brew_potion_sulphur"
  },
  "tags": [ "brewing_stand" ],
  "input": "minecraft:potion",
  "reagent": "minecraft:gunpowder",
  "output": "minecraft:splash_potion"
  }
}

藥水效果配方

此為合成藥水效果的配方，須加入"minecraft:recipe_brewing_mix"元件決定該配方。 以下是原版基礎藥水用烈焰粉合成力量藥水的json組態檔：

{
"format_version": "1.12",
"minecraft:recipe_brewing_mix": {
"description": {
  "identifier": "minecraft:brew_awkward_blaze_powder"
  },
  "tags": [ "brewing_stand" ],
  "input": "minecraft:potion_type:awkward",
  "reagent": "minecraft:blaze_powder",
  "output": "minecraft:potion_type:strength"
  }
}

由此可見，釀造配方與熔爐配方類似，只不過增加了"reagent"子元件指定加工物。

< 方塊 | 戰利品表 >