CraftByCommand

CraftByCommand

使用命令制作物品,即使需要大量资源!

使用命令合成物品!

完全可自定义的命令合成配方模组!

面向玩家

要合成,请执行 /craft 或 /c,然后输入配方 id。它们会被自动补全提示。

要查看某个配方的所需资源,请执行 /seeRecipe、/resourcesFor 或 /sr,然后输入配方 id。它们会被自动补全提示。

面向服务器管理员

配方制作系统非常技术化。以下是一个示例配方:

{
  "id": "normal:milk_bucket",
  "result": {
    "id": "minecraft:bucket",
    "count": 1
  },
  "ingredients": [
    {
      "id": "minecraft:milk_bucket",
      "count": 1
    }
  ]
}

这个配方会消耗一个牛奶桶并将其转换为一个空桶。它会忽略原桶的数据。

以下是一个使用相同桶、但带有自定义名称的示例(如何添加 minecraft 数据):

{
  "id": "normal:milk_bucket",
  "result": {
    "id": "minecraft:milk_bucket",
    "count": 1,
    "components": {
      "minecraft:custom_name": {
        "text": "",
        "extra": [
          {
            "text": "M",
            "color": "#424242",
            "italic": false
          },
          {
            "text": "i",
            "color": "#818181",
            "italic": false
          },
          {
            "text": "l",
            "color": "#C0C0C0",
            "italic": false
          },
          {
            "text": "k",
            "color": "white",
            "italic": false
          }
        ]
      }
    }
  },
  "ingredients": [
    {
      "id": "minecraft:milk_bucket",
      "count": 1
    }
  ]
}

接下来是自定义物品,就像这个:

{
  "id": "osc:fixed_stab",
  "result": {
    "id": "custom:stab_fixed",
    "extra": {}
  },
  "ingredients": [
    {
      "id": "minecraft:tnt",
      "count": 500
    },
    {
      "id": "minecraft:fishing_rod",
      "match": {
        "forbidden": [
          "components.minecraft:custom_data.oc_type"
        ]
      }
    }
  ]
}

这个配方做两件事。首先,结果物品中的 'custom:' 将在 面向开发者 部分进行说明。这里的 'match' 才是有趣的部分:'forbidden' 表示该原料 不应 带有 'components.minecraft:custom_data.oc_type'(无论其数据是什么)。如果是 'required',那么该物品 必须 带有此数据。这用于限制可以使用哪些物品(在这里,就是不要使用轨道钓鱼竿来合成其他轨道物品)。

 

面向开发者

这里,我们将讨论我们的 'custom:' 标记。它意味着模组会取 id 的另一部分(对于 custom:myitem,它会取 myitem),并将其传递给所有已注册的 executors。你通过向 Registry 类中的 registerExecutor 方法提供一个 modid 和一个 BiFunction<Recipe.ResultContainer, ServerPlayerEntity, ItemStack> 来注册它。结果容器让你可以访问该 id 以及 extra 数据(在前面的示例中为空),可用于额外的自定义,player 是合成者,itemstack 是你返回的物品(给予玩家)。

模组会将配方容器应用到所有模组的函数上,并返回找到的第一个非 null 的物品堆叠。因此,如果你的 executor 收到一个未知的 id,你应该返回 null。为避免重复 id(即同一个模组会根据谁在映射中排第一而返回它的物品堆叠),请考虑使用类似 custom:mymod_myitem 的写法。避免使用两个冒号。