Skip to content

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 同左

内置燃料配方中的条件由数据生成器写出, 见 燃料配方.

Clone this wiki locally