跳到主要内容

PlaceholderAPI 变量

装了 PlaceholderAPI 会自动注册 %clouddungeon_<变量>%,不需要下载扩展。 可以用在 TAB、计分板插件、全息图、菜单插件里,也可以用在本插件的入场条件、脚本条件里。

变量名称不分大小写。<副本> 填副本 ID。

副本内​

玩家在副本里时有值;不在副本里时返回空字符串(in_dungeon 除外),例如 kills、deaths、damage、elapsed、phase、alive_mobs、dungeon_id 都是空的,不会显示 0。

变量内容
%clouddungeon_in_dungeon%是否在副本里:true / false(任何时候都有值)
%clouddungeon_dungeon%副本名称(含颜色)
%clouddungeon_dungeon_id%副本 ID
%clouddungeon_mode%难度模式名称
%clouddungeon_phase%阶段:准备中 / 倒数 / 进行中 / 结算
%clouddungeon_objective%当前目标文字,别名 %clouddungeon_stage%
%clouddungeon_time_left%剩余时间 mm:ss,没有时间限制显示「不限」
%clouddungeon_elapsed%已经过时间 mm:ss
%clouddungeon_lives%剩余生命
%clouddungeon_deaths%自己的死亡数
%clouddungeon_kills%自己的击杀数
%clouddungeon_damage%自己造成的伤害
%clouddungeon_alive_mobs%场上剩余的副本怪物数
%clouddungeon_retries%团灭后还能重来几次(副本 lives.wipe-retries)
%clouddungeon_region%自己所在的区域名称(不在任何区域为空)
%clouddungeon_var_<变量>%副本变量的值(没设置过是 0),别名 %clouddungeon_data_<变量>%
%clouddungeon_group_<怪物组>%怪物组状态:idle(还没叫出)/ running / done / stopped
%clouddungeon_task_<任务>%任务是否在跑:true / false

为了不拖慢计分板插件,副本内的变量每位玩家每秒计算一次。

队伍与排队​

任何时候都有值。

变量内容
%clouddungeon_in_party%是否有队伍:true / false
%clouddungeon_party_size%队伍人数,没有队伍是 0
%clouddungeon_party_leader%队长名字,没有队伍为空
%clouddungeon_queue%正在快速配对的副本 ID,没有排队为空
%clouddungeon_queue_<副本>%这个副本(所有模式合计)正在排队的人数

体力​

需要 config.yml 开启 stamina。

变量内容
%clouddungeon_stamina%目前体力(含已回复的)
%clouddungeon_stamina_max%体力上限

每个副本的个人记录​

变量内容
%clouddungeon_daily_<副本>%今天已经进入几次
%clouddungeon_weekly_<副本>%本周已经进入几次
%clouddungeon_daily_left_<副本>%今天还剩几次(没有限制显示 ∞)
%clouddungeon_weekly_left_<副本>%本周还剩几次(没有限制显示 ∞)
%clouddungeon_clears_<副本>%通关次数
%clouddungeon_best_<副本>%最佳通关时间,没有记录显示 -
%clouddungeon_cooldown_<副本>%冷却剩余秒数,0 = 可以挑战

例:大厅全息图显示「霜烬古殿 今日剩余 2 次」:

&b霜烬古殿 &7今日剩余 &e%clouddungeon_daily_left_frost_hall% &7次

例:副本只开放给通关过前一个副本的人(副本 config.yml):

requirements:
conditions:
- condition: "%clouddungeon_clears_frost_hall% >= 1"
message: "&c先通关一次「霜烬古殿」才能挑战。"

本插件里的变量​

本插件自己的计分板、菜单、脚本使用 {变量} 写法(例如 {time_left}、{v:钥匙}),不需要 PlaceholderAPI,见 变量与占位符 和 计分板。