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 (必需)
? 安装
- 下载 Mitra Leaderboards 及其依赖项。
- 将
.jar文件放入服务器的mods/文件夹中(如果需要 HUD 显示,客户端也需放入)。 - 启动服务器以生成配置文件文件夹。
- 配置
leaderboard.yml(如果计划使用离线追踪功能,还需配置mongo.yml)。 - 重启服务器。
⚙️ 配置
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 提供
Mitra Leaderboards
A flexible and high-performance leaderboard system for Fabric servers. It computes and publishes leaderboards from placeholders (e.g. blocks mined, play time, kills, etc.), with optional MongoDB support to store and display offline players.
✨ Features
- Multiple leaderboards: define as many holders as you want (e.g.
blocks_mined,time_played,kills…). - Native placeholders (pb4/Patbox): exposes values for TAB, HUDs, holograms, or any plugin/mod that reads placeholders.
- Per-holder update scheduling (configurable in seconds).
- Online or offline mode:
- Online-only: TOP is computed with currently connected players (no DB).
- Offline tracking: saves and queries from MongoDB for global TOPs.
- Asynchronous execution: safe capture on the server thread, heavy work in async workers.
- Optimized for thousands of players: efficient TOP-K selection, minimal I/O and CPU.
- Robust placeholder evaluation: cleans values and prevents crashes if a placeholder fails.
✅ Requirements
- Fabric Loader + Fabric API (server).
- pb4 Placeholders (Patbox) for placeholder resolution/registration.
- MongoDB (requerid)
? Installation
- Download Mitra Leaderboards and its requirements.
- Place the
.jarfiles in themods/folder of the server (and client if you want HUDs). - Start the server to generate the config folders.
- Configure
leaderboard.yml(andmongo.ymlif you plan to use offline tracking). - Restart.
⚙️ Configuration
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
? Placeholders
For a holder named blocks_mined:
? Size and timers
%mitra:leaderboard blocks_mined_size%→ number of entries.%mitra:leaderboard blocks_mined_update_in_s%→ seconds until the next update.%mitra:leaderboard blocks_mined_update_in_hms%→ remaining time inHH:MM:SS.
? TOP by position (N ≥ 1)
-
%mitra:leaderboard blocks_mined_value_N%→ numeric value. -
%mitra:leaderboard blocks_mined_player_N%→ player name. -
%mitra:leaderboard blocks_mined_uuid_N%→ player 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%
? Commands
(Base command may differ depending on your setup; examples use
/lb)
-
/lb reload
Reloads theleaderboard.ymlconfiguration and reschedules all tasks.
Useful when you change values in the config without restarting the server. -
/lb recompute <holder>
Forces an immediate recompute of the specified holder.
Example:/lb recompute blocks_minedwill update the ranking for theblocks_minedleaderboard instantly. -
/lb list
Displays a list of all currently active holders.
Example output:
?? Authors & Credits
- Developer:
srmast3r_(SrMaster) - Twitter/X: @SrMaster
- Credits: pb4 Placeholders by Patbox
下载 Leaderboard
下载 Leaderboard
下载 Leaderboard
下载 Leaderboard
下载 Leaderboard
下载 Leaderboard
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Leaderboard
下载 Leaderboard
下载 Leaderboard
暂无更新日志
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
一个用于收集生物掉落物的多区块模组。
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
查看物品与配方
模组
AE2:一款流行的自动化与存储模组
评论 0
登录后参与评分
还没有评论,来抢沙发吧