Skip to content

CoreLib 动作 ​

EmakiForge 注册到 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

参数 ​

这三个段都不会读额外参数 (parameters() 是空列表), 段的分类 (category()) 都是 forge

示例 ​

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 秒; 超时, 部分失败, 或者刷新期间配置的世代发生了变化, 都会以失败结束