Описание
# **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](https://modrinth.com/organization/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:
```text
config/viper_vein_miner_config.json
```
Default configuration:
```json
{
"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.*