⛏️ 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
- Install Fabric Loader, Fabric API, and Viper Vein Miner. 📥
- Install the mod on the server when playing multiplayer; install it on the client for highlighting and keybind support. 🌐
- Crouch and break an ore or log using the default configuration. ⛏️
- 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. ⛏️🐍
