Modrinth · Fabric

Viper Vein Miner on your Minecraft server

Viper Vein Miner runs on Minecraft servers with Fabric. Order your server, set the loader in the panel and install the mod with one click in the mod browser.

Viper Vein Miner is a lightweight, Server-Side vein-mining mod. Break one ore or log and mine its connected vein in a single action

Downloads
9.3K
Author
–
Loader
Fabric
Minecraft
1.21 – 26.3
Updated
–

Screenshots

What Viper Vein Miner looks like

Images: Viper Vein Miner on Modrinth, published by the project team.

Setup

Install Viper Vein Miner on your server

The server and players need the same loader and Minecraft version. Back up the world before adding or updating mods.

  1. 01

    Configure

    4 GB of RAM is preselected. You choose the term and add-ons and pay by credit card or PayPal.

  2. 02

    Set the loader

    In the panel, set the server software to Fabric and choose the matching Minecraft version, for example 26.3.

  3. 03

    Install the mod

    Search the mod browser for “Viper Vein Miner” and install the release for your loader. Alternatively, upload the .jar to the mods folder via SFTP. Required dependencies are listed on the project page.

  4. 04

    Connect

    Viper Vein Miner is not needed on the client. Players connect using the server address from the panel.

On the server
Required
On the client
Not needed
Loader
Fabric
Minecraft
26.3, 26.2, 26.1.2 +14 more
License
MIT License

The panel

Install mods, find errors.

Real screenshots from the Mado panel. Both come with every Minecraft server.

Mod browser

Modrinth and CurseForge, right in the panel.

The browser filters by your Minecraft version. Install mods with one click, without uploading .jar files.

Browser in the Mado panel with search, a CurseForge or Modrinth source switch and install buttons.

AI crash analysis

When a mod crashes, the analyzer reads the log.

Mods often fail on a wrong loader version, Java version or missing dependency. The analyzer names a likely cause and suggests a fix.

Optimization page in the Mado panel with the AI Log Analyzer enabled and a “Server Crashed” notice with an “Analyze Now” button.

Releases

Published releases

Pick the file that matches your server’s loader and Minecraft version. The server and players need the same release.

Viper Vein Miner · Modrinth
Original description by the project author

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.

FAQ

Viper Vein Miner questions

Question not listed? Ask our team.

Viper Vein Miner server crashes on startup – what to do?

Common causes: the loader or Minecraft version does not match the mod file, a dependency is missing, or RAM is too low. Check the log (latest.log) for “OutOfMemoryError”, “Mixin” or missing mods. At Mado, the AI crash analysis reads the log and suggests a cause. You can change the loader and version in the panel.

Which loader does Viper Vein Miner run on?

According to Modrinth, Viper Vein Miner supports Fabric for Minecraft 26.3, 26.2, 26.1.2.

How much RAM does a server with Viper Vein Miner need?

As guidance, 3–4 GB for a server with this mod. This is an estimate, not a measured minimum. More mods, many players and long view distances need more. The spark profiler shows whether a mod is costing tick time.

Ready for your server with Viper Vein Miner?

4 GB of RAM from €8.00 per month. 35% off your first month with MADO35.

Order server