变量与格式化选项

LazuliKao大约 3 分钟

内置变量

在任意位置使用

名称	别名	功能	示例
%time%	%date%%now%	当前时间	%time:yyyy-MM-dd-HH-mm-ss%
%tps%	%server_tps% %servertps%	服务器 TPS
%mspt%	%server_mspt% %servermspt%	服务器 MSPT
%playercount%	%server_online% %serveronline%	在线玩家数量
%version%	%server_version% %serverversion%	服务器版本
%protocol%	%protocol_version% %server_protocol_version% %protocolversion% %serverprotocolversion%	服务器协议版本
%entitycount%	%total_entities% %server_total_entities% %totalentities% %servertotalentities%	服务器实体数量	掉落物数量`%entitycount:item%` 非掉落物数量`%entitycount:!item%` 玩家和 🐶 的数量`%entitycount:player+wolf%` 目前就`+`分割更复杂的判断建议使用脚本接入
%ram_bds_used%	%server_ram_bds_used% %rambdsused% %serverrambdsused%	BDS 内存使用量
%ram_used%	%server_ram_used% %ramused% %serverramused%	主机内存使用量
%ram_total%	%server_ram_total% %ramtotal% %serverramtotal%	服务器总内存
%ram_free%	%server_ram_free% %ramfree% %serverramfree%	服务器空闲内存
%ram_load%	%server_ram_load% %ramload% %serverramload%	服务器内存占用率	返回一个 0 到 100 的整数无百分号
%papi%	%placeholder% %placeholderapi%	#PAPI 变量建议直接使用%xxx% 除非同名时需要指定 papi 变量	%papi:xxx%
%server_received%	%server_receive% %serverreceived% %serverreceive%	服务器收到的总字节数
%server_sent%	%server_send% %serversent% %serversend%	服务器发送的总字节数

在玩家相关的上下文中使用

名称	别名	功能	示例
%name%		玩家名字
%xuid%
%money%		玩家 Xuid
%scoreboard%	%sb%	计分板	%scoreboard:money%
%world%	%dimension%	维度
%ping%		最近一次延迟
%avgping%		(最近 5 次的)平均延迟
%lowestping%		最低延迟
%health%		玩家当前血量
%hunger%		玩家当前饥饿值
%level%		玩家当前等级
%saturation%		玩家当前饱食度
%experience%	%xp%	玩家当前经验
%pos%	%position%	玩家当前坐标
%os%	%devicetype%	玩家当前设备类型翻译可在语言文件更改
%devicename%	%device%	玩家当前设备名称
%serverip%	%serveraddress%	玩家进入服务器使用的 IP
%ip%	%address%	玩家当前 IP
%location%		（通过 IP 获取的）完整地理位置
%country%		国家
%province%		省份
%city%		城市
%isp%		网络运营商
%total_received%	%total_receive% %totalreceived% %totalreceive%	（本次连接）玩家收到的总字节数
%total_sent%	%total_send% %totalsent% %totalsend%	（本次连接）玩家发送的总字节数
%received%	%receive%	每秒收到的字节数
%sent%	%send%	每秒发送的字节数
%land%		玩家当前领地	类型%land:type% 所有者%land:owner% 共享玩家%land:sharedplayers% 领地名称%land:displayname% 消息留言%land:message% 欢迎语%land:welcome% %land:x1% %land:y1% %land:z1% %land:x2% %land:y2% %land:z2% 长%land:dx% 宽%land:dy% 高%land:dz%
%biome%		生物群系
%biome_name%		生物群系名称（目前仅中文）
%brightness%		当前位置的亮度
%temperature%		当前位置的温度

支持BEPlaceholderAPIopen in new window的所有变量，安装 BEPlaceholderAPI 后即可直接使用

如因变量重名需要指定使用 BEPlaceholderAPI 的变量，可使用%papi:xxx%的格式

其他插件仅需引入BEPlaceholderAPI,pflp 的所有变量均可在 BEPlaceholderAPI 使用

本插件也通过接口导出的获取变量的 API，可供其他插件使用，参考接口 - 注册变量

格式化选项继承与.NET的字符串格式化，百分号对于前后大括号，:、,等控制符参考文档

示例：