Placeholder Reference

PlaceholderAPI Placeholders

Expansion identifier: emakigem

When PlaceholderAPI is installed, EmakiGem registers the following placeholders. All placeholders read gem data from the player's main-hand item.

Placeholder	Description	Example
%emakigem_mainhand_opened_slots%	Number of opened gem slots.	3
%emakigem_mainhand_total_slots%	Total slots defined on the item.	5
%emakigem_mainhand_filled_slots%	Slots with a gem socketed.	2
%emakigem_mainhand_item_definition_id%	Gem item definition ID of the main-hand item.	gem_socket_ring
%emakigem_mainhand_resonance_count%	Number of active resonances.	2
%emakigem_mainhand_slot_<n>_gem%	Gem ID at slot index n.	ruby
%emakigem_mainhand_slot_<n>_level%	Gem level at slot n.	3
%emakigem_mainhand_slot_<n>_opened%	Whether slot n is opened.	true
%emakigem_mainhand_slot_<n>_type%	Slot type at index n.	universal

Usage Example

lore:
  - '<gray>Slots: <white>%emakigem_mainhand_filled_slots%/%emakigem_mainhand_opened_slots%'
  - '<gray>Slot 1: <white>%emakigem_mainhand_slot_0_gem% Lv.%emakigem_mainhand_slot_0_level%'

Internal Template Variables

GemSnapshotBuilder provides the following template variables in the item's structured_presentation.

Item-Level Variables

Used in the item's overall lore template:

Variable	Description	Example
%item_definition_id%	Gem item definition ID.	gem_socket_ring
%opened_slots%	Number of opened slots.	3
%total_slots%	Total slot count.	5
%slot_icons%	Rendered slot icon string.	◆◆◇◇◇

Per-Slot Variables

Used in each socketed gem's lore template:

Variable	Description	Example
%slot_index%	Slot index.	0
%slot_type%	Slot type string.	universal
%slot_name%	Slot display name.	Universal
%gem_id%	Gem definition ID.	ruby
%display_name%	Gem display name at current level.	<red>Ruby III
%old_display_name%	Gem display name at previous level.	<red>Ruby II
%current_level%	Current gem level.	3
%target_level%	Target gem level.	3
%tier%	Gem tier.	2
%gem_type%	Gem type.	universal
{<stat_id>}	Formatted stat value for the gem at this level (dynamic).	15

Template Example

structured_presentation:
  lore_actions:
    - action: "append"
      content:
        - "<gray>Slots: %slot_icons% (%opened_slots%/%total_slots%)"

gem_slot_presentation:
  lore_actions:
    - action: "append"
      content:
        - "<gray>[%slot_name%] %display_name% <gray>Lv.%current_level%"
        - "<gray>  Attack: <white>+%physical_attack%"

Notes

• <n> in PlaceholderAPI placeholders is the slot index, starting from 0.
• When the main-hand item has no gem data, placeholders return 0 or an empty string.
• Internal template variables only work within Gem's structured_presentation.
• {<stat_id>} is dynamic and depends on stat keys configured in the gem definition.