PlaceholderAPI 占位符

EmakiGem 提供了一组 PlaceholderAPI 外部占位符，可在计分板、HUD 等任何支持 PAPI 的场景中使用。

前置条件

服务器需安装 PlaceholderAPI 插件。EmakiGem 会在启动时自动检测并注册，无需手动配置。

标识符

emakigem

主手物品宝石状态

所有占位符读取玩家当前主手持有物品的宝石镶嵌数据。如果主手物品没有宝石系统数据，数值类返回 0，字符串类返回空。

总览

占位符	说明	示例返回值
%emakigem_mainhand_opened_slots%	已开孔的槽位数量	3
%emakigem_mainhand_total_slots%	总槽位数量（由装备模板定义）	5
%emakigem_mainhand_filled_slots%	已镶嵌宝石的槽位数量	2

单槽位查询

槽位索引从 0 开始。

占位符	说明	示例返回值
%emakigem_mainhand_slot_<n>_gem%	第 n 个槽位镶嵌的宝石 ID	ruby_attack
%emakigem_mainhand_slot_<n>_level%	第 n 个槽位宝石的等级	3
%emakigem_mainhand_slot_<n>_opened%	第 n 个槽位是否已开孔	true / false

示例

%emakigem_mainhand_opened_slots%        → 3
%emakigem_mainhand_total_slots%         → 5
%emakigem_mainhand_filled_slots%        → 2
%emakigem_mainhand_slot_0_gem%          → ruby_attack
%emakigem_mainhand_slot_0_level%        → 3
%emakigem_mainhand_slot_0_opened%       → true
%emakigem_mainhand_slot_2_gem%          →
%emakigem_mainhand_slot_2_opened%       → true

使用场景

这些占位符适合在装备信息面板中展示宝石镶嵌状态，或在 HUD 中显示当前武器的宝石配置。