Vein Miner

Viper Vein Miner

Viper Vein Miner is a lightweight, Client-Side + Server-Side vein-mining mod for Minecraft 1.21.x, 26.1.x, and 26.2.x. By default, it mines ores and trees only while leaving every other block untouched. Ore veins include diagonally connected blocks whose faces do not touch.

Supported Versions

| Version | Java | Status | |---------|------|--------| | 1.21.x | 21 | Full support | | 26.1.x | 25 | Full support | | 26.2.x | 25 | Full support |

---

Purpose & Function

The goal of Viper Vein Miner is to make mining ores and chopping trees faster without unexpectedly breaking ordinary blocks. Ores connect through all 26 neighboring positions, while logs use direct face-to-face connections.

• Safe Default Selection: Ores and logs are enabled out of the box; all other blocks are disabled.
• Diagonal Ore Detection: Ore blocks can connect through faces, edges, or corners. They do not need to share a face.
• Tree Mining: Chop directly connected logs without breaking every block individually.
• Optional All-Blocks Mode: Enable any matching block type as a vein when you want broader behavior.
• Vanilla-Style Tool Use: The held tool takes durability damage for each mined block.
• Durability Protection: Mining stops before the held tool would break.
• Configurable Vein Limit: Control how many blocks can be mined at once; the default is 64.
• Live Preview: Connected blocks are highlighted before mining so you can see what will be affected.
• Server-Authoritative Mining: Block breaking is handled on the server for synchronized multiplayer behavior.

---

Key Features

| Feature | Description | |---------|-------------| | Ores & Trees Only | Ores and logs are enabled by default; ordinary blocks are not | | 26-Position Ore Search | Finds face-, edge-, and corner-connected ores, including diagonals | | Tree Miner | Mines face-connected logs of the same block type | | 3 Activation Modes | Choose CROUCH, KEYBIND, or ALWAYS | | Custom Keybind | Hold V by default when using KEYBIND mode | | Vein Preview | Displays a translucent yellow highlight over affected blocks | | Tool Protection | Stops mining before the tool reaches its breaking point | | Vein Size Limit | Configurable maximum with a default of 64 blocks | | All-Blocks Mode | Optionally allow connected blocks of any type to act as veins | | Multiplayer Support | Server-side mining with client-side preview and keybind support | | Lightweight | Requires only Fabric Loader and Fabric API |

> Enhance your server setup! Check out my other server-side mods over at : Fabric Server Essentials

---

How to Use

1. Install Fabric Loader, Fabric API, and Viper Vein Miner.
2. Install the mod on the server when playing multiplayer; install it on the client for highlighting and keybind support.
3. Crouch and break an ore or log using the default configuration.
4. Watch the connected vein break until the configured limit is reached or the tool is nearly broken.

The default activation mode is CROUCH. To use the keybind instead, set activationMode to KEYBIND, then hold V while mining.

---

Configuration

The configuration file is generated automatically at:

config/viper_vein_miner_config.json

Default configuration:

{
  "enableTreeMiner": true,
  "enableOreMiner": true,
  "allBlocksAreVeins": false,
  "maxVeinSize": 64,
  "activationMode": "CROUCH",
  "renderHighlight": true,
  "highlightAlpha": 0.4
}

| Option | Description | Default | |--------|-------------|---------| | enableTreeMiner | Enables face-connected log mining | true | | enableOreMiner | Enables face-, edge-, and corner-connected ore mining | true | | allBlocksAreVeins | Allows any connected matching blocks to be vein-mined | false | | maxVeinSize | Maximum blocks mined in one operation | 64 | | activationMode | Activation method: CROUCH, KEYBIND, or ALWAYS | CROUCH | | renderHighlight | Shows the affected-block preview | true | | highlightAlpha | Preview opacity from 0.0 to 1.0 | 0.4 |

Restart the game or server after editing the configuration file.

Existing configuration files keep their saved values. For the intended ores-and-trees-only behavior, use enableTreeMiner: true, enableOreMiner: true, and allBlocksAreVeins: false.

---

Installation

| Requirement | Needed | |-------------|--------| | Fabric Loader | Yes | | Fabric API | Yes | | Client Installation | Required for singleplayer, preview, and keybind mode | | Server Installation | Required for multiplayer vein mining | | Mod Menu | Not required |

Use the JAR matching your Minecraft version and place it in the mods folder.

---

> Built for miners who want less repetitive block breaking without losing control. See the vein, protect your tool, and mine it in one strike.