占位符参考

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 在 name_actions 和 lore_actions 模板中支持以下 %variable% 格式的内置变量，由 ForgePresentationBuilder 解析。

变量	说明	示例
%quality%	品质 ID。	rare
%quality_name%	品质显示名。	<blue>稀有
%quality_multiplier%	品质倍率（完整 key）。	1.25
%multiplier%	品质倍率（简写）。	1.5
%player_name%	执行锻造的玩家名称。	Steve
%player_uuid%	执行锻造的玩家 UUID。	550e8400-e29b-...
{<stat_id>}	材料效果中 variables 注入的任意变量。	10

可用位置

• 材料效果中 name_action 的 value 字段
• 配方 result.meta_actions 中 name_actions 的 value 字段
• 配方 result.meta_actions 中 lore_actions 的 content 字段
• 品质配置中的 name_actions 和 lore_actions

模板示例

name_actions:
  - action: "append_suffix"
    value: " <gray>[由 %player_name% 锻造]</gray>"

lore_actions:
  - action: "append"
    content:
      - ""
      - "<gray>锻造者: <white>%player_name%</white></gray>"
      - "<gray>品质: %quality_name%</gray>"
      - "<gray>火焰伤害: <red>+%fire_damage%</red></gray>"

说明

• PlaceholderAPI 占位符可在任何支持 PAPI 的位置使用（计分板、聊天、菜单等）。
• 内部模板变量仅在 Forge 的 name/lore 模板中生效，不能用于外部插件。
• {<stat_id>} 是动态变量，取决于材料效果中 variables 配置注入的 key。