Repository navigation
RecipeConditions
Qi-Month edited this page Nov 17, 2026
·
1 revision
本模组提供两种配方条件, 用于在物品或流体不存在时跳过整份配方. 条件写在配方的条件数组中, 由加载器读取配方时求值; 结果为假则整份配方不加载, 效果等同于该文件不存在.
| 条件类型 | 判定对象 |
|---|---|
steam_letters:has_item |
物品注册表项或物品标签 |
steam_letters:has_fluid |
流体注册表项或流体标签 |
两种条件都以注册表查询为准, 不检查资源文件是否存在. 传入标签时判断该标签是否至少含有一个成员, 而不是标签文件是否存在.
按注册表 id 判断:
{
"type": "steam_letters:has_fluid",
"fluid": "minecraft:lava"
}按标签判断:
{
"type": "steam_letters:has_fluid",
"tag": "forge:diesel"
}物品条件把 fluid 换成 item, 其余一致. item 与 tag 二选一, 同时给出或都不给出会在读取时抛出异常.
条件写在配方的 conditions 数组中, 与机械动力的加工配方一致:
{
"type": "steam_letters:solid_fuel",
"conditions": [
{
"type": "steam_letters:has_item",
"tag": "forge:coal_coke"
}
],
"ingredients": [
{
"tag": "forge:coal_coke"
}
],
"results": [],
"processingTime": 3200
}标签的命名空间随版本变化, 见 Home 的版本差异表.
条件在配方加载阶段求值, 此时标签已经合并完毕, 因此可以引用其它模组声明的标签. 条件为假时配方不会进入配方管理器, 相关设备也就找不到这份燃料.
已加载的配方不会因为标签后来发生变化而重新判定, 变更标签后需要重新加载资源.
条件类型 id 在两个版本中一致, 同一份 JSON 在切换版本后仍按名称对应.
| 项目 | 1.20.1 | 1.21.1 |
|---|---|---|
| 接口 | Forge ICondition
|
NeoForge ICondition
|
| 序列化 |
IConditionSerializer, 注册到 CraftingHelper
|
MapCodec, 注册进条件编解码器的注册表 |
| 注册位置 | dev.celestiacraft.steam_letters.common.register.SlConditionTypes |
同左 |
内置燃料配方中的条件由数据生成器写出, 见 燃料配方.