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.