- 版权类型
- 原创
- 插件中文名称
- 排行榜
- 插件英文名称
- CyTop
- 支持的核心（服务端）
- Paper
- 语言支持
- 中文（简体）
- 适配版本（Java）
- 1.21
CyTop全息排行榜 · 把榜单挂在天上
金币 / 点券 / 在线时长 / mcMMO / 蟠桃血量 / PAPI 变量
你是不是也遇到过
- 想做金币排行，摆了 20 块告示牌，每周手动改一次
- 玩家问「我排第几」，你得翻后台、查数据库
- 计分板想显示榜首，还得自己写变量、对格式
- 换个赛季，排行榜全部重摆
服主 说：
CyTop 就是把这个需求一次做完的插件。
装上去之后
- 以前：告示牌 × N、手动更新、只能看一个榜、赛季重摆
- 现在：一条指令生成、60 秒自动刷新、多榜并行、清空重排
核心功能
- 六种数据源：Vault 金币、PlayerPoints 点券、在线时长、mcMMO、蟠桃血量、PAPI 变量
- 全息显示：悬浮文字，位置、行数、颜色、格式都能改
- 自动刷新：默认 60 秒一轮，可只刷新在线玩家
- 多榜并行：金币榜、点券榜、时长榜同时存在，互不影响
- 排行奖励：日榜 / 周榜 / 月榜自动结算，也能手动补发
- 过滤规则：OP、黑名单、异常值自动跳过
- PAPI 输出：变量可直接用在计分板、Tab、BossBar
三个常见场景
🏙 主城展示
在出生点上方挂「金币榜」「在线时长榜」，新玩家一进来就能看到目标。
赛季活动
开新赛季时清空重排，配合日/周/月奖励，榜单本身就是活动入口。
计分板联动
%cytop_vault_1_name% 直接写进计分板，榜首自动变化。
运行环境
- 服务端：Paper 1.21.11
- Java：21 及以上
- 硬依赖：无
- 软依赖：Vault / PlayerPoints / mcMMO / PlaceholderAPI / PeachHP
软依赖不装也能启动，只是对应榜单没有数据。
三步开榜
- 把
CyTop-1.3.3.jar放进plugins/，重启服务器 - 站在想显示的位置，执行
/ct create vault - 执行
/ct refresh，抬头就能看到榜单
常用命令
/ct create <类型>—— 在当前位置创建排行榜/ct list—— 列出所有排行榜/ct info <名称>—— 查看详情/ct del <名称> [序号]—— 删除排行榜或某行/ct confirm//ct cancel—— 确认 / 取消删除/ct move <名称> [序号]—— 移动排行榜/ct tp <名称> <序号>—— 传送到排行榜/ct toggle <名称>—— 显示 / 隐藏/ct on / off <名称>—— 开启 / 关闭/ct setpapi <名称> <变量>—— 设置 PAPI 数据源/ct refresh [名称|all]—— 刷新数据/ct reload—— 重载配置/ct reward <类型>—— 手动发放排行奖励/ct top—— 查看排行榜页/ct rank [玩家]—— 查看名次
权限
cytop.admin—— 全部权限cytop.command.help—— 帮助cytop.command.list—— 列表cytop.command.info—— 详情cytop.command.create—— 创建cytop.command.remove—— 删除cytop.command.move—— 移动cytop.command.toggle—— 显示开关cytop.command.setpapi—— 设置 PAPI 变量cytop.command.refresh—— 刷新cytop.command.reload—— 重载cytop.command.reward—— 发放奖励
配置示例
YAML：
refresh-interval: 60 # 刷新间隔（秒），最小 10，0 关闭
sync-mode: online # online 只刷在线，offline 同时刷离线
init-on-startup: false
filter:
op: false # OP 是否不参与排行
blacklist:
- "CMI-Fake-Operator"
values:
- "-1" # 取到这些值时跳过
sources:
vault: true
player-points: true
playtime: true
mcmmo: true
peachhp: true
papi: true
display:
thousand-separator: true
playtime-unit: auto # auto / hours / minutes
reward:
enabled: true
daily: true
weekly: true
monthly: true
PAPI 变量
%cytop_vault_1_name%—— 金币榜第 1 名玩家%cytop_vault_1_total%—— 金币榜第 1 名数值%cytop_playtime_10_total%—— 在线时长榜第 10 名
常见问题
Q：排行榜不显示？
先执行
/ct list 看榜是否存在，再检查 holograms.yml 是否启用、位置是否已加载、/ct refresh 是否成功。Q：数据一直是 0？
对应数据源没开，或前置没装：
金币要 Vault + 经济插件，点券要 PlayerPoints，mcMMO 要 mcMMO，蟠桃血量要 PeachHP。
Q：PAPI 排行榜没数据？
/ct setpapi <名称> <变量> 后执行 /ct refresh；变量返回 -1 时默认会被
filter.values 跳过。Q：奖励什么时候发？
reward.daily/weekly/monthly 分别按日/周/月结算，也可 /ct reward 手动发放。Q：会卡吗？
默认 60 秒一轮，还能只刷在线玩家，正常服不用担心。
Q：支持 Folia 吗？
目前只保证 Paper 1.21.11。
更新日志
v1.3.3
v1.3.2
v1.3.0
/ct top的类型提示只列出已开放可查询的类型- Tab 补全同步过滤
v1.3.2
- 数据源未启用时给出明确提示
v1.3.0
- 新增
/ct top、/ct rank - 新增对应权限节点
文档
license.mc33.top/docs/cytop
如果这个插件帮到了你，欢迎评分和反馈。
