占位符API
Updated 11/18/2026
InfiniteBedWars Wiki · 占位符总表
本文汇总插件所有配置文件里可用的占位符(
%xxx%写法)。重要说明:这些占位符只在本插件自己的配置文件里生效, 插件目前没有接入 PlaceholderAPI,不能把它们写到其他插件(如 TAB、聊天、全息插件)里使用。 需要
%infinitebedwars_xxx%这类 PAPI 变量的话,得另外开发扩展。通用规则:颜色用
&代码;占位符写错或用在不支持的配置里,会原样显示,不会报错。
一、scoreboard.yml · 右侧计分板
通用(lobby / waiting / ingame 三段都能用)
占位符 | 含义 |
|---|---|
| 玩家名 |
| 全服在线人数 |
| 生涯等级 |
| 击杀(对局内 = 本局,大厅 = 生涯) |
| 挖床(同上) |
| 最终击杀(同上) |
| 生涯胜场 |
| 生涯对局数 |
| 当前血量 |
| 特殊行:按 formats 展开成每队一行 |
房间(仅 waiting / ingame)
占位符 | 含义 | 适用 |
|---|---|---|
| 房间名 | 两者 |
| 当前人数 | 两者 |
| 房间最大人数 | 两者 |
| 队伍数量 | 两者 |
| 开局倒计时(未开始 = | waiting |
| 自己的队伍(未分队 = 未分配) | 两者 |
| 下一阶段事件名 | ingame |
| 阶段倒计时 mm:ss | ingame |
队伍行(formats 段)
占位符 | 含义 | 适用 |
|---|---|---|
| 队伍显示名(带颜色) | waiting-team / ingame-team |
| 预估该队人数(平均分配预估值) | waiting-team |
| 床符号(symbols.bed-alive / bed-dead) | ingame-team |
| 该队存活人数 | ingame-team |
头顶名字(nametag 段)
占位符 | 含义 |
|---|---|
| 队伍颜色代码 |
| 队伍显示名 |
| 当前血量 |
| 最大血量 |
TAB(tab 段)
占位符 | 含义 | 位置 |
|---|---|---|
| 玩家延迟 |
|
二、config.yml · 大标题(titles)
占位符 | 含义 | 用在 |
|---|---|---|
| 队伍名(带颜色) |
|
| 拆床者名字 |
|
| 秒数 |
|
每个标题都有 title 和 subtitle 两行,占位符两行都能写。
三、config.yml · 消息(messages)
%prefix% 在所有消息里通用 = messages.prefix 的内容(默认 &8[&c起床&8] )。
消息 key | 可用占位符(除 %prefix%) |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
其余消息(如 game-start、countdown-cancel、platform-used、recall-done 等)只有 %prefix%。
四、config.yml · 资源点全息(generator-hologram)
占位符 | 含义 |
|---|---|
| 资源类型显示名(自动去掉 |
| 距下次掉落剩余秒数 |
| 刷新进度条 |
first-line 和 second-line 都支持这三个占位符。
五、items.yml · 临时实体命名
占位符 | 含义 | 用在 |
|---|---|---|
| 带颜色的队伍名(如 |
|
六、shop.yml · 价格格式
占位符 | 含义 | 用在 |
|---|---|---|
| 商品价格(经验级数) |
|
七、速查表(按用途反查)
你想显示 | 用哪个 | 哪里能用 |
|---|---|---|
玩家名 |
| 计分板、部分消息 |
队伍名 |
| 计分板、标题、消息、实体命名 |
房间名 |
| 计分板(非 lobby)、招募/加入消息 |
血量 |
| 计分板、头顶名字 |
延迟 |
| TAB 页脚 |
击杀/挖床/胜场 |
| 计分板 |
倒计时 |
| 计分板、标题、消息、全息 |
阶段事件 |
| ingame 计分板 |
拆床者 |
| 拆床标题与消息 |
击杀者/死者 |
| 击杀播报消息 |
商品价格 |
| 商店价格格式、经验不足提示 |
资源类型/进度 |
| 资源点全息 |
八、注意事项
占位符不跨文件通用:比如
%next_phase%写到消息里、%breaker%写到计分板里都不会替换。写错名字不会报错,会原样输出
%xxx%,排查时先看拼写和所在配置段。%kills%等统计类在对局内显示本局数据,离开对局显示生涯数据。颜色代码(
&c、&l等)在所有这些配置里都能用,与占位符混写没问题。想让其他插件读取起床数据(等级、胜场、所在房间等):需要给插件加 PlaceholderAPI 扩展, 目前没有,提出需求即可开发。
Was this page helpful?