CoreLib 动作

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

无参数。

示例

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 失败并沿用服务原有的提示文本。