PlaceholderAPI：占位符
安装 PlaceholderAPI、加载扩展、常用占位符列表，以及当显示占位符本身而不是值时如何调试。
更新于 2026年8月13日
PlaceholderAPI 是一个占位符库。它能让一个插件显示另一个插件的数据：聊天栏中的余额、计分板上的领地、玩家列表中的公会。
安装
从插件目录安装该插件，然后安装您所需数据源对应的扩展：
papi ecloud download Vault
papi ecloud download Player
papi ecloud download Server
papi reload
扩展需要逐个安装，每个数据源对应一个扩展。
常用占位符
| 占位符 | 含义 |
|---|---|
%player_name% | 昵称 |
%player_ping% | 延迟 |
%player_world% | 世界 |
%server_online% | 在线玩家数 |
%server_tps_1% | 最近一分钟的 TPS |
%vault_eco_balance_formatted% | 余额 |
%luckperms_prefix% | 权限组前缀 |
%worldguard_region_name% | 玩家所在的领地 |
测试
papi parse me %vault_eco_balance%
该命令会显示实际被替换的内容。如果您看到的是原样文本 %vault_eco_balance%，说明：
- 扩展未安装；
- 缺少数据源（没有经济插件）；
- 您插入占位符的那个插件不支持 PlaceholderAPI。
最后一种情况最常见：并非每个插件都支持外部占位符，即使它自带占位符。
性能
占位符会在每次刷新时重新计算。一个包含十个数值的计分板，如果每刻刷新一次，就意味着每位玩家每秒进行 200 次计算：计分板。
Minecraft 托管您离线时服务器仍在运行创建服务器
