占位符API

Updated 11/18/2026

InfiniteBedWars Wiki · 占位符总表

本文汇总插件所有配置文件里可用的占位符(%xxx% 写法)。

重要说明:这些占位符只在本插件自己的配置文件里生效, 插件目前没有接入 PlaceholderAPI,不能把它们写到其他插件(如 TAB、聊天、全息插件)里使用。 需要 %infinitebedwars_xxx% 这类 PAPI 变量的话,得另外开发扩展。

通用规则:颜色用 & 代码;占位符写错或用在不支持的配置里,会原样显示,不会报错。


一、scoreboard.yml · 右侧计分板

通用(lobby / waiting / ingame 三段都能用)

占位符

含义

%player%

玩家名

%online%

全服在线人数

%level%

生涯等级

%kills%

击杀(对局内 = 本局,大厅 = 生涯)

%beds%

挖床(同上)

%final_kills%

最终击杀(同上)

%wins%

生涯胜场

%games%

生涯对局数

%health%

当前血量

%teamlines%

特殊行:按 formats 展开成每队一行

房间(仅 waiting / ingame)

占位符

含义

适用

%arena%

房间名

两者

%players%

当前人数

两者

%max%

房间最大人数

两者

%teams%

队伍数量

两者

%countdown%

开局倒计时(未开始 = -)

waiting

%team%

自己的队伍(未分队 = 未分配)

两者

%next_phase%

下一阶段事件名

ingame

%next_phase_time%

阶段倒计时 mm:ss

ingame

队伍行(formats 段)

占位符

含义

适用

%team%

队伍显示名(带颜色)

waiting-team / ingame-team

%players%

预估该队人数(平均分配预估值)

waiting-team

%bed%

床符号(symbols.bed-alive / bed-dead)

ingame-team

%alive%

该队存活人数

ingame-team

头顶名字(nametag 段)

占位符

含义

%color%

队伍颜色代码

%team%

队伍显示名

%health%

当前血量

%max_health%

最大血量

TAB(tab 段)

占位符

含义

位置

%ping%

玩家延迟

tab.footer


二、config.yml · 大标题(titles)

占位符

含义

用在

%team%

队伍名(带颜色)

bed-destroyed-other、game-end

%breaker%

拆床者名字

bed-destroyed-other

%seconds%

秒数

death(重生倒计时)

每个标题都有 title 和 subtitle 两行,占位符两行都能写。

三、config.yml · 消息(messages)

%prefix% 在所有消息里通用 = messages.prefix 的内容(默认 &8[&c起床&8] )。

消息 key

可用占位符(除 %prefix%)

yq(招募)

%player% 发布者、%arena% 房间、%message% 招募内容

joined

%arena%、%players%、%max%

left

%player%

countdown-start / countdown

%seconds%

bed-destroyed-own

%breaker%

bed-destroyed-other

%team%、%breaker%

eliminated

%player%

win

%team%

kill-reward

%player% 被击杀者、%levels% 奖励经验级数

respawn-in

%seconds%

shop-no-xp

%cost% 所需经验级数

shop-bought

%item% 商品名

recall-start

%seconds%

player-death

%player% 死者、%killer% 击杀者

player-killed / player-final-killed

%killer%、%victim%

revival-bed-used

%team%

其余消息(如 game-start、countdown-cancel、platform-used、recall-done 等)只有 %prefix%。

四、config.yml · 资源点全息(generator-hologram)

占位符

含义

%type%

资源类型显示名(自动去掉 &7(...) 后缀)

%seconds%

距下次掉落剩余秒数

%bar%

刷新进度条

first-line 和 second-line 都支持这三个占位符。

五、items.yml · 临时实体命名

占位符

含义

用在

%team%

带颜色的队伍名(如 &c红队)

bedbug.name-format、dream-defender.name-format

六、shop.yml · 价格格式

占位符

含义

用在

%cost%

商品价格(经验级数)

settings.price-format(默认 &a%cost% 级经验)


七、速查表(按用途反查)

你想显示

用哪个

哪里能用

玩家名

%player%

计分板、部分消息

队伍名

%team%

计分板、标题、消息、实体命名

房间名

%arena%

计分板(非 lobby)、招募/加入消息

血量

%health% / %max_health%

计分板、头顶名字

延迟

%ping%

TAB 页脚

击杀/挖床/胜场

%kills% %beds% %final_kills% %wins% %games%

计分板

倒计时

%countdown%(开局)/ %seconds%(通用秒数)

计分板、标题、消息、全息

阶段事件

%next_phase% / %next_phase_time%

ingame 计分板

拆床者

%breaker%

拆床标题与消息

击杀者/死者

%killer% / %victim%

击杀播报消息

商品价格

%cost%

商店价格格式、经验不足提示

资源类型/进度

%type% / %bar%

资源点全息


八、注意事项

  1. 占位符不跨文件通用:比如 %next_phase% 写到消息里、%breaker% 写到计分板里都不会替换。

  2. 写错名字不会报错,会原样输出 %xxx%,排查时先看拼写和所在配置段。

  3. %kills% 等统计类在对局内显示本局数据,离开对局显示生涯数据。

  4. 颜色代码(&c、&l 等)在所有这些配置里都能用,与占位符混写没问题。

  5. 想让其他插件读取起床数据(等级、胜场、所在房间等):需要给插件加 PlaceholderAPI 扩展, 目前没有,提出需求即可开发。

Was this page helpful?