QueDP

主题

PlaceholderAPI 变量列表 ​

QueDP 提供丰富的 PlaceholderAPI 变量，可用于记分板、聊天、称号等插件。

变量总数

当前提供 31个 PlaceholderAPI 变量，涵盖地牢状态、玩家数据、当前副本、队伍信息、排行榜等。

地牢状态变量 ​

实例信息 ​

%quedp_dungeon_<地牢ID>_instances% ​

当前该地牢的运行实例数。

示例：

%quedp_dungeon_arena_instances%
→ 3

%quedp_dungeon_<地牢ID>_max_instances% ​

该地牢的最大实例数。

返回值：

  • 数字 - 实例数限制
  • 无限制 - 没有限制（-1）

示例：

%quedp_dungeon_arena_max_instances%
→ 5

%quedp_dungeon_<地牢ID>_available% ​

是否还有可用槽位。

返回值： true 或 false

示例：

%quedp_dungeon_arena_available%
→ true

%quedp_dungeon_<地牢ID>_available_slots% ​

剩余可用槽位数。

返回值：

  • 数字 - 剩余槽位
  • ∞ - 无限制

示例：

%quedp_dungeon_arena_available_slots%
→ 2

地牢配置 ​

%quedp_dungeon_<地牢ID>_cost% ​

该地牢的体力消耗。

示例：

%quedp_dungeon_hard_mode_cost%
→ 10

玩家数据变量 ​

完成统计 ​

%quedp_dungeon_<地牢ID>_completion_count% ​

玩家完成该地牢的次数。

示例：

%quedp_dungeon_arena_completion_count%
→ 15

%quedp_dungeon_<地牢ID>_best_time% ​

玩家该地牢的最佳时间（秒）。

返回值：

  • 数字 - 秒数
  • 无 - 从未完成

示例：

%quedp_dungeon_arena_best_time%
→ 234

%quedp_total_completions% ​

玩家所有地牢的总完成次数。

示例：

%quedp_total_completions%
→ 47

%quedp_total_deaths% ​

玩家在地牢中的总死亡次数。

示例：

%quedp_total_deaths%
→ 12

冷却时间 ​

%quedp_dungeon_<地牢ID>_cooldown% ​

该地牢的剩余冷却时间（秒）。

返回值：

  • 数字 - 剩余秒数
  • 0 - 没有冷却

示例：

%quedp_dungeon_arena_cooldown%
→ 1800

%quedp_dungeon_<地牢ID>_on_cooldown% ​

该地牢是否在冷却中。

返回值： true 或 false

示例：

%quedp_dungeon_arena_on_cooldown%
→ false

当前状态变量 ​

副本状态 ​

%quedp_in_dungeon% ​

玩家是否在副本中。

返回值： true 或 false

示例：

%quedp_in_dungeon%
→ true

%quedp_current_dungeon% ​

玩家当前所在的副本ID。

返回值：

  • 地牢ID - 在副本中
  • 空字符串 - 不在副本中

示例：

%quedp_current_dungeon%
→ arena

副本实时数据 ​

%quedp_instance_time% ​

当前副本已运行时间（秒）。

示例：

%quedp_instance_time%
→ 125

%quedp_instance_status% ​

当前副本状态。

返回值：

  • 准备中 - PREPARING
  • 进行中 - ACTIVE
  • 已完成 - COMPLETED
  • 已失败 - FAILED
  • 已取消 - CANCELLED

示例：

%quedp_instance_status%
→ 进行中

%quedp_instance_kills% ​

当前副本中玩家的击杀数。

示例：

%quedp_instance_kills%
→ 15

%quedp_instance_deaths% ​

当前副本中玩家的死亡数。

示例：

%quedp_instance_deaths%
→ 2

%quedp_instance_damage% ​

当前副本中玩家造成的伤害。

示例：

%quedp_instance_damage%
→ 12500

%quedp_instance_players% ​

当前副本的在线玩家数量。

示例：

%quedp_instance_players%
→ 4

%quedp_instance_name% ​

当前副本的显示名称。

示例：

%quedp_instance_name%
→ 恶魔之塔

队伍信息变量 ​

%quedp_in_party% ​

玩家是否在队伍中。

返回值： true 或 false

示例：

%quedp_in_party%
→ true

%quedp_party_size% ​

队伍当前人数。

返回值： 不在队伍时返回 0

示例：

%quedp_party_size%
→ 3

%quedp_party_max_size% ​

队伍最大人数限制。

示例：

%quedp_party_max_size%
→ 5

%quedp_party_leader% ​

队长的玩家名称。

返回值：

  • 玩家名 - 队长在线
  • 离线 - 队长离线
  • 空字符串 - 不在队伍中

示例：

%quedp_party_leader%
→ Player123

%quedp_party_online% ​

队伍中的在线成员数。

返回值： 不在队伍时返回 0

示例：

%quedp_party_online%
→ 3

排行榜变量 ​

时间排名 ​

%quedp_rank_<地牢ID>_time% ​

玩家在该地牢的最快通关时间排名。

返回值：

  • 数字 - 排名
  • 未上榜 - 未进入排行榜

示例：

%quedp_rank_boss_battle_time%
→ 5

%quedp_rank_arena_time%
→ 未上榜

伤害排名 ​

%quedp_rank_<地牢ID>_damage% ​

玩家在该地牢的最高伤害排名。

返回值：

  • 数字 - 排名
  • 未上榜 - 未进入排行榜

示例：

%quedp_rank_boss_battle_damage%
→ 12

%quedp_rank_hard_mode_damage%
→ 未上榜

击杀排名 ​

%quedp_rank_<地牢ID>_kills% ​

玩家在该地牢的最多击杀排名。

返回值：

  • 数字 - 排名
  • 未上榜 - 未进入排行榜

示例：

%quedp_rank_arena_kills%
→ 8

%quedp_rank_boss_battle_kills%
→ 未上榜

体力系统变量 ​

体力值 ​

%quedp_stamina% ​

玩家当前体力值。

示例：

%quedp_stamina%
→ 85

%quedp_max_stamina% ​

最大体力值（全局配置）。

示例：

%quedp_max_stamina%
→ 100

%quedp_stamina_percent% ​

体力百分比（数字）。

示例：

%quedp_stamina_percent%
→ 85

%quedp_stamina_bar% ​

体力条可视化显示。

示例：

%quedp_stamina_bar%
→ ████████░░ 85%

%quedp_next_recovery% ​

距离下次体力回复的时间（秒）。

示例：

%quedp_next_recovery%
→ 45

使用示例 ​

副本内实时记分板 🆕 ​

使用新的实时数据变量显示副本进度：

yaml
# FeatherBoard 配置
boards:
  dungeon-board:
    title: "&6&l%quedp_instance_name%"
    lines:
      - "&7━━━━━━━━━━━━━━━━"
      - "&e副本状态: &a%quedp_instance_status%"
      - "&7用时: &f%quedp_instance_time%秒"
      - ""
      - "&e个人数据"
      - "&7击杀: &a%quedp_instance_kills%"
      - "&7死亡: &c%quedp_instance_deaths%"
      - "&7伤害: &6%quedp_instance_damage%"
      - ""
      - "&7队伍: &f%quedp_instance_players%人在线"
      - "&7━━━━━━━━━━━━━━━━"

效果：

恶魔之塔
━━━━━━━━━━━━━━━━
副本状态: 进行中
用时: 125秒

个人数据
击杀: 15
死亡: 2
伤害: 12500

队伍: 4人在线
━━━━━━━━━━━━━━━━

队伍信息显示 🆕 ​

在记分板显示队伍状态：

yaml
# FeatherBoard 配置
boards:
  party-board:
    title: "&6&l队伍信息"
    lines:
      - "&7━━━━━━━━━━━━━━━━"
      - "&e队长: &f%quedp_party_leader%"
      - "&7人数: &f%quedp_party_online%&7/&f%quedp_party_size%"
      - "&7上限: &e%quedp_party_max_size%人"
      - ""
      - "&7状态: %quedp_in_party% == true ? &a组队中 : &c单人&r"
      - "&7━━━━━━━━━━━━━━━━"

效果：

队伍信息
━━━━━━━━━━━━━━━━
队长: Player123
人数: 3/3
上限: 5人

状态: 组队中
━━━━━━━━━━━━━━━━

记分板显示 ​

yaml
# DeluxeScoreboard 配置
scoreboard:
  lines:
    - "&7━━━━━━━━━━━━━━━"
    - "&e当前地牢: &f%quedp_current_dungeon%"
    - "&e体力: &f%quedp_stamina%/%quedp_max_stamina%"
    - "&a竞技场: &f%quedp_dungeon_arena_completion_count% 次"
    - "&7━━━━━━━━━━━━━━━"

效果：

━━━━━━━━━━━━━━━
当前地牢: arena
体力: 85/100
竞技场: 15 次
━━━━━━━━━━━━━━━

聊天消息 ​

yaml
# 使用 ChatControl 或任意聊天插件
format: "&7[&f%quedp_total_completions%&7] &f%player_name%: %message%"

效果：

[47] ShanQue: 大家好！

称号显示 ​

yaml
# PlaceholderAPI + PrefixSuffix
prefix: "&7[&6%quedp_dungeon_arena_best_time%s&7]"

效果：

[234s] ShanQue

进入条件检查 ​

yaml
# 使用 ConditionalCommands
conditions:
  - "%quedp_stamina% >= 10"
  - "%quedp_dungeon_arena_on_cooldown% == false"
commands:
  - "dungeon enter arena"

TAB 列表 ​

yaml
# TAB 插件配置
tablist:
  header:
    - "&e体力: &f%quedp_stamina_bar%"
    - "&7在线玩家: %server_online%"

效果：

体力: ████████░░ 85%
在线玩家: 50

排行榜称号系统 🆕 ​

根据排名授予称号：

yaml
# ChatControl 配置
titles:
  speed_master:
    condition: "%quedp_rank_boss_battle_time% <= 3"
    prefix: "&6[速通王] "
    description: "Boss战排名前3"
  
  damage_dealer:
    condition: "%quedp_rank_arena_damage% <= 5"
    prefix: "&c[输出之王] "
    description: "竞技场伤害排名前5"
  
  kill_master:
    condition: "%quedp_rank_hard_mode_kills% <= 10"
    prefix: "&e[屠夫] "
    description: "困难模式击杀排名前10"

队伍进入检查 🆕 ​

使用队伍变量作为进入条件：

yaml
# ConditionalCommands 配置
dungeon_entry:
  conditions:
    - "%quedp_in_party% == true"
    - "%quedp_party_size% >= 3"
    - "%quedp_party_online% >= 3"
  success_commands:
    - "dungeon enter team_dungeon"
  fail_messages:
    - "&c该副本需要至少3人的队伍！"

全息显示 ​

yaml
# HolographicDisplays
lines:
  - "&6&l竞技场副本"
  - "&7运行中: &f%quedp_dungeon_arena_instances%/%quedp_dungeon_arena_max_instances%"
  - "&7剩余槽位: &a%quedp_dungeon_arena_available_slots%"
  - "&7你的最佳: &e%quedp_dungeon_arena_best_time%s"
  - "&7你的排名: &6第%quedp_rank_arena_time%名"
  - "&8[点击进入]"

效果：

竞技场副本
运行中: 3/5
剩余槽位: 2
你的最佳: 234s
你的排名: 第5名
[点击进入]

ItemsAdder 物品 Lore ​

yaml
items:
  dungeon_ticket:
    display_name: "&6竞技场入场券"
    lore:
      - "&7━━━━━━━━━━━━"
      - "&e你的完成次数: &f%quedp_dungeon_arena_completion_count%"
      - "&e你的最佳时间: &f%quedp_dungeon_arena_best_time%s"
      - "&e体力消耗: &c%quedp_dungeon_arena_cost%"
      - "&7━━━━━━━━━━━━"

格式化建议 ​

时间格式化 ​

PlaceholderAPI 返回的是秒数，你可以用其他插件格式化：

yaml
# 使用 PlaceholderAPI 的内置格式化
%quedp_dungeon_arena_cooldown% 秒
→ 1800 秒

# 或使用 JavaScript placeholder
%javascript_Math.floor(%quedp_dungeon_arena_cooldown%/60)% 分钟
→ 30 分钟

条件显示 ​

使用 PlaceholderAPI 的条件变量：

yaml
# 显示冷却时间或"可进入"
%rel_conditional_{quedp_dungeon_arena_on_cooldown}==true?&c冷却中: %quedp_dungeon_arena_cooldown%s:&a可进入%

颜色渐变 ​

根据体力值显示不同颜色：

yaml
# 使用条件变量
%rel_conditional_{quedp_stamina_percent}>80?&a:&e% %quedp_stamina%
%rel_conditional_{quedp_stamina_percent}>50?&e:&c% %quedp_stamina%
%rel_conditional_{quedp_stamina_percent}<30?&c:&e% %quedp_stamina%

效果：

  • 体力 > 80%：&a85 (绿色)
  • 体力 50-80%：&e60 (黄色)
  • 体力 < 30%：&c25 (红色)

注意事项 ​

变量命名 ​

  • ⚠️ 地牢ID必须与配置文件中的ID完全匹配（区分大小写）
  • ⚠️ 变量名中的下划线是分隔符，地牢ID中如果有下划线是支持的

示例：

地牢ID: hard_mode_arena
变量: %quedp_dungeon_hard_mode_arena_completion_count%
      ↑                ↑↑↑↑↑↑↑↑↑↑↑↑↑↑
      前缀             地牢ID

玩家必须在线 ​

以下变量需要玩家在线才能查询：

  • 所有 completion_count、best_time、cooldown 变量
  • 所有 stamina 相关变量
  • in_dungeon、current_dungeon 变量
  • total_completions、total_deaths 变量

实例数查询 ​

以下变量无需玩家在线，任何地方都可用：

  • instances
  • max_instances
  • available
  • available_slots
  • cost

完整变量列表 ​

地牢状态 ​

变量描述需要在线
%quedp_dungeon_<ID>_instances%运行实例数❌
%quedp_dungeon_<ID>_max_instances%最大实例数❌
%quedp_dungeon_<ID>_available%是否可用❌
%quedp_dungeon_<ID>_available_slots%剩余槽位❌
%quedp_dungeon_<ID>_cost%体力消耗❌

玩家地牢数据 ​

变量描述需要在线
%quedp_dungeon_<ID>_completion_count%完成次数✅
%quedp_dungeon_<ID>_best_time%最佳时间✅
%quedp_dungeon_<ID>_cooldown%剩余冷却✅
%quedp_dungeon_<ID>_on_cooldown%是否冷却中✅

当前副本状态 ​

变量描述需要在线
%quedp_in_dungeon%是否在副本中✅
%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%是否在队伍中✅
%quedp_party_size%队伍人数✅
%quedp_party_max_size%队伍最大人数✅
%quedp_party_leader%队长名称✅
%quedp_party_online%在线成员数✅

排行榜 🆕 ​

变量描述需要在线
%quedp_rank_<ID>_time%时间排名✅
%quedp_rank_<ID>_damage%伤害排名✅
%quedp_rank_<ID>_kills%击杀排名✅

变量总数

31个变量 = 9个地牢状态 + 2个玩家统计 + 5个体力系统 + 7个副本实时 + 5个队伍信息 + 3个排行榜

相关链接 ​

基于 MIT 许可发布

Copyright © 2025 QueDP