PlaceholderAPI 变量
QueDP 提供两个 PlaceholderAPI 扩展：quedp 和 quedpmember。
需要安装 PlaceholderAPI 插件后才能使用。
当前副本状态
Section titled “当前副本状态”| 变量 | 说明 |
|---|---|
%quedp_in_dungeon% | 是否在副本中 (true/false) |
%quedp_current_dungeon% | 当前所在副本ID |
%quedp_instance_time% | 副本已运行时间（秒） |
%quedp_instance_status% | 副本状态（准备中/进行中/已完成/已失败/已取消） |
%quedp_instance_kills% | 当前副本击杀数 |
%quedp_instance_deaths% | 当前副本死亡数 |
%quedp_instance_damage% | 当前副本造成的伤害 |
%quedp_instance_players% | 当前副本玩家数 |
%quedp_instance_name% | 当前副本显示名称 |
| 变量 | 说明 |
|---|---|
%quedp_total_completions% | 总完成次数 |
%quedp_total_deaths% | 总死亡次数 |
| 变量 | 说明 |
|---|---|
%quedp_stamina% | 当前体力值 |
%quedp_max_stamina% | 最大体力值 |
%quedp_stamina_percent% | 体力百分比 |
%quedp_stamina_bar% | 体力条显示 |
%quedp_next_recovery% | 下次体力回复时间（秒） |
| 变量 | 说明 |
|---|---|
%quedp_in_party% | 是否在队伍中 (true/false) |
%quedp_party_size% | 队伍人数 |
%quedp_party_max_size% | 队伍最大人数 |
%quedp_party_leader% | 队长名称 |
%quedp_party_name% | 队伍名称 |
%quedp_party_online% | 在线成员数 |
%quedp_party_isleader% | 是否是队长 (true/false) |
%quedp_party_loot_mode% | 战利品模式 |
%quedp_party_exp_share% | 经验共享模式 |
%quedp_party_share_scope% | 共享范围 |
将 <dungeonId> 替换为实际的地牢ID。
| 变量 | 说明 |
|---|---|
%quedp_dungeon_<dungeonId>_instances% | 当前运行实例数 |
%quedp_dungeon_<dungeonId>_max_instances% | 最大实例数 |
%quedp_dungeon_<dungeonId>_available% | 是否有可用槽位 (true/false) |
%quedp_dungeon_<dungeonId>_available_slots% | 剩余槽位数 |
%quedp_dungeon_<dungeonId>_cost% | 体力消耗 |
%quedp_dungeon_<dungeonId>_completion_count% | 玩家完成次数 |
%quedp_dungeon_<dungeonId>_best_time% | 最佳通关时间（秒），无记录返回 无 |
%quedp_dungeon_<dungeonId>_last_time% | 最近一次通关时间（秒），无记录返回 无 |
%quedp_dungeon_<dungeonId>_cooldown% | 剩余冷却时间（秒） |
%quedp_dungeon_<dungeonId>_on_cooldown% | 是否在冷却中 (true/false) |
将 <dungeonId> 替换为实际的地牢ID。
| 变量 | 说明 |
|---|---|
%quedp_rank_<dungeonId>_time% | 玩家在该地牢的时间排名 |
%quedp_rank_<dungeonId>_damage% | 玩家在该地牢的伤害排名 |
%quedp_rank_<dungeonId>_kills% | 玩家在该地牢的击杀排名 |
%quedp_rank_<dungeonId>_damage_<排名>% | 伤害榜指定名次的原始伤害值 |
%quedp_rank_<dungeonId>_damage_<排名>_integer% | 伤害榜指定名次的伤害值，四舍五入保留整数 |
%quedp_rank_<dungeonId>_damage_<排名>_decimal_1% | 伤害榜指定名次的伤害值，四舍五入保留一位小数 |
%quedp_rank_<dungeonId>_damage_<排名>_decimal_2% | 伤害榜指定名次的伤害值，四舍五入保留两位小数 |
%quedp_rank_<dungeonId>_kills_<排名>% | 击杀榜指定名次的击杀数 |
%quedp_rank_<dungeonId>_time_<排名>_seconds% | 时间榜指定名次的总秒数 |
%quedp_rank_<dungeonId>_time_<排名>_formatted% | 时间榜指定名次的 x分x秒 格式 |
%quedp_rank_<dungeonId>_time_<排名>_clock% | 时间榜指定名次的 mm:ss 格式 |
%quedp_rank_<dungeonId>_time_<排名>_millis% | 时间榜指定名次的派生毫秒数 |
<排名> 从 1 开始，最多读取排行榜保留的前 100 名。名次无效或不存在时返回 未上榜。
通关时间在副本结束时按 (结束毫秒 - 开始毫秒) / 1000 记录，因此排行榜的原始单位是整秒。millis 是该整秒值乘以 1000 的派生结果，不包含已经截断的毫秒精度。
脚本变量透传
Section titled “脚本变量透传”读取玩家当前所在副本实例持久脚本上下文中的变量。脚本通过 setVar 写入、或附属插件通过 API 写入的状态，都能借此显示在计分板、Tab 列表等任意支持 PlaceholderAPI 的位置。
格式: %quedp_var_<变量名>%
| 变量 | 说明 |
|---|---|
%quedp_var_<变量名>% | 当前副本实例脚本变量的值；玩家不在副本中或变量不存在时返回空字符串 |
示例:
%quedp_var_room_progress%— 脚本中setVar('room_progress', ...)写入的房间进度%quedp_var_rating%— 附属插件写入的本次评级
原版 player 扩展兼容
Section titled “原版 player 扩展兼容”安装 PlaceholderAPI 的 Player 扩展后，QueDP 会接管其中的世界名变量，方便聊天、计分板直接显示副本中文名。
| 变量 | 说明 |
|---|---|
%player_world% | 玩家在运行中的副本内时返回副本显示名称（含颜色）；在普通世界返回世界名 |
%player_worldoriginal% | 始终返回玩家所在世界的真实技术名称（副本世界形如 quedp_xxx） |
其余 %player_*% 变量保持 Player 扩展原行为。
队伍成员变量 (quedpmember)
Section titled “队伍成员变量 (quedpmember)”quedpmember 扩展允许你读取队伍中指定序号成员的任意 PlaceholderAPI 变量。
格式: %quedpmember_<序号>_<placeholder>%
<序号>从0开始<placeholder>是任何其他 PlaceholderAPI 变量（不含%）
示例:
%quedpmember_0_player_health%- 队伍第1个成员的血量%quedpmember_1_player_name%- 队伍第2个成员的名字%quedpmember_2_quedp_instance_kills%- 队伍第3个成员的击杀数
如果序号超出队伍人数范围，返回空值。