占位符参考

PlaceholderAPI 占位符

扩展标识符：emakiitem

安装 PlaceholderAPI 后，EmakiItem 会自动注册以下占位符。

占位符	说明	示例
%emakiitem_held_id%	主手物品的 EmakiItem 定义 ID。	shadow_blade
%emakiitem_held_name%	主手物品的显示名（纯文本）。	影刃
%emakiitem_loaded_count%	当前已加载的物品定义总数。	156

使用示例

lore:
  - '<gray>物品 ID: <white>%emakiitem_held_id%'
  - '<gray>已加载定义: <white>%emakiitem_loaded_count%'

动作上下文变量

物品动作（EmakiItemActionService）触发时，以下变量会注入到 Action 上下文中：

变量	说明	示例
%player%	玩家名称。	Steve
%item_id%	EmakiItem 定义 ID。	shadow_blade
%item_trigger%	触发器名称。	right_click
%item_name%	物品显示名（纯文本）。	影刃

动作示例

actions:
  - type: message
    value: '<green>%player% 使用了 %item_name%！'
  - type: command
    value: 'effect give %player% speed 10 1'

说明

• 玩家主手没有 EmakiItem 物品时，held_id 和 held_name 返回空字符串。
• loaded_count 是全局值，不依赖玩家状态，适合用于管理面板。
• 外部插件物品如果没有写入 EmakiItem PDC 标记，无法被识别为 EmakiItem。
• CoreLib 的内置上下文变量（%player_name%、%player_uuid% 等）在物品动作中同样可用。