CoreLib 动作

EmakiGem 注册到 CoreLib 动作注册表的段, 每段的参数定义与动作行写法, 便于直接复制使用

前置条件: EmakiGem 启用. 满足后, EmakiGem 向 CoreLib 动作注册表追加主手宝石层操作段. 所有段都作用于目标玩家的主手装备, 并在需要时读取副手开孔器或宝石物品

NOTE

这里只记录 EmakiGem 注册的段; CoreLib 自带通用段见 CoreLib 动作系统. 当前段 ID 只使用下表中的规范名, 不再提供历史别名入口. 旧的 emakigem_inlay 现在写作 gem_inlay, 其余同理. 旧的 emakigem_upgrade_gem_item 已移除, 没有对应的段

段 ID

四个段的目标要求都是 REQUIRED_ENTITY, 非玩家目标会跳过

段 ID	用途	主要输入
`gem_open_socket`	使用副手开孔器为主手装备开孔	主手装备, 副手开孔器, `opener`
`gem_inlay`	将副手宝石镶嵌到主手装备指定孔位	主手装备, 副手宝石, `slot`
`gem_extract`	从主手装备指定孔位提取宝石	主手装备, `slot`
`gem_clear_layer`	清除主手装备的宝石层	主手装备

参数

gem_open_socket

参数	类型	必填	默认值	说明
`opener`	STRING	是	—	开孔器 ID
`slot`	INTEGER	否	`-1`	目标孔位; `-1` 表示由服务选择孔位
`bypass`	BOOLEAN	否	`false`	跳过开孔器物品需求

gem_inlay / gem_extract

参数	类型	必填	默认值	说明
`slot`	INTEGER	是	—	目标孔位
`bypass_cost`	BOOLEAN	否	`false`	跳过配置中的消耗

gem_clear_layer

无参数

示例

yaml

actions:
  - 'self | gem_open_socket opener=basic_socket_opener slot=-1'
  - 'self | gem_open_socket opener=admin_opener slot=0 bypass=true'
  - 'self | gem_inlay slot=0'
  - 'self | gem_extract slot=0 bypass_cost=true'
  - 'self | gem_clear_layer'

使用提示

读取规则: 开孔与镶嵌读取目标玩家的主手装备; 开孔额外读取副手开孔器, 镶嵌额外读取副手宝石
消耗规则: gem_inlay 成功后消耗一个副手宝石. 若服务判定本次操作已消耗输入但仍返回失败, 宝石同样扣除, 避免免费重试
提取结果: gem_extract 提取出的宝石进入背包, 背包满时掉落在玩家脚下
配置复用: 这些段调用 Gem 模块的现有服务, 因此仍按开孔器, 镶嵌, 提取配置中的成本与校验执行; bypass / bypass_cost 只跳过对应服务支持的消耗检查
失败处理: 服务按自身规则拒绝操作 (例如缺少开孔器, 孔位已占用) 时, 该段以 REJECTED 失败并沿用服务原有的提示文本

CoreLib 动作 ​

段 ID ​

参数 ​

gem_open_socket ​

gem_inlay / gem_extract ​

gem_clear_layer ​

示例 ​

使用提示 ​