bettervein

# Better Vein v1.2.0 Update Notes

> **Version ID**: `fabric-26.2-1.2.0`  
> **Compatible Game**: Minecraft 26.2 (Fabric)  
> **Release Date**: 2026-08-12

---

## ✨ 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)

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.

---

## 🔧 Tunnel / Stair Mode Improvements

- **Dig Through Mixed Areas**: Tunnel, Square, and Stair modes no longer only dig the same block type—they now break **all breakable blocks** within the shape (stone, dirt, ores all together; tunnels are cleared more thoroughly)
- **Full Cross-Section**: Large tunnels now start with the full 3x3 cross-section from the very first block, displaying all 9 blocks at the entrance
- **New Depth Control**: Added config option "Tunnel/Stair Max Depth" (default 32 layers), replacing the previous 64‑block hard cap
- **1‑Block Wide Stairs**: Mining Tunnel and Escape Tunnel are now 1 block wide (still 2 blocks high for easy walking)

---

## 🛠️ Fixes

- Fixed the tunnel mode white outline not displaying correctly (preview border now fully covers the actual mining area)
- Fixed incomplete chaining in tunnel modes (no longer truncated by the 64‑block limit)
- Fixed inconsistency between config screen mode changes and server-side behavior (now saves and syncs immediately)

---

## 🌐 Localization

- Fully updated Chinese and English language files:
  - Names for all 6 modes (CN/EN)
  - Added "Tunnel/Stair Max Depth" config entry
  - Updated key hints (M / Shift+Scroll)

---

## 📦 Files

- **Main file**: `bettervein-fabric-26.2-1.2.0.jar`
- **Source code**: `bettervein-fabric-26.2-1.2.0-sources.jar`

### Installation

Place `bettervein-fabric-26.2-1.2.0.jar` into the `mods` folder of your game directory.

---

## 📜 Version History

| Version | Description |
|---------|-------------|
| 1.0.x | Basic vein mining + one‑click hoeing/planting + item magnet |
| 1.2.0 | **Added 6 mining modes**, tunnel/stair improvements, Shift+Scroll switching, version format update |

---

*Better Vein — Chain-mine every block, one‑click hoe & plant, and automatically gather drops to your feet.*