mcstats

MC 统计模组

一款服务端 Fabric 模组，用于追踪玩家统计数据并将其推送至外部数据库。兼容原版客户端——玩家无需安装任何内容。

追踪内容

• 所有原版统计：方块破坏/放置、物品使用/合成、击杀、死亡、伤害、移动、游戏时长等。
• 自然挖掘方块：区分世界生成时破坏的方块与玩家放置的方块。任务系统无法通过放置再重新挖掘圆石来作弊。
• 自定义统计：按原因分类的死亡、附魔次数、访问过的独特生物群系、图腾使用次数、睡眠次数、单次最高伤害。

数据发送位置

在配置中选择一种：

后端	用途
logging	测试——打印到服务器控制台
sqlite	单服务器设置，零配置
mysql	在多个服务间共享数据
webhook	自定义仪表盘、Discord 机器人、数据分析——向任意 URL 发送 JSON

设置

1. 将 jar 文件放入服务器的 mods/ 文件夹（与 Fabric API 一同放置）。
2. 启动服务器一次——它会生成 config/mcstats.json。
3. 编辑配置，然后重启。

就是这样。默认配置会记录到控制台，以便你在连接数据库之前验证其是否正常工作。

为什么使用此模组而非 Discord 统计模组？

大多数统计模组与单一输出（特定 Discord 机器人、特定覆盖层）绑定。本模组是中立的推送——你的终端接收 JSON，由你决定如何处理。构建排行榜网站、Grafana 仪表盘、任务插件、MMO 经济追踪器——模组本身并不关心。

链接

• 完整文档、配置参考、故障排除：GitHub
• 问题 / 功能请求：GitHub Issues
• 许可证：CC0 1.0——公有领域。