bettervein
- By
Similar to FTB Ultimine, it supports one-click chain mining, one-click tilling, and one-click planting. After chain mining, all dropped items will be gathered at your feet for greater convenience.
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 | Icon/Name | Description |
|---|---|---|
| 🌀 Shapeless | Shapeless | No fixed shape; chains by block type (original range/connected logic) |
| ➡️ Small Tunnel | Small Tunnel (1x1) | Digs a 1-block wide straight tunnel in the player's facing direction |
| 🏗️ Large Tunnel | Large Tunnel (3x3) | Digs a large tunnel with a 3x3 cross-section in the player's facing direction |
| 🟦 Small Square | Small Square (3x3) | Digs a single-layer 3x3 plane perpendicular to the line of sight (wall = vertical, floor = horizontal) |
| ⬇️ Mining Tunnel | Mining Tunnel | 1-block wide stair-step downward digging |
| ⬆️ Escape Tunnel | Escape Tunnel | 1-block wide stair-step upward digging |
🎮 Mode Switching (Three Methods)
-
Shift + Scroll Wheel: Scroll up = previous mode, scroll down = next mode (recommended)
-
M Key: Cycle through modes (fallback for no scroll wheel)
-
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/falseCommand
/bettervein shiftcycle on | off | toggleQuery
/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!
