⛏️ Arctic’s Vein Miner

A modern, high-performance multi-block mining mod

Minecraft 1.20.1 · Forge 47.x · Java 17+

Arctic’s Vein Miner adds powerful, configurable multi-block mining to modern Forge environments.
Mine veins, tunnels, or structured areas instantly — with full control, multiplayer safety, and clean performance.

🚀 Why Arctic’s Vein Miner?

⚡ Optimized block selection — efficient connected-block scanning
🧠 Multiple mining patterns — vein, tunnel, and square
🛠️ Deep configuration — full TOML control
🧩 Modded block support — works automatically with most modded ores
🌐 Server-authoritative logic — safe for multiplayer
❄️ Clean architecture — no unnecessary GUI clutter

Built as a modern, lightweight alternative to legacy vein mining implementations.

✨ Mining Patterns

⛏️ Vein (Shapeless)

Mines connected same-type blocks in a 3D blob
Uses full 26-direction neighbor detection
Configurable depth limit
Respects maximum blocks per operation

Perfect for ores, logs, and large material clusters.

🧱 Small Tunnel (1×1)

Straight tunnel in the direction you are looking
Configurable length
Works vertically and horizontally

🏗️ Large Tunnel (3×3)

3 blocks wide × 3 blocks tall
Direction based on look vector
Configurable length
Hardness-aware: only breaks blocks equal to or softer than the starting block

🧩 Square (Configurable)

Breaks a square on the face you hit
Size configurable from 3×3 up to 15×15
Hardness-aware to prevent unintended block breaks

🎮 Controls (Default)

Activate Vein Miner: ` (grave key)
Cycle Pattern: Hold activation key + Shift, then scroll mouse wheel

Usage:

Hold Activate → left-click block → first block breaks normally
Extra blocks break according to the selected pattern
Release Activate → return to normal mining

🧠 How It Works

The first block always breaks normally (no vanilla override).
Additional blocks are computed server-side and broken instantly.
Drops go directly into your inventory (or drop if full).
Tool durability is applied once per operation using a configurable multiplier.
Creative mode ignores durability.

Tunnel and Square patterns respect block hardness rules.
Vein pattern only mines the same block type.

⚙️ Full Configuration

After first launch, edit:

config/arcticveinminer-common.toml

General Options

Enable / disable mod
Maximum blocks per operation
Vein depth limit
Tunnel length
Durability multiplier
Tool requirement toggle
Harvest level respect toggle

Pattern Settings

Enable / disable each pattern
Square size (3–15, odd values only)

Visual Options

Preview toggle
Preview outline color (ARGB)
Preview line width

Built for server owners and modpack creators who want precise control.

👁️ Client Features

On-screen HUD showing current pattern
Scroll hint while cycling
Optional real-time block preview outline
Preview color and thickness configurable

Preview is client-side and visible only to you.

🌐 Multiplayer Support

Works on dedicated servers
Mod required on both client and server
Server handles mining logic
Proper state synchronization when activating or cycling patterns

Designed for stable SMP environments.

📦 Installation

Install Forge 47.x for Minecraft 1.20.1
Place the mod JAR into your mods folder
Launch the game
Adjust configuration as needed

📋 Requirements

Minecraft: 1.20.1
Forge: 47.x
Java: 17+
Side: Client & Server

🔐 License & Permissions

You are allowed to:

✔ Use this mod on servers
✔ Include this mod in modpacks
✔ Distribute the mod unchanged via modpacks

You may NOT:

❌ Reupload the mod on other sites
❌ Redistribute modified versions
❌ Claim this mod or its assets as your own

For redistribution questions outside of modpacks, contact the author.

🧠 Credits

Developed by ImpactGamin
Part of the ArcticZero ecosystem

Arctic's Vein Miner