⛏️ Azmine

Formerly Arctic’s Vein Miner — a modern, high-performance multi-block mining mod

Forge 1.20.1 · NeoForge 1.21.1 · Client & Server

Azmine is the rebranded successor to Arctic’s Vein Miner, now maintained under Azora Development. Mine veins, tunnels, columns, strips, and structured areas with fast performance, configurable limits, multiplayer support, and clean visual feedback.

---

🚀 Why Azmine?

• ⚡ Fast bulk mining — optimized multi-block breaking without per-block audio spam
• 🧠 Multiple mining patterns — vein, column, strip, tunnel, and square
• 🛠️ Deep configuration — full TOML control for players, servers, and modpacks
• 🎮 Clean controls — hold-to-mine with easy Alt + scroll pattern cycling
• 👁️ Preview highlighting — see selected blocks before mining
• 🌐 Multiplayer-ready logic — designed for client/server use
• 🔁 Legacy config migration — old AVM configs are migrated automatically when possible

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

---

⚠️ Rebrand Notice

Azmine was formerly known as Arctic’s Vein Miner.

Important changes:

• Mod name changed from Arctic’s Vein Miner to Azmine
• Mod ID changed from avm to azmine
• Config file changed from avm-common.toml to azmine-common.toml
• Old avm-common.toml configs are migrated automatically once on first Azmine launch when possible
• Remove the old AVM jar before installing Azmine

---

✨ Mining Patterns

⛏️ Vein

• Mines connected blocks of the exact same block type
• Uses 26-direction neighbor detection
• Configurable scan depth
• Respects maximum blocks per operation

Perfect for ores, logs, and large same-block clusters.

---

🌲 Column

• Mines a vertical stack of the same exact block type
• Searches upward and downward from the target block
• Useful for trees, kelp, bamboo-like columns, and vertical block pillars

---

🧱 Strip

• Mines a 1-wide × 2-tall strip forward
• Uses the block you click as the top of each 2-block column
• Uses tunnel length for forward distance
• Good for branch mining and controlled strip mining

---

🕳️ Small Tunnel

• Mines a straight 1×1 tunnel
• Direction based on where you are looking
• Works vertically and horizontally

---

🏗️ Large Tunnel

• Mines a 3×3 tunnel
• Fixed length of 10 blocks
• Hardness-aware to avoid breaking blocks harder than the starting block

---

🧩 Square

• Mines a square area on the face you hit
• Size configurable from 3×3 up to 15×15
• Odd sizes only
• Hardness-aware to prevent unintended block breaks

---

🎮 Controls

Default controls:

• Activate Azmine: ` / grave accent / backtick
• Cycle Pattern: Hold activation key + Left Alt, then scroll

Usage:

1. Hold Activate
2. Look at a block
3. Left-click to mine
4. Extra blocks break according to the selected pattern
5. Release Activate to return to normal mining

---

🧠 How It Works

• The selected block starts the mining operation.
• Extra blocks are calculated using the selected pattern.
• Drops attempt to go directly into your inventory.
• If your inventory is full, remaining drops fall naturally.
• Tool durability is applied with a configurable multiplier.
• Creative mode ignores durability.
• Sound and particles are clustered to avoid per-block spam.

Azmine intentionally keeps vein mining controlled:

• Veins match exact block IDs by default
• No ore-tag or log-tag grouping by default
• No per-block break sound spam
• No full vanilla destroyBlock() call for every extra block

---

⚙️ Full Configuration

After first launch, edit:

config/azmine-common.toml

General Options

• Enable / disable the mod
• Maximum blocks per operation
• Vein scan depth
• Tunnel length
• Durability multiplier
• Tool requirement toggle
• Harvest level respect toggle
• Break delay ticks

Pattern Settings

• Enable / disable each mining pattern
• Configure square size
• Enable / disable Strip pattern
• Enable / disable Column pattern

Visual Options

• Toggle preview outlines
• Toggle HUD display
• Configure preview outline color
• Toggle cluster break particles
• Toggle cluster break sound

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

---

👁️ Client Features

• On-screen HUD showing current pattern
• Preview block count
• Alt + scroll hint while cycling
• Real-time block preview outlines
• Brighter target block outline
• Softer extra-block outlines
• HUD and preview can be toggled separately

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
• Pattern selection syncs to the server
• Player mining state clears on logout, deactivation, or pattern change

Designed for stable SMP and modpack environments.

---

📦 Installation

1. Download the correct Azmine file for your Minecraft version and loader
2. Place the Azmine JAR into your mods folder
3. Remove the old Arctic’s Vein Miner / AVM jar if installed
4. Launch the game
5. Adjust config/azmine-common.toml as needed

---

📋 Requirements

Forge Build

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

NeoForge Build

• Minecraft: 1.21.1
• NeoForge: 21.1.200+
• Java: 21
• 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
Maintained under: Azora Development
Formerly part of: ArcticZero Development ecosystem