bettervein

Better Vein（更好的连锁）

一款强大的连锁采集与农业模组：一次挖掘连锁整片矿脉（分散的也能挖）、一键砍整棵树、一键锄地、一键种植，掉落物自动聚到脚下。

---

## ✨ Features / 功能

| 功能 | 说明 |
|---|---|
| ⛏️ **连锁挖矿** | 挖掘一个方块，连锁破坏区域内所有同类型方块（默认半径 8，**包括分散的矿石**） |
| 🌳 **一键砍树** | 破坏一个原木，整棵树倒下 —— **不会误伤邻近的树木** |
| 🚜 **一键锄地** | 按住按键 + 右键使用锄头：一次锄出 (2R+1)² 的农田区域 |
| 🌱 **一键种植** | 按住按键 + 右键使用种子/树苗：一次种植整个区域 |
| 🎒 **掉落物聚集** | 所有连锁采集的掉落物都会飞到你的脚下 |
| 👁️ **实时预览** | 按住按键时，在破坏前即可看到精确的连锁数量及白色描边 |
| ⚙️ **高度可配置** | 半径、最大方块数、模式等全部可调 |

---

## 🎮 How to Use / 操作方式

**默认按键：飘号键（`` ` ``，位于 `1` 键左侧、ESC 下方）** — 可在按键设置中修改。

| 操作 | 输入 |
|---|---|
| 连锁挖矿/砍树 | 按住按键 + **左键** |
| 一键锄地 | 按住按键 + **右键** 使用锄头 |
| 一键种植 | 按住按键 + **右键** 使用种子/树苗 |

按住按键时，瞄准方块即可预览连锁范围（数量 + 白色描边）。

 

---

## ⚙️ Configuration / 配置

- **Forge**: `config/bettervein-common.toml`
- **Fabric**: `config/bettervein.json`（可通过 Cloth Config + Mod Menu 在游戏中编辑）

| 选项 | 默认值 | 说明 |
|---|---|---|
| `veinMining.areaMode` | `true` | 区域连锁：连锁半径内所有同类型方块（包括分散的） |
| `veinMining.areaRadius` | `8` | 区域连锁半径（1–32） |
| `veinMining.maxBlocks` | `64` | 每次连锁的最大方块数 |
| `veinMining.treeMode` | `true` | 树木模式：仅原木，树叶自然掉落 |
| `veinMining.gatherDrops` | `true` | 将掉落物聚集到脚下 |
| `veinMining.requireKey` | `true` | 仅按住热键时触发连锁 |
| `massTill.radius` | `3` | 锄地区域半径 |
| `massPlant.radius` | `3` | 种植区域半径 |
| `massPlant.maxBlocks` | `64` | 每次操作的最大种植数 |

---

## 📥 Downloads / 下载

| 平台 | 文件 | 依赖 |
|---|---|---|
| **Forge 1.20.1** | `bettervein-1.10.jar` | Minecraft 1.20.1, Forge 47.x |
| **Fabric 26.2** | `bettervein-1.10.jar` | Minecraft 26.2, Fabric API 0.156+, **Cloth Config 26.2.155+**, Fabric Loader 0.19.3+ |

Fabric 版本需要 **[Cloth Config](https://modrinth.com/mod/cloth-config)** — 请从相同的游戏版本中安装。

---

## 📌 Notes / 说明

- 掉落物、经验、时运和精准采集均遵循原版逻辑。
- 连锁挖掘每个方块消耗 1 点耐久（工具会在损坏前自动停止）。
- 基岩、屏障和不可破坏的方块始终会被跳过。
- 支持单人游戏和服务器（反作弊安全：所有逻辑均在服务端运行）。
- **保留所有权利** — 允许个人免费使用；再分发需获得许可。

*希望你觉得它有用！