采矿统计

⛏️ 采矿统计 (MiningStats)

追踪你开采的每一种矿石。查看你的时运加成。一切尽在简洁的 HUD 中。

MiningStats 是一个轻量级的、客户端 Fabric 模组，可直接在你的屏幕上显示实时采矿统计数据。无论你是在为钻石而挖矿，还是在猪灵城堡中寻找远古残骸——MiningStats 都会帮你计数，无需自己操心。

---

✨ 功能特性

📊 实时矿石追踪

• 手动会话控制 — 随时按 J 键开始或暂停追踪
• 自动计数 — 活动会话期间，你开采的每一种矿石都会立即被追踪
• 10 种原版矿石 — 煤炭、铁、金、钻石、绿宝石、青金石、红石、铜、下界石英、远古残骸
• 深板岩支持 — 可识别深板岩变种，并可选地将其与普通矿石合并计算
• 模组矿石支持 — 在配置文件中添加自定义方块 ID（例如 create:zinc_ore）
• 智能检测 — 仅统计玩家开采的矿石（忽略 TNT、活塞、命令等造成的破坏）

🍀 时运加成计算

• 实时追踪 — 精确查看时运为你额外增加了多少掉落物
• 按矿石分类统计 — 每种矿石的时运加成会单独追踪
• 精准采集感知 — 自动检测精准采集附魔，并跳过加成计数

🖥️ 简洁的 HUD 覆盖层

• 矿石图标 — 每个矿石数量旁都有精美的物品图标
• 两种显示模式 — 按 H 键在完整和紧凑 HUD 模式间切换
• 会话计时器 — 追踪你实际采矿的时长（暂停时间不计入）
• 暂停指示器 — 会话暂停时，HUD 标题会以橙色显示暂停状态
• 智能可见性 — 仅在你手持镐子时才显示 HUD，保持屏幕整洁
• 透明度可调节 — 自定义背景透明度

🎉 里程碑与特效

• 里程碑提醒 — 当达到里程碑（如 100 颗钻石）时，在聊天栏收到消息
• 金色闪光 — 开采钻石或远古残骸时的视觉效果
• 会话总结 — 离开世界时在聊天栏查看你的完整统计数据

---

🎮 操作控制

按键	功能
J	开始 / 暂停会话
H	切换紧凑 / 完整 HUD 模式
K	重置当前会话

---

⚙️ 自定义配置

可通过 Mod Menu + Cloth Config 在游戏内配置模组，或直接编辑 .minecraft/config/miningstats.json 文件：

• HUD 位置（屏幕四角均可）
• HUD 背景透明度
• 始终显示或仅手持镐子时显示
• 合并深板岩变种开关
• 自定义里程碑阈值
• 模组矿石追踪
• 会话总结开关

---

📋 环境要求

• Minecraft: 1.21 – 1.21.11 & 26.x
• Fabric Loader: 0.18.3 或更高版本
• Fabric API: 必需
• Java: 21 或更高版本
• Mod Menu + Cloth Config: 可选（用于游戏内配置界面）

---

🚀 工作原理

1. 加入世界后，你会收到按 J 键的提示
2. 按 J 键开始你的采矿会话
3. 开采矿石 — HUD 会实时更新数量和时运加成
4. 再次按 J 键暂停追踪（计时器也会暂停）
5. 达成里程碑？你会收到聊天通知！
6. 离开世界即可获得完整的会话总结

随时开始、暂停和继续——一切尽在你的掌控之中。

---

💡 适合人群

• 鱼骨矿工 — 在漫长的采矿旅程中追踪你的钻石收获
• 下界探险家 — 无需纸笔，轻松统计每一块远古残骸
• 时运测试者 — 精确了解时运附魔为你提升了多少掉落
• 收集控 — 在采矿的同时冲击里程碑成就
• 所有人 — 任何希望一目了然地了解自己采矿数据的玩家！

---

❓ 常见问题 (FAQ)

这个模组能在服务器上使用吗？ 可以！它完全在客户端运行，无需在服务器端安装即可在任何服务器上使用。

它会影响游戏性能吗？ 不会。MiningStats 非常轻量，仅在您破坏矿石方块时处理数据。

统计数据会跨会话保存吗？ 不会。统计数据仅限单次会话，离开世界时会被重置。你也可以按 K 键手动重置。

它能准确检测时运效果吗？ 可以。MiningStats 会读取你手持镐子上的时运等级，并根据实际掉落的物品计算加成。

---

🌍 支持语言

支持 英语 和 德语。

🔗 相关链接

• 问题与漏洞反馈： GitHub Issues
• 源代码： GitHub Repository

📜 开源许可

本模组为开源项目，采用 MIT 许可证 授权。