⛏️ 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

🛠️ 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

🎮 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
}

Restart the game or server after editing the configuration file.

📦 Installation

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