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