CoreLib 动作

EmakiGem 启用后会向 CoreLib 动作注册表追加主手宝石层操作动作。它们都作用于当前玩家主手装备，并在需要时读取副手开孔器或宝石物品。

本页只记录 EmakiGem 注册的 CoreLib 动作；CoreLib 自带通用动作见 CoreLib 动作系统。当前 Action ID 只使用下表中的规范名，不再提供历史别名入口。

动作 ID

动作 ID	用途	主要输入
emakigem_open_socket	使用副手开孔器为主手装备开孔。	主手装备、副手开孔器、opener
emakigem_inlay	将副手宝石镶嵌到主手装备指定孔位。	主手装备、副手宝石、slot
emakigem_extract	从主手装备指定孔位提取宝石。	主手装备、slot
emakigem_upgrade_gem_item	升级主手宝石物品。	主手宝石
emakigem_clear_layer	清除主手装备的宝石层。	主手装备

参数

动作 ID	参数	说明
emakigem_open_socket	opener 必填；slot=-1；bypass=false	opener 是开孔器 ID；slot=-1 表示由服务选择孔位；bypass=true 跳过开孔器物品需求。
emakigem_inlay	slot 必填；bypass_cost=false	将副手宝石镶嵌到指定孔位；成功后消耗副手宝石。
emakigem_extract	slot 必填；bypass_cost=false	从指定孔位提取宝石；提取出的宝石进入背包，背包满时掉落。
emakigem_upgrade_gem_item	bypass_cost=false	对主手宝石物品执行升级服务。
emakigem_clear_layer	无	清除主手物品已存储的宝石层。

示例

actions:
  - 'emakigem_open_socket opener=basic_socket_opener slot=-1'
  - 'emakigem_open_socket opener=admin_opener slot=0 bypass=true'
  - 'emakigem_inlay slot=0'
  - 'emakigem_extract slot=0 bypass_cost=true'
  - 'emakigem_upgrade_gem_item bypass_cost=false'
  - 'emakigem_clear_layer'

使用提示

• 本页所有动作都需要玩家上下文。
• 开孔与镶嵌动作读取玩家主手装备；开孔还读取副手开孔器，镶嵌读取副手宝石。
• 动作调用 Gem 模块的现有服务，因此仍会使用开孔器、镶嵌、提取、升级配置中的成本与校验；bypass / bypass_cost 只跳过对应服务支持的消耗检查。