变量与格式化选项
大约 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% 当前位置的温度
其他模块变量(需要开启指定模块)
Statistics | 统计变量
名称 别名 功能 示例 %online_time% %onlinetime% 在线时长 %destroy% 破坏方块 %place% 放置方块 %death% 死亡次数 %respawn% 重生次数 %join% 进服次数 %kill% 击杀次数 %kill:player%玩家
%kill:sheep%羊
使用 BEPlaceholderAPI 的变量
支持BEPlaceholderAPI的所有变量,安装 BEPlaceholderAPI 后即可直接使用
如因变量重名需要指定使用 BEPlaceholderAPI 的变量,可使用%papi:xxx%
的格式
在其他插件使用
其他插件仅需引入BEPlaceholderAPI
,pflp 的所有变量均可在 BEPlaceholderAPI 使用
本插件也通过接口导出的获取变量的 API,可供其他插件使用,参考接口 - 注册变量
格式化选项
格式化选项继承与.NET
的字符串格式化,百分号对于前后大括号,:
、,
等控制符参考文档
示例:
- 时间格式:
%time:yyyy-MM-dd-HH-mm-ss%
- 数字格式:
%mspt:F1%
表示保留小数点后一位