Skip to content

CoreLib 动作

EmakiForge 启用后会向 CoreLib 动作注册表追加锻造物品刷新段。它们用于在配置管道中重建锻造层、刷新玩家背包中的锻造物品,或在批量配置变更后刷新在线玩家物品。

NOTE

本页只记录 EmakiForge 注册的段;CoreLib 自带通用段见 CoreLib 动作系统。当前段 ID 只使用下表中的规范名,不再提供历史别名入口。旧的 emakiforge_refresh_held 现在写作 forge_refresh_held,另外两个同理。

段 ID

段 ID用途目标要求
forge_refresh_held刷新目标玩家主手的锻造物品。REQUIRED_ENTITY
forge_refresh_player刷新目标玩家背包内的锻造物品。REQUIRED_ENTITY
forge_refresh_all刷新全部在线玩家的锻造物品。NONE

参数

这三个段不读取额外参数。

示例

yaml
actions:
  - 'self | forge_refresh_held'
  - 'self | forge_refresh_player'
  # 不需要目标,可省略 source
  - 'forge_refresh_all'

使用提示

  • forge_refresh_held 只处理主手物品;玩家主手为空时该段会跳过。
  • forge_refresh_player 需要玩家目标,会调用 EmakiForge 刷新服务处理该玩家背包。
  • forge_refresh_all 目标要求是 NONE,可以单独成为一条管道,适合管理员管道模板或配置变更后的批量刷新。它会等待异步刷新完成,最长等待 20 秒;超时、部分失败,或刷新期间配置世代发生变化,都会以失败结束。