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

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

---

📋 Requirements

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

---

🔐 License & Permissions

All Rights Reserved (ARR)

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