LogoArcartX Doc

PlaceholderAPI 集成

在计分板、TAB 与全息图中显示 Rondo 余额和排行榜

Rondo 的占位符可用于计分板、TAB、全息图和聊天格式。

启用

  1. 安装与目标服务端兼容的 PlaceholderAPI。
  2. 确认 config.yml 中启用：
features:
  papi-hook: true
  1. 重启服务端。

占位符

占位符说明示例输出
%rondo_balance_<ID>%仅余额数字1500
%rondo_balance_formatted_<ID>%货币颜色、符号与余额§6G1500.00
%rondo_total_earned_<ID>%累计获得25000
%rondo_total_spent_<ID>%累计消耗18000
%rondo_top_<ID>_<排名>_name%第 N 名玩家名Steve
%rondo_top_<ID>_<排名>_balance%第 N 名余额99999
%rondo_rank_<ID>%当前玩家排名5

排行榜占位符要求货币设置 ranking-enabled: true。玩家未上榜时返回 未上榜，名次没有数据时返回 ---。

余额与累计值占位符只读取不可变内存快照，不会在 PlaceholderAPI 调用线程同步访问数据库。离线玩家首次读取、TTL 到期或容量驱逐后会先返回 ---，同时发起一次去重的后台整账户加载；后续刷新会显示实际值。

离线快照的存活时间与容量分别由 performance.read-cache-offline-ttl-seconds 和 performance.read-cache-max-offline-entries 控制。在线快照会在本服资金事务、跨服失效通知和 Redis 重连校准后更新。

示例

%rondo_balance_gold%
%rondo_balance_formatted_points%
%rondo_top_gold_1_name%: %rondo_top_gold_1_balance%
%rondo_rank_gold%

计分板配置示例：

lines:
  - "&6G 金币: &f%rondo_balance_gold%"
  - "&bP 点券: &f%rondo_balance_points%"
  - "&dH 荣誉: &f%rondo_balance_honor%"
  - ""
  - "&e排名: #%rondo_rank_gold%"

Previous

Vault 集成

Next

API 概览

On this page