KoksMiner - 高级采矿助手

KoksMiner 是一款完全客户端的 Fabric 模组，用于可配置的 AFK 挖矿自动化。它结合了定点挖矿、移动路线、计划命令、自动丢物品、安全的自动进食、工具保护、持久化统计和可编辑的 HUD。

该模组使用 Minecraft 标准的输入和物品栏机制，无需在服务端安装。

重要提示： 某些服务器可能禁止使用自动化功能。使用 KoksMiner 前请务必查看服务器规则。

主要功能

• 定点挖矿，或使用蛇形、往返、环形和阶梯路线进行移动挖矿。
• 可配置的行数、路线长度和每方块时间，并提供可视化的方块网格预览。
• 独立的计划命令，带实时 HUD 倒计时。
• 适用于全部 36 个物品栏和快捷栏位置的逐槽位 ONE 或 STACK 丢弃规则。
• 安全的快捷栏自动进食，带可配置的饥饿值阈值。
• 工具保护功能，会在手持物品损坏前停止挖矿。
• 持久化统计和事件日志，涵盖会话、死亡和自动化操作。
• 可移动、可独立缩放的状态和通知 HUD 元素。
• 响应式界面，支持 Minecraft GUI 缩放级别 1–5。
• 支持英语和波兰语翻译。

操作控制

• HOME — 打开 KoksMiner 配置界面。
• END — 启动或停止自动化。

这两个按键绑定都可以在 Minecraft 的控制菜单中修改。

安装与兼容性

KoksMiner 需要 Fabric Loader、Fabric API 和 Java 21。它支持 Minecraft 1.21.1–1.21.11，每个精确的游戏版本都有独立的 JAR 文件。请只安装与你 Minecraft 版本匹配的文件。

该模组仅限客户端使用。不需要 Cloth Config、Mod Menu 或服务端安装。

有意为之的限制

KoksMiner 不包含自动旋转视角、智能方块选择、寻路、避障、自动切换工具、自动重连或绕过反作弊的功能。后台运行需要 Minecraft 持续处理游戏刻（tick）。

合规使用责任

KoksMiner 自动化的是标准的客户端输入操作。它并非设计为不可检测，也无法保证符合每个服务器的规则。你需自行负责使用它的方式和场合。

整合包许可

托管在 Modrinth 上的 KoksMiner 官方文件可被包含在 Modrinth 整合包中。本项目基于 MIT 许可证发布。