PAPI 变量

服务器安装 PlaceholderAPI 后，可以在计分板、TAB、聊天、菜单和 GTPay GUI 中使用 GTPay 变量。

变量前缀：

gtpay

玩家累计金额

变量	说明
%gtpay_total%	玩家永久累计赞助金额
%gtpay_amount%	与 %gtpay_total% 相同
%gtpay_rank%	玩家永久累计赞助排名
%gtpay_topup_total%	玩家永久点券充值总额
%gtpay_gift_total%	玩家永久礼包购买总额

金额统一保留两位小数。

指定方案玩家变量

假设方案 ID 为 monthly：

变量	说明
%gtpay_sponsor_monthly_total%	本月累计金额
%gtpay_sponsor_monthly_rank%	本月排名
%gtpay_sponsor_monthly_next%	下一档金额
%gtpay_sponsor_monthly_remaining%	距离下一档还差多少

永久方案：

%gtpay_sponsor_lifetime_total%
%gtpay_sponsor_lifetime_rank%
%gtpay_sponsor_lifetime_next%
%gtpay_sponsor_lifetime_remaining%

活动方案 ID 为 summer_2026：

%gtpay_sponsor_summer_2026_total%
%gtpay_sponsor_summer_2026_rank%
%gtpay_sponsor_summer_2026_next%
%gtpay_sponsor_summer_2026_remaining%

永久累计排行榜

第 1 名：

%gtpay_rank_1_name%
%gtpay_rank_1_amount%

第 2 名：

%gtpay_rank_2_name%
%gtpay_rank_2_amount%

依次支持到任意名次。常用前 10 名：

%gtpay_rank_1_name%   %gtpay_rank_1_amount%
%gtpay_rank_2_name%   %gtpay_rank_2_amount%
%gtpay_rank_3_name%   %gtpay_rank_3_amount%
%gtpay_rank_4_name%   %gtpay_rank_4_amount%
%gtpay_rank_5_name%   %gtpay_rank_5_amount%
%gtpay_rank_6_name%   %gtpay_rank_6_amount%
%gtpay_rank_7_name%   %gtpay_rank_7_amount%
%gtpay_rank_8_name%   %gtpay_rank_8_amount%
%gtpay_rank_9_name%   %gtpay_rank_9_amount%
%gtpay_rank_10_name%  %gtpay_rank_10_amount%

没有对应名次时返回空文本。

指定方案排行榜

格式：

%gtpay_rank_<方案ID>_<名次>_name%
%gtpay_rank_<方案ID>_<名次>_amount%

月累计前 3 名：

%gtpay_rank_monthly_1_name%
%gtpay_rank_monthly_1_amount%

%gtpay_rank_monthly_2_name%
%gtpay_rank_monthly_2_amount%

%gtpay_rank_monthly_3_name%
%gtpay_rank_monthly_3_amount%

活动排行榜：

%gtpay_rank_summer_2026_1_name%
%gtpay_rank_summer_2026_1_amount%

TAB 示例

- "&6永久赞助: &f%gtpay_total% 元"
- "&6永久排名: &f#%gtpay_rank%"
- "&e本月赞助: &f%gtpay_sponsor_monthly_total% 元"
- "&e距离下一档: &f%gtpay_sponsor_monthly_remaining% 元"

排行榜示例

- "&6&l累计赞助排行榜"
- "&e1. &f%gtpay_rank_1_name% &7- &6%gtpay_rank_1_amount% 元"
- "&e2. &f%gtpay_rank_2_name% &7- &6%gtpay_rank_2_amount% 元"
- "&e3. &f%gtpay_rank_3_name% &7- &6%gtpay_rank_3_amount% 元"
- "&e4. &f%gtpay_rank_4_name% &7- &6%gtpay_rank_4_amount% 元"
- "&e5. &f%gtpay_rank_5_name% &7- &6%gtpay_rank_5_amount% 元"

变量不解析

检查：

1. PlaceholderAPI 是否安装并正常启用。
2. GTPay 是否已经加载。
3. 方案 ID 是否与 sponsorship.yml 完全一致。
4. 修改配置后是否执行 /gtpay reload。
5. 使用变量的位置是否支持 PlaceholderAPI。

变量仍不解析时，先确认 PlaceholderAPI 已启用，再检查变量所在的计分板、菜单或聊天插件是否支持 PlaceholderAPI。