创建自定义配方生成器

block = "croparia:infusor"
path = "example/infusor_${datetime}.json"
extensions = "croparia:infusor"
template = """
{
  "type": "croparia:infusor",
  "element": "${infusor_element}",
  "ingredient": ${item._qis},
  "result": ${off_hand._qis}
}
"""

完整字段

RecipeWizardGenerator 的字段来自源码中的 CODEC，完整如下：

enabled: boolean
dependencies: Dependencies
block: BlockInput
path: Template
extensions: ResourceLocation | ResourceLocation[]
template: Template

下面分别说明。

`enabled`

类型：boolean
可选，默认值是 true

用于控制这个配方生成器是否启用。禁用后，文件会被读取，但不会加入可用的模板列表。

`dependencies`

类型：依赖对象
可选，默认值为空

它的作用和其他文档中的“依赖判断”类似：只有依赖满足时，这个生成器文件才会被加载。

如果依赖不满足，源码会直接跳过这个文件，而不是报错继续使用。

`block`

类型：BlockInput
必填

用于决定“这个生成器会对哪种目标方块生效”。

只有当玩家右键的方块状态能被 block 匹配时，这个生成器才会触发。

示例：

block = "croparia:infusor"
block = "#croparia:ritual_stands"

`path`

类型：Template
必填

表示生成结果相对于 recipeWizard 输出目录的相对路径。

例如：

path = "croparia/ritual_${datetime}.json"

如果配置中的 recipeWizard 目录是 D:/packs/croparia/recipe_wizard/output，最终就会写到：

D:/packs/croparia/recipe_wizard/output/croparia/ritual_2026-04-06_12.30.00.json

path 本身也是模板，所以可以使用本页后面介绍的各种占位符。

`extensions`

类型：string 或 string[]
可选，默认值为空列表

这里填的不是普通文本，而是一组“扩展占位符分组 ID”。源码目前注册了以下几组：

croparia:infusor
croparia:ritual
croparia:soak
minecraft:furnace

default 组会始终自动启用，不需要手写。

如果你要使用某一组扩展提供的占位符，就必须把它写进 extensions。例如：

extensions = "croparia:ritual"

或：

extensions = [
  "croparia:ritual",
  "minecraft:furnace"
]

`template`

类型：Template
必填

表示最终要写出的文件内容，通常就是一段 JSON 模板。

它会在点击时解析占位符，并把结果写入磁盘。

示例：

template = """
{
  "type": "croparia:soak",
  "element": "${soak_element}",
  "input": ${neighbor._qis},
  "output": ${below._qis},
  "probability": 1.0
}
"""

模板语法本身与占位符解析器一致。

默认占位符

无论是否填写 extensions，default 组占位符都会自动启用。

这些占位符都来自点击时的 UseOnContext。

${datetime}
- 当前时间戳，格式是 yyyy-MM-dd_HH.mm.ss
${main_hand}
- 主手物品，类型相当于 ItemOutput
${off_hand}
- 副手物品，类型相当于 ItemOutput
${item}
- 点击位置上的掉落物，类型相当于 ItemOutput
${block}
- 当前点击的方块，类型相当于 BlockOutput
${neighbor}
- 四周任意一个非空气方块，类型相当于 BlockOutput
${below}
- 下方方块，类型相当于 BlockOutput

其中 block 还有几个常用子路径：

${block.facing}：点击面前方的方块
${block.opposite}：点击面反方向的方块
${block.left}：点击面顺时针方向一侧的方块
${block.right}：点击面逆时针方向一侧的方块
${block.offset(x,y,z)}：相对点击位置偏移的方块

这些值大多是结构化类型，所以通常要像内置模板一样配合 _qis 使用，例如：

${item._qis}
${block._qis}
${neighbor._qis}

如果缺少所需上下文，例如主手没有物品、目标位置没有掉落物，源码会直接弹出覆盖提示并中止生成。

扩展占位符

extensions 会决定额外启用哪些领域相关的占位符。

`croparia:infusor`

${infusor_element}

要求点击目标是已经注入元素的注魔台。如果元素为空，会提示玩家先给注魔台注入元素。

`croparia:ritual`

${ritual_input}

要求点击目标是仪式台，并且当前结构能正确识别出输入方块位置。这个占位符会返回仪式结构中 $ 位置的输入方块。

`croparia:soak`

${soak_element}

要求点击的是元素石，且其上方存在带元素状态的注魔台。返回值是当前浸润使用的元素名。

`minecraft:furnace`

${furnace_input}
${furnace_time}

这组扩展面向熔炉类方块：

furnace_input 读取输入槽的物品
furnace_time 读取当前燃料总燃烧时长

如果目标不是熔炉，或输入/燃料槽为空，也会直接弹出提示并终止生成。

内置模板示例

当前 1.1.0a 内置了三份模板，正好也反映了最典型的写法。

注魔台配方

path = "croparia/infusor_${datetime}.json"
extensions = "croparia:infusor"
block = "croparia:infusor"
template = """
{
  "type": "croparia:infusor",
  "element": "${infusor_element}",
  "ingredient": ${item._qis},
  "result": ${off_hand._qis}
}
"""

仪式配方

path = "croparia/ritual_${datetime}.json"
extensions = "croparia:ritual"
block = "#croparia:ritual_stands"
template = """
{
  "type": "croparia:ritual",
  "ritual": ${block._qis},
  "ingredient": ${item._qis},
  "block": ${ritual_input._qis},
  "result": ${off_hand._qis}
}
"""

浸润配方

path = "croparia/soak_${datetime}.json"
extensions = "croparia:soak"
block = "croparia:elemental_stone"
template = """
{
  "type": "croparia:soak",
  "element": "${soak_element}",
  "input": ${neighbor._qis},
  "output": ${below._qis},
  "probability": 1.0
}
"""

这些例子里最值得注意的是两点：

block 负责决定“什么时候触发”，不是决定生成结果中的输入方块
生成 JSON 时，ItemOutput / BlockOutput 这类结构通常都要用 _qis 转成可直接嵌入 JSON 的文本

使用建议

第一次自定义时，先复制内置模板改一份，比从零写更稳。
path 最好带上 ${datetime}，避免重复点击时覆盖旧文件。
如果一个模板需要多个特殊上下文，一定先确认对应的 extensions 都已经写上。
目标方块匹配只看 block，而不是看模板里用了哪些占位符。
生成出来的内容通常还是 JSON 配方文件，后续可以继续结合配方与结构检查字段是否符合预期。

In This Page

当前页面没有可提取的二级及以下标题。