Better Vein（更好的连锁）

A powerful vein-mining & farming mod that makes mining and farming a breeze. Break one block and **chain-mine every ore in the area** — even scattered ones. Fell an entire tree in a single swing. Mass-till and mass-plant farmland in one right-click. All drops gather at your feet.

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

---

## ✨ Features / 功能

| 功能 | 说明 |
|---|---|
| ⛏️ **Chain Mining 连锁挖矿** | Break one block, chain-break all same-type blocks in the area (default radius 8, **even scattered ores**) |
| 🌳 **One-Swing Tree Felling 一键砍树** | Break a log, the whole tree falls — **never touches neighboring trees** |
| 🚜 **Mass Tilling 一键锄地** | Hold key + right-click with a hoe: till a (2R+1)² farmland area at once |
| 🌱 **Mass Planting 一键种植** | Hold key + right-click with seeds/saplings: plant a whole area at once |
| 🎒 **Drop Gathering 掉落物聚集** | All chain-mined drops fly to your feet |
| 👁️ **Live Preview 实时预览** | While holding the key, see the exact chain count & white outline before breaking |
| ⚙️ **Fully Configurable 高度可配置** | Radius, max blocks, modes & more — all adjustable |

---

## 🎮 How to Use / 操作方式

**Default hotkey: Grave / Tilde key (`` ` ``, left of `1`, below ESC)** — rebindable in Controls.
**默认按键：飘号键（`` ` ``，ESC 下方）** — 可在按键设置中修改。

| Action | Input |
|---|---|
| Chain-mine / Fell tree | Hold hotkey + **Left-click** |
| Mass-till | Hold hotkey + **Right-click** with hoe |
| Mass-plant | Hold hotkey + **Right-click** with seeds/saplings |

> While holding the hotkey, aim at a block to preview the chain range (count + white outline) before breaking.
> 按住按键瞄准方块即可预览连锁范围（数量 + 白色描边）。

1.2.0update：

✨ New Feature: 6 Mining Modes

This update introduces 6 mining modes to suit different digging needs:

🎮 Mode Switching (Three Methods)

1. Shift + Scroll Wheel: Scroll up = previous mode, scroll down = next mode (recommended)

2. M Key: Cycle through modes (fallback for no scroll wheel)

3. Configuration Screen: ModMenu → Config → Mining Mode (dropdown selection)

The current mode is displayed in the top-left HUD for about 3 seconds when switching.
The selected mode is automatically saved and synced when entering a world/server, and persists across reconnects.

1.2.1update

The shift cycle mode can be turned off/disabled via configuration.

Configuration
config/bettervein-common.toml → veinMining.enableShiftCycle = true/false

Command
/bettervein shiftcycle on | off | toggle

Query
/bettervein shiftcycle (displays the current status)

---

## ⚙️ Configuration / 配置

- **Forge**: `config/bettervein-common.toml`
- **Fabric**: `config/bettervein.json` (editable in-game via Cloth Config + Mod Menu)

| Option | Default | Description |
|---|---|---|
| `veinMining.areaMode` | `true` | Area chain: chain ALL same-type blocks in radius (even scattered) |
| `veinMining.areaRadius` | `8` | Area chain radius (1–32) |
| `veinMining.maxBlocks` | `64` | Max blocks per chain |
| `veinMining.treeMode` | `true` | Tree mode: logs only, leaves decay naturally |
| `veinMining.gatherDrops` | `true` | Gather drops at feet |
| `veinMining.requireKey` | `true` | Only chain while holding the hotkey |
| `massTill.radius` | `3` | Tilling area radius |
| `massPlant.radius` | `3` | Planting area radius |
| `massPlant.maxBlocks` | `64` | Max plants per action |

---

## 📥 Downloads / 下载

| Platform | File | Requires |
|---|---|---|
| **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 version requires **[Cloth Config](https://modrinth.com/mod/cloth-config)** — install it from the same game version.

---

## 📌 Notes / 说明

- Drops, XP, Fortune & Silk Touch all follow vanilla logic.
- Chain-mining consumes 1 durability per block (tool auto-stops before breaking).
- Bedrock, barriers & unbreakable blocks are always skipped.
- Works on singleplayer & servers (anti-cheat safe: all logic runs server-side).
- **All Rights Reserved** — free to use personally; redistribution requires permission.

*Hope you find it useful!