CoreLib Actions

When EmakiGem is enabled, it adds main-hand gem-layer actions to the CoreLib action registry. These actions operate on the current player's main-hand equipment and, when needed, read the off-hand socket opener or gem item.

This page documents only CoreLib actions registered by EmakiGem. CoreLib built-in actions are documented in CoreLib Actions. Current action IDs use only the canonical names below; historical aliases are no longer registered.

Action IDs

Action ID	Purpose	Main input
emakigem_open_socket	Opens a socket on the main-hand equipment using the off-hand opener.	Main-hand equipment, off-hand opener, opener
emakigem_inlay	Inlays the off-hand gem into a socket on the main-hand equipment.	Main-hand equipment, off-hand gem, slot
emakigem_extract	Extracts a gem from one socket on the main-hand equipment.	Main-hand equipment, slot
emakigem_upgrade_gem_item	Upgrades the main-hand gem item.	Main-hand gem
emakigem_clear_layer	Clears the main-hand item's gem layer.	Main-hand equipment

Parameters

Action ID	Parameters	Description
emakigem_open_socket	required opener; slot=-1; bypass=false	opener is the socket opener ID. slot=-1 lets the service choose a slot. bypass=true skips the opener item requirement.
emakigem_inlay	required slot; bypass_cost=false	Inlays the off-hand gem into the target slot. On success, the off-hand gem is consumed.
emakigem_extract	required slot; bypass_cost=false	Extracts the gem from the target slot. Returned gems go to inventory, or drop if inventory is full.
emakigem_upgrade_gem_item	bypass_cost=false	Runs the gem upgrade service for the main-hand gem item.
emakigem_clear_layer	none	Clears the stored gem layer from the main-hand item.

Examples

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'

Notes

• Every action on this page requires a player context.
• Socket opening and inlay read the player's main-hand equipment. Opening also reads the off-hand opener; inlay reads the off-hand gem.
• Actions call the existing Gem services, so configured socket opener, inlay, extraction, upgrade costs, and validation still apply. bypass / bypass_cost only skips the cost checks supported by that service.