CoreLib Actions

Prerequisite: EmakiGem enabled. Once enabled, EmakiGem adds main-hand gem-layer stages to the CoreLib action registry, listed below with each stage's parameters and exact action-line syntax. They all operate on the target player's main-hand equipment and, when needed, read the off-hand socket opener or gem item

NOTE

Only the stages registered by EmakiGem are covered below. CoreLib built-in stages are documented in CoreLib Actions. Current stage IDs use only the canonical names below; historical aliases are no longer registered. The old emakigem_inlay is now written gem_inlay, and the others follow the same rule. The old emakigem_upgrade_gem_item has been removed and has no replacement stage

Stage IDs

All four stages declare REQUIRED_ENTITY, and non-player targets are skipped

Stage ID	Purpose	Main input
gem_open_socket	Opens a socket on the main-hand equipment using the off-hand opener	Main-hand equipment, off-hand opener, opener
gem_inlay	Inlays the off-hand gem into a socket on the main-hand equipment	Main-hand equipment, off-hand gem, slot
gem_extract	Extracts a gem from one socket on the main-hand equipment	Main-hand equipment, slot
gem_clear_layer	Clears the main-hand item's gem layer	Main-hand equipment

Parameters

gem_open_socket

Parameter	Type	Required	Default	Description
opener	STRING	Yes	—	Socket opener ID
slot	INTEGER	No	-1	Target socket slot; -1 lets the service choose one
bypass	BOOLEAN	No	false	Skips the opener item requirement

gem_inlay / gem_extract

Parameter	Type	Required	Default	Description
slot	INTEGER	Yes	—	Target socket slot
bypass_cost	BOOLEAN	No	false	Skips the configured cost

gem_clear_layer

No parameters

Examples

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'

Notes

• Read scope: socket opening and inlay read the target player's main-hand equipment. Opening also reads the off-hand opener; inlay reads the off-hand gem
• Consumption rule: gem_inlay consumes one off-hand gem on success. If the service reports the input as already consumed but the operation still failed, the gem is subtracted as well, so the player does not get a free retry
• Extraction result: gems returned by gem_extract go to the inventory, or drop at the player's feet if the inventory is full
• Config reuse: these stages call the existing Gem services, so configured socket opener, inlay, and extraction costs and validation still apply. bypass / bypass_cost only skips the cost checks supported by that service
• Failure handling: when a service declines an operation by its own rules (a missing opener, an occupied slot), the stage fails with REJECTED and reuses the service's existing player-facing message