占位符参考

PlaceholderAPI 占位符

扩展标识符：emakiforge

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

占位符	说明	示例
%emakiforge_craft_count_<recipe_id>%	玩家对指定配方的锻造次数。	5
%emakiforge_has_crafted_<recipe_id>%	玩家是否锻造过指定配方。	true
%emakiforge_total_crafts%	玩家所有配方的总锻造次数。	42
%emakiforge_guarantee_<key>%	指定保底 key 的当前计数。	3
%emakiforge_recipe_count%	当前已加载的锻造配方总数。	28
%emakiforge_last_crafted%	玩家最后锻造的配方 ID。	flame_sword

使用示例

lore:
  - '<gray>锻造次数: <white>%emakiforge_craft_count_flame_sword%'
  - '<gray>总锻造: <white>%emakiforge_total_crafts%'
  - '<gray>保底进度: <yellow>%emakiforge_guarantee_flame_sword%'

内部模板变量

Forge 在应用结果名称与 Lore 动作时注入以下 %variable% 格式的内置变量。

变量	说明	示例
%quality%	品质名。仅在品质档位解析成功时注入。	完美
%quality_name%	品质显示名，与 %quality% 取值相同。	完美
%quality_multiplier%	品质倍率，按 0.## 格式化。	1.2
%multiplier%	品质倍率的简写别名。	1.2
%<stat_id>%	材料效果中 variables 注入的变量累计值，已乘材料数量与品质倍率。	10

可用位置

• 材料效果中 name_action 的 value 字段
• 材料效果中 lore_action 的 content 字段
• 配方 result.success.name_actions 的 value 字段
• 配方 result.success.lore_actions 的 content 字段
• 全局品质配置 quality.item_meta.tiers.<品质> 中的 name_actions 和 lore_actions

模板示例

name_actions:
  - action: "append_suffix"
    value: " <gray>[%quality_name%]</gray>"

lore_actions:
  - action: "append"
    content:
      - ""
      - "<gray>品质: %quality_name%</gray>"
      - "<gray>品质倍率: <white>%quality_multiplier%</white></gray>"
      - "<gray>火焰伤害: <red>+%fire_damage%</red></gray>"

说明

• PlaceholderAPI 占位符可在任何支持 PAPI 的位置使用（计分板、聊天、菜单等）。
• 内部模板变量仅在 Forge 的 name/lore 动作中生效，不能用于外部插件。
• %<stat_id>% 是动态变量，取决于材料效果中 variables 配置注入的 key。
• 品质 item_meta 的 action 动作行走 CoreLib 动作系统，其中可用 %player_name% 等 CoreLib 通用占位符；这与本节的内部模板变量是两套机制。