> For the complete documentation index, see [llms.txt](https://enchantedmobs.superiormc.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://enchantedmobs.superiormc.cn/ultimatequest-zhong-wen-wen-dang/gong-neng/placeholders.md).

# PlaceholderAPI

启动前安装 PlaceholderAPI，注册持久 ultimatequest 扩展，支持以下格式：

```

%ultimatequest_state_<task-or-instance>%
%ultimatequest_battlepass_total_<id>%
%ultimatequest_battlepass_level_<id>%
%ultimatequest_battlepass_season_<id>%
%ultimatequest_battlepass_remaining_<id>%
%ultimatequest_battlepass_progress_<id>%
%ultimatequest_battlepass_percent_<id>%
%ultimatequest_battlepass_premium_<id>%
%ultimatequest_battlepass_claimable_<id>%
%ultimatequest_battlepass_timeleft_<id>%

```

将 battlepass 换为 milestone 即查询里程碑。total 为累计进度，level 为已达阶段，remaining 为到下一门槛剩余，progress 为上次门槛后的进度，percent 为整数百分比，premium 为布尔值，claimable 为在线玩家有资格领取的阶段数，timeleft 为结束剩余秒数（无结束为 -1）。高级资格检查要求玩家在线。

数据未就绪返回 LOADING。没有实例时 state 返回 AVAILABLE，这本身不证明定义存在或满足接取条件。未知格式无返回值。菜单 {name} 等局部变量与 PlaceholderAPI 不同。