Skip to content

Placeholder Reference

PlaceholderAPI Placeholders

Expansion identifier: emakiitem

When PlaceholderAPI is installed, EmakiItem registers the following placeholders.

PlaceholderDescriptionExample
%emakiitem_held_id%EmakiItem definition ID of the main-hand item.shadow_blade
%emakiitem_loaded_count%Total number of loaded item definitions.156

Usage Example

yaml
lore:
  - '<gray>Item ID: <white>%emakiitem_held_id%'
  - '<gray>Loaded Definitions: <white>%emakiitem_loaded_count%'

Action Context Variables

When item actions (EmakiItemActionService) are triggered, the following variables are injected into the action context:

VariableDescriptionExample
%player%Player name.Steve
%item_id%EmakiItem definition ID.shadow_blade
%item_trigger%Trigger name.right_click
%item_name%Item display name (plain text).Shadow Blade

Action Example

yaml
actions:
  - type: message
    value: '<green>%player% used %item_name%!'
  - type: command
    value: 'effect give %player% speed 10 1'

Notes

  • When the player holds no EmakiItem, held_id returns an empty string.
  • loaded_count is a global value independent of player state, suitable for admin panels.
  • External plugin items without EmakiItem PDC tags cannot be recognized as EmakiItem.
  • CoreLib built-in context variables (%player_name%, %player_uuid%, etc.) are also available in item actions.