PAPI 变量查询

介绍

EasyBot 支持通过变量动态显示实时数据。这些变量会被自动替换成对应的数值（如玩家名、金钱、TPS 等）。

• Bukkit/Spigot 端：依赖 PlaceholderAPI (PAPI) 插件及其扩展组件。
• Mod 端：内置了核心变量支持，无需额外安装 PAPI 及其扩展。

平台支持情况

• Bukkit/Spigot/Paper: 完美支持（需安装 PAPI 插件）。
• Mod 端 (Fabric/Forge): 完美支持（已内置 math 和 ez-statistic 变量）。
• 基岩版 / MCDR: 暂未提供变量支持，无法使用此功能。

离线查询注意

• Bukkit/Spigot 用户：部分变量在玩家离线时无法查询，需配合 EzOfflinePAPI 插件。
• Mod 端用户：不存在此问题，Mod 端原生支持离线玩家数据查询，无需安装额外插件。

快速开始

根据您使用的服务端类型，准备工作有所不同：

1. 如果您使用 Mod 端 (Fabric/Forge)

无需任何配置！ 插件已内置 math、ez-statistic 和 player 基础变量。您可以直接跳转到下方的示例进行使用。

2. 如果您使用 Bukkit/Spigot 端

您需要手动下载对应的 PAPI 扩展包：

papi ecloud download Player
papi ecloud download Server
papi ecloud download Math
papi reload

---

示例 1: 个人战绩查询

依赖说明

• Mod 端：直接使用。
• Bukkit 端：需安装执行上面的指令

权限提示

查询玩家特定信息（如 math 计算值）时，命令执行者必须是已绑定账号的用户，否则无法获取数据。

模板代码：

玩家名: %player_name%
造成伤害: %ez-statistic_DAMAGE_DEALT%点
受到伤害: %ez-statistic_DAMAGE_TAKEN%点
死亡次数: %ez-statistic_DEATHS%次
击杀玩家: %ez-statistic_PLAYER_KILLS%次
被人击杀: %ez-statistic_ENTITY_KILLED_BY$e=PLAYER$%次
在线时间: %math_2:2_{ez-statistic_PLAY_ONE_MINUTE}/20/60/60%小时
走过的路: %math_2:2_{ez-statistic_WALK_ONE_CM}/100%格
潜行时间: %math_2:2_{ez-statistic_SNEAK_TIME}/20/60%分钟
丢弃物品: %ez-statistic_DROP_COUNT%个
挖掘残骸: %ez-statistic_MINE_BLOCK$i=ANCIENT_DEBRIS$%个

效果展示 (命令)	效果展示 (回复)

---

示例 2: 服务器状态查询

依赖说明

• Mod 端：仅安装了TextPlaceholderAPI的Fabric端支持。
• Bukkit 端：需执行 papi ecloud download Server。

模板代码：

当前服务器在线: %server_online%/%server_max_players%人
TPS: %server_tps_5%
内存: %server_ram_used%MB/%server_ram_total%MB

效果展示 (命令)	效果展示 (回复)