Minecraft Digging Leaderboard (挖掘榜)

Minecraft Fabric 模组 | 实时追踪玩家挖掘方块数量 | 自动更新计分板排行榜

Minecraft Fabric Mod | Tracks Player Block Mining in Real-Time | Auto-Updating Scoreboard Leaderboard

Digging Leaderboard 是一款专为 Minecraft Fabric 服务器设计的模组，利用游戏内置的记分板系统，实时跟踪并显示每位玩家挖掘各类方块的数量统计。服务器管理员可以通过这些数据了解玩家的活跃度，玩家也能直观地展示自己的挖掘成果。模组轻量、只需简单配置，即装即用，为你的服务器或单人游戏增添更多趣味与数据可视化体验。

Digging Leaderboard is a module designed for Minecraft Fabric servers, Utilizing the game's built‑in scoreboard system, it tracks and displays real‑time statistics of each player's block mining. Server administrators can use this data to gauge player activity, while players can intuitively showcase their mining achievements. Lightweight and requiring only simple configuration, it's plug‑and‑play, adding extra fun and data visualization to your server or single‑player game.

(图示：游戏内计分板排行榜效果) (Illustration: In-game Scoreboard Leaderboard Effect)

✨ 核心功能 / Core Features

• 实时追踪挖掘数据 / Real-time mining data tracking
• 自动记录玩家挖掘的方块数量 / Automatically records the number of blocks mined by players
• 实时TPS显示 / Real-time TPS display

⚙️ 安装指南 / Installation Guide

• Minecraft 1.20.1 服务端 / Fabric Loader 0.14.21+
• Minecraft 1.21.11 服务端 / Fabric Loader 0.18.4+

1. 将文件放入服务器 server/mods 文件夹；

   • Place the file into the server server/mods folder;

2. 重启服务器；

   • Restart the server;

3. 首次使用该 Mod 将在 server/config/digging_leaderboard 下生成配置文件及所需的数据存储文件；

   • On first use, the Mod will generate configuration files and necessary data storage files in server/config/digging_leaderboard;

4. 配置文件解析 / Configuration File Explanation：

   • config.json

   {
       "scoreboardName": "§e挖掘榜", // 挖掘榜计分板显示名称
       "scoreboardPlayerCount": 10, // 挖掘榜计分板显示玩家人数，只显示前10名（可配置）
       "scoreboardAutoSaveTime": 7200, // 自动保存数据文件时间（单位/秒）
       "scoreboardDisplayTps": true, // 是否显示游戏 TPS
       "scoreboardDisplaySystemUsage": true, // 是否显示服务器 CPU 和 Memory 占用
       "namePrefixBans": [] // 不允许显示的玩家名前缀（如假人的‘_’）
   }
   

🤝 贡献指南 / Contribution Guidelines

AGPLv3 贡献条款 / AGPLv3 Contribution Terms:

1. 提交PR即表示您同意根据AGPLv3授权代码。

   • Submitting a PR means you agree to license the code under AGPLv3.

2. 所有贡献将被纳入AGPLv3授权范围。

   • All contributions will fall under the AGPLv3 license scope.

3. 贡献者保留其代码的版权。

   • Contributors retain the copyright of their code.

欢迎 / Welcome:

• Bug报告：创建 Issue / Bug Reports: Create an Issue.
• PR提交：遵循 AGPLv3 要求 / PR Submissions: Follow AGPLv3 requirements.
• 翻译支持：完善多语言文件 / Translation Support: Improve multilingual files.
• 功能建议：通过 Discussion 提出想法 / Feature Suggestions: Propose ideas through Discussion.

联系作者 / Contact:

• 1.20.1 版本作者邮箱：c6c606@outlook.com / 1.20.1 Author Email: c6c606@outlook.com
• 1.21.11 版本适配者邮箱：1504273583@qq.com / 1.21.11 Author Email: 1504273583@qq.com

分发要求（对于衍生版本） / Distribution Requirements (for derivative versions):

• 在显著位置提供源代码访问 / Provide access to source code in a prominent location.
• 明确说明使用AGPLv3许可证 / Clearly state the use of the AGPLv3 license.
• 提供完整的修改记录 / Provide complete modification records.

📜 许可证 / License

本项目采用 GNU Affero General Public License v3.0 - 查看 LICENSE 文件了解完整条款。

This project is licensed under the GNU Affero General Public License v3.0 - see the LICENSE file for full terms.

⛏️ AGPLv3 保障每位用户的自由权利，让开源共同进步！

AGPLv3 guarantees the freedom rights of every user, promoting open-source progress together!

🥚 番外 / Extra

关于创作者 / About the Creator

本项目的创作者 iL6hua 是个 JAVA 小白，当时在写这个项目的时候属于第一次学习和使用 JAVA ；希望大佬们看到项目的shi山代码能够轻点喷QwQ。

The creator of this project, iL6hua , is a JAVA novice. This project was their first time learning and using JAVA; I hope the experts can go easy on the "spaghetti code" when reviewing it QwQ.

本项目的1.21.11适配者 猫小诗CatXiaohi 是个 JAVA 小白，当时在适配这个项目的时候属于第一次学习和使用 JAVA ，照着教程一点点来的，编译了100多次，搞了个通宵qwq

The 1.21.11 adapter for this project,猫小诗CatXiaohi, is also a JAVA novice. The adaptation process was their first time learning and using JAVA, following tutorials step by step, compiling over 100 times, and staying up all night qwq.