CoreLib 动作

EmakiCooking 启用后会向 CoreLib 动作注册表追加营养值、阈值复查和配方奖励动作。它们可用于其他模块的动作列表、CoreLib 动作模板，或第三方通过 CoreLib ActionExecutor 触发的动作链。

本页只记录 EmakiCooking 注册的 CoreLib 动作；CoreLib 自带通用动作见 CoreLib 动作系统。当前 Action ID 只使用下表中的规范名，不再提供历史别名入口。

动作 ID

动作 ID	操作	说明
emakicookingaddnutrition	增加营养值	增加指定营养类型当前值。
emakicookingremovenutrition	扣除营养值	扣除指定营养类型当前值。
emakicookingsetnutrition	设置营养值	设置指定营养类型当前值。
emakicookingclearnutrition	清空营养值	将指定类型或全部类型设为各自 min。
emakicookingresetnutrition	重置营养值	将指定类型或全部类型设为各自 default。
emakicookingrechecknutritionthreshold	复查阈值	重新检查在线玩家营养阈值，不清空边沿状态。
emakicookingrunrecipereward	执行配方奖励	通过 CookingRewardService 执行已加载配方的某个结果分支。

营养增减/设置

参数	类型	必填	默认值	说明
type	STRING	是	—	营养类型 ID。
amount	STRING	是	—	营养数值或表达式。
target	STRING	否	当前玩家	目标玩家名或 UUID。留空时使用动作上下文玩家。
silent	BOOLEAN	否	false	是否抑制可选输出。

actions:
  - 'emakicookingaddnutrition type=satiety amount=5'
  - 'emakicookingremovenutrition type=hydration amount=3 silent=true'
  - 'emakicookingsetnutrition target=PlayerName type=hydration amount=80'

清空/重置营养

emakicookingclearnutrition 会把营养值设为对应类型的 min；emakicookingresetnutrition 会设为对应类型的 default。type 为空时处理全部已注册营养类型。

参数	类型	必填	默认值	说明
type	STRING	否	""	营养类型 ID。为空时处理全部类型。
target	STRING	否	当前玩家	目标玩家名或 UUID。
silent	BOOLEAN	否	false	是否抑制可选输出。

actions:
  - 'emakicookingclearnutrition type=hydration'
  - 'emakicookingresetnutrition target=PlayerName'

阈值复查

emakicookingrechecknutritionthreshold 重新检查在线玩家的营养阈值；如果营养系统或阈值系统未启用，动作会失败。

参数	类型	必填	默认值	说明
target	STRING	否	当前玩家	目标在线玩家名或 UUID。
silent	BOOLEAN	否	false	是否抑制可选输出。

actions:
  - 'emakicookingrechecknutritionthreshold target=PlayerName'

配方奖励动作

emakicookingrunrecipereward 会查找已加载配方，并通过 CookingRewardService 的统一出口发放产物、执行结果动作。它不会临时构造新配方；recipe 必须已经由对应工位加载器加载。

参数	类型	必填	默认值	说明
recipe	STRING	是	—	配方 ID。
station	STRING	否	""	工位目录名；为空时遍历所有工位加载器。
outcome	STRING	否	success	结果路径或短名，如 success、perfect、result.success。
target	STRING	否	当前玩家	目标在线玩家名或 UUID。
drop_result	BOOLEAN	否	false	是否把产物掉落在玩家位置，而不是进入背包。
include_outputs	BOOLEAN	否	true	是否发放结果分支中的 outputs。
include_actions	BOOLEAN	否	true	是否执行结果分支中的 actions。
phase	STRING	否	自动生成	Action phase 覆盖值。
silent	BOOLEAN	否	false	是否抑制可选输出。

actions:
  - 'emakicookingrunrecipereward recipe=apple_pie station=oven outcome=success target=PlayerName'
  - 'emakicookingrunrecipereward recipe=tea outcome=result.perfect drop_result=true include_actions=false'

使用提示

• target 为空时必须存在玩家上下文；控制台或无玩家上下文动作链中请填写在线玩家名或 UUID。
• amount 支持表达式时，会读取当前动作上下文中的数值型占位符和属性作为变量；无法解析的表达式会按 0 处理。
• 如果营养系统、阈值系统或配方奖励服务尚未就绪，对应动作会失败而不是静默跳过。