Leaderboard

模组

· 作者 SrMaster

为任何数据创建排行榜

0 本站下载 0 关注 更新于 3 个月前

最新 1.1+1.21.8 · 1.21.8 · Fabric

一键开服(送7天)

Mitra Leaderboards

一个适用于 Fabric 服务器的灵活且高性能的排行榜系统。它通过占位符(例如:挖掘方块数、游戏时长、击杀数等)计算并发布排行榜,并可选支持 MongoDB 以存储和显示离线玩家。


✨ 特性

  • 多排行榜:你可以定义任意数量的 持有者(holders,即排行榜类型),例如 blocks_mined、time_played、kills 等。
  • 原生占位符 (pb4/Patbox):为 TAB 列表、HUD、全息图或任何读取占位符的插件/模组暴露数值。
  • 按持有者更新调度:可配置秒级更新间隔。
  • 在线或离线模式:
    • 仅在线:TOP 排名仅基于当前连接的玩家计算(无需数据库)。
    • 离线追踪:保存并从 MongoDB 查询数据,生成全局 TOP 排名。
  • 异步执行:在主线程安全捕获数据,繁重工作在异步线程中处理。
  • 针对数千名玩家优化:高效的 TOP-K 选择算法,最小化 I/O 和 CPU 开销。
  • 健壮的占位符评估:清理数值,防止因占位符失败导致崩溃。

✅ 要求

  • Fabric Loader + Fabric API(服务端)。
  • pb4 Placeholders (Patbox) 用于占位符解析/注册。
  • MongoDB (必需)

? 安装

  1. 下载 Mitra Leaderboards 及其依赖项。
  2. 将 .jar 文件放入服务器的 mods/ 文件夹中(如果需要 HUD 显示,客户端也需放入)。
  3. 启动服务器以生成配置文件文件夹。
  4. 配置 leaderboard.yml(如果计划使用离线追踪功能,还需配置 mongo.yml)。
  5. 重启服务器。

⚙️ 配置

leaderboard.yml

holders:
  blocks_mined:
    valueCheck: "%mitra:mined_total%"
    update: 20
    top: 10
    trackOffline: false

  time_played:
    valueCheck: "%mitra:play_time%"
    update: 30
    top: 15
    trackOffline: true

? 占位符

对于名为 blocks_mined 的 持有者:


? 大小与计时器

  • %mitra:leaderboard blocks_mined_size% → 条目数量。
  • %mitra:leaderboard blocks_mined_update_in_s% → 距离下次更新的秒数。
  • %mitra:leaderboard blocks_mined_update_in_hms% → 剩余时间,格式为 HH:MM:SS。

? 按位置获取 TOP 排名 (N ≥ 1)

  • %mitra:leaderboard blocks_mined_value_N% → 数值。

  • %mitra:leaderboard blocks_mined_player_N% → 玩家名称。

  • %mitra:leaderboard blocks_mined_uuid_N% → 玩家 UUID。

  • #1 %mitra:leaderboard blocks_mined_player_1% — %mitra:leaderboard blocks_mined_value_1%

  • #2 %mitra:leaderboard blocks_mined_player_2% — %mitra:leaderboard blocks_mined_value_2%

  • #3 %mitra:leaderboard blocks_mined_player_3% — %mitra:leaderboard blocks_mined_value_3%


? 命令

(基础命令可能因你的设置而异;以下示例使用 /lb)

  • /lb reload
    重新加载 leaderboard.yml 配置并重置所有任务调度。
    当你修改了配置文件但不想重启服务器时非常有用。

  • /lb recompute <holder>
    强制立即重新计算指定的持有者。
    例如:/lb recompute blocks_mined 将立即更新 blocks_mined 排行榜的排名。

  • /lb list
    显示所有当前活动的持有者列表。
    示例输出:


?‍? 作者与致谢

  • 开发者: srmast3r_ (SrMaster)
  • Twitter/X: @SrMaster
  • 致谢: pb4 Placeholders 由 Patbox 提供

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源