⛏️ Viper Vein Miner 🐍

Viper Vein Miner is a lightweight, Server-Side vein-mining mod for Minecraft 1.21.x, 26.1.x, and 26.2.x. Break one ore or log and mine its connected vein in a single action, with configurable activation modes, tool-durability protection, and a live block preview. ⚡✨

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 repetitive mining faster without turning it into a completely automatic process. Mine one block and the mod finds connected blocks of the same type in all six directions. 🪨

• Ore Vein Mining: Mine connected ores of the same type in one action. 💎
• Tree Mining: Chop connected logs without breaking every block individually. 🌲
• 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
💎 Ore Miner	Mines connected ores of the same block type
🌲 Tree Miner	Mines connected logs of the same block type
🧭 Six-Direction Search	Detects blocks above, below, north, south, east, and west
🎮 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

---

🎮 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 connected-log mining	true
enableOreMiner	Enables 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.

---

📦 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. ⛏️🐍