MCminer
- By
Auto mining mob entity. Spawn a miner, load a pickaxe, and it mines ores automatically within 4 chunks of the owner.
Desktop Screenshot 2026.08.25 - 17.06.31.63.png
Description
# ⛏ MC Miner
[](LICENSE)
> 一个为 Minecraft 26.2 / Fabric 打造的自动挖矿模组。放下矿工、塞上镐子，矿物直接飞进你的背包。
---
## 📖 简介
**MC Miner** 让你在 Minecraft 中拥有一位不知疲倦的矿工助手。它有两种工作模式，覆盖单人与多人场景：
- **单人客户端模式**：无需召唤实体，直接在集成服务器上扫描并破坏玩家周围的矿石，适合快速采矿。
- **服务器实体模式**：召唤一个无敌的矿工实体，它持有镐子，在玩家周围 4 区块范围内自动挖矿，适合多人服务器与生存长期挂机。
无论你用哪种模式，挖到的矿物都会**直接进入玩家背包**，背包满了才掉落在地上，省去来回搬运的烦恼。
---
## ✨ 为什么选择 MC Miner？
| 优势 | 说明 |
|---|---|
| **🎯 超大扫描范围** | 水平 4 区块（64 格半径）、垂直 256 格（±128）超大范围，轻松覆盖大型矿脉。 |
| **🎒 掉落物直送背包** | 矿物不再暂存实体仓库，直接塞进玩家背包；溢出才以物品实体形式掉落。 |
| **⚔ 双模式兼容** | 单人模式零配置即开即挖；服务器模式通过命令/实体管理，适合多人联机。 |
| **🛡 无敌矿工实体** | 服务器模式下的矿工不可被攻击、不可推动、不怕火/水，专注挖矿一百年。 |
| **🔧 11 种矿物自由开关** | coal、iron、copper、gold、redstone、lapis、diamond、emerald、下界石英、下界金、远古残骸，想挖哪种就挖哪种。 |
| **⏱ 定时挖矿** | 可设定挖矿秒数，时间到自动停止并传送回玩家身边。 |
| **🖱 一键面板** | 单人模式在暂停菜单点击「MC Miner」即可打开配置；服务器模式右键实体即可配置。 |
| **🧬 原生 Fabric** | 完全使用 Fabric API 与 Mojang 映射，兼容官方 Minecraft 26.2。 |
---
## 🚀 功能详解
### 1. 单人客户端自动挖矿
- 进入单人世界后，按 `Esc` 打开暂停菜单，点击左上角的 **「⛏ MC Miner」** 按钮。
- 在面板中选择要挖的矿物、设置工作秒数，点击 **Start**。
- 每 tick 自动寻找最近的已选矿物，玩家视角自动转向目标，镐子自动挥动并破坏方块。
- 矿物直接进入玩家背包。
> ⚠️ 单人模式依赖集成服务器，仅在单人世界可用；多人服务器请使用下面的实体模式。
### 2. 服务器矿工实体
- 使用命令 `/mcminer spawn [秒数]` 在玩家位置召唤矿工。
- 第一次右键矿工放入任意品质的镐子（默认已自带铁镐）。
- 再次右键打开配置面板，选择矿物并点击 **Start**。
- 矿工会以玩家为中心，在 4 区块 / 256 垂直范围内自动挖掘。
- 时间结束后自动停止并传送到玩家身边。
### 3. 矿物列表
| 标识 | 覆盖方块 |
|---|---|
| Coal | 煤矿石、深层煤矿石 |
| Iron | 铁矿石、深层铁矿石 |
| Copper | 铜矿石、深层铜矿石 |
| Gold | 金矿石、深层金矿石 |
| Redstone | 红石矿石、深层红石矿石 |
| Lapis | 青金石矿石、深层青金石矿石 |
| Diamond | 钻石矿石、深层钻石矿石 |
| Emerald | 绿宝石矿石、深层绿宝石矿石 |
| Nether Quartz | 下界石英矿石 |
| Nether Gold | 下界金矿石 |
| Ancient Debris | 远古残骸 |
---
## ⌨️ 命令列表
所有命令均需要 OP 权限或单人游戏作弊开启。
```mcfunction
/mcminer spawn [seconds] # 在玩家位置生成矿工
/mcminer spawnat <x> <y> <z> [seconds] # 在指定坐标生成矿工
/mcminer start # 启动当前维度所有矿工
/mcminer stop # 停止当前维度所有矿工
/mcminer killall # 移除当前维度所有矿工
/mcminer list # 列出当前维度所有矿工及状态
/mcminer tphere # 将所有矿工传送到玩家身边
/MC <subcommand> # /mcminer 的简写别名
```
---
## 📦 安装方法
### 前置需求
- Minecraft **26.2**
- Fabric Loader **≥ 0.19.3**
- Fabric API **0.155.2+26.2** 或更高
- Java **25**
### 安装步骤
1. 从 [Releases](../../releases) 下载最新版 `mc-miner-5.0.0.jar`。
2. 将 JAR 文件放入 `.minecraft/mods/` 文件夹。
3. 使用 Fabric 启动器启动游戏。
4. 进入世界即可使用。
---
## 🔨 自行编译
如果你希望从源码构建，请参考 [README_COMPILE.md](README_COMPILE.md)。
快速命令（Windows）：
```cmd
cd mc-miner-26.2
gradlew build
```
编译成功后 JAR 位于：
```
build/libs/mc-miner-5.0.0.jar
```
---
## 📜 开源与许可
本项目基于 [MIT](LICENSE) 协议开源，欢迎 Fork、提交 Issue 和 Pull Request。
作者：**Cowork 3P**
---
## 💡 常见问题
**Q：多人服务器能用吗？**
A：可以。使用 `/mcminer spawn` 召唤矿工实体，掉落物直接进入主人背包。
**Q：单人模式为什么不挖矿？**
A：请确认你手持镐子、处于单人世界、且已点击 Start。
**Q：矿工实体不显示 GUI 怎么办？**
A：当前版本实体 GUI 面板注册在部分客户端可能不弹出，命令 `/mcminer start/stop` 始终可用。
**Q：挖到的矿物去哪里了？**
A：直接进入玩家背包；若背包已满，会掉落在玩家（实体模式）或矿石位置（单人模式）附近。
---
*Enjoy mining! ⛏*
The MCminer Team
