Azmine - Vein Miner

Currently doing an emergency patch, may take a bit. - 8/27/2026 & 5:27 PM

⛏️ Azmine

Fast, responsive multi-block mining for legacy and modern Minecraft

Client Mods: Forge 1.12.2 & 1.20.1 · NeoForge 1.21.1 · Fabric 1.20.1 & 1.21.1

Server Support: Modded servers · Bukkit · Spigot · Paper · Purpur

Mine veins, trees, tunnels, columns, strips, and structured areas using multiple configurable mining patterns.

Azmine provides responsive controls, clear block previews, vanilla-consistent rewards, dynamic tool durability, and server-authoritative multiplayer behavior.

---

🚀 Features

• ⚡ Fast bulk mining - efficiently mine groups of blocks without excessive per-block audio or effects
• 🧠 Multiple mining patterns - vein, column, strip, small tunnel, large tunnel, and square
• 🌳 Tree mining - quickly harvest connected logs while keeping wood variants separate
• 👁️ Block previews - see exactly which blocks will be mined before activating a pattern
• 🎮 Simple controls - hold the mining key and use Alt + scroll to cycle between patterns
• 🔧 Dynamic durability - tool damage scales with the number of blocks successfully mined
• 🎁 Direct reward delivery - mined items are placed into your inventory and experience is awarded directly
• 🛠️ Configurable behavior - adjust mining limits and gameplay settings for players, servers, and modpacks
• 🌐 Universal server protocol - use Azmine on supported modded or Bukkit-based servers
• 🛡️ Protection-aware mining - additional blocks pass through the server’s block-breaking and protection checks
• 🕰️ Legacy and modern support - consistent functionality across Minecraft 1.12.2, 1.20.1, and 1.21.1 clients

---

🎮 Controls

• Hold the configured mining key while breaking a block to activate Azmine
• Use Alt + scroll wheel to cycle through available mining patterns
• The selected pattern is displayed through the in-game HUD and block preview

Controls and available behavior can be adjusted through the mod configuration.

---

⛏️ Mining Patterns

Vein

Mines connected blocks matching the original block.

Ideal for ores, logs, dirt, stone, and other naturally connected groups.

Column

Mines a vertical column extending from the selected block.

Useful for pillars, trees, shafts, and vertical structures.

Strip

Mines a straight horizontal line in the selected direction.

Useful for clearing rows or creating narrow paths.

Small Tunnel

Mines a compact tunnel suitable for normal exploration and branch mining.

Large Tunnel

Mines a larger tunnel for faster excavation and infrastructure projects.

Square

Mines a structured square area based on the targeted surface.

Useful for clearing walls, floors, ceilings, and construction areas.

---

🌐 Universal Multiplayer Support

Azmine uses a loader-neutral protocol that allows supported client mods to communicate with either another Azmine mod or the Azmine Endpoint server plugin.

This means players can use the Forge, Fabric, or NeoForge client mod without requiring the server to use the same mod loader.

Environment	Client installation	Server installation
Single-player	Azmine client mod	Included automatically
Forge, Fabric, or NeoForge server	Matching Azmine mod	Matching Azmine mod
Bukkit, Spigot, Paper, or Purpur server	Supported Azmine client mod	Azmine Endpoint plugin
Player without Azmine	Nothing required	Can join normally, but cannot use Azmine
Geyser/Bedrock player	Nothing required	Can join normally, but cannot use Azmine

Azmine does not require every player to install the client mod when the server uses the endpoint plugin. Players without Azmine can connect and play normally.

---

🛡️ Server-Authoritative Mining

Mining is validated and executed by the server.

Every additional block is processed through the server’s player block-breaking system, preserving:

• Tool requirements
• Enchantment behavior
• Item drops
• Experience rewards
• Tool durability
• Creative-mode behavior
• Server protection checks

On Bukkit-based servers, protection and claim plugins that enforce their rules through BlockBreakEvent receive a separate authorization opportunity for every additional block. If a block break is denied, Azmine leaves that block untouched.

---

🎁 Drops and Experience

Azmine preserves its direct reward-delivery behavior while using the native server break process.

• Items produced by vein-mined blocks are moved into the player’s inventory
• Experience is added directly to the player
• Inventory overflow remains in the world
• Creative-mode breaks do not collect survival rewards
• Existing nearby items and experience are not collected
• Using the wrong tool produces no drops when vanilla would produce no drops

This preserves Azmine’s familiar gameplay while allowing the server to calculate rewards normally.

---

🔀 ViaVersion Support

Azmine can work across translated Minecraft connections when the server uses ViaVersion and ViaBackwards.

For example, a supported Azmine 1.21.1 client can connect to a newer Paper server and communicate with the Azmine Endpoint plugin after ViaVersion establishes the base Minecraft connection.

ViaVersion does not add Azmine support to Minecraft versions without a compatible client build. The player must still use one of the supported Azmine client versions listed below.

---

⚙️ Configuration

Azmine includes configurable limits and gameplay options for players, server owners, and modpack developers.

Server-authoritative settings are synchronized to connected Azmine clients. Configuration options may vary slightly between legacy Forge, modern Forge, Fabric, NeoForge, and Bukkit-based servers.

---

🔄 Migrating from Arctic’s Vein Miner

Azmine was formerly known as Arctic’s Vein Miner.

• The mod name changed to Azmine
• The mod ID changed from avm to azmine
• The modern config file changed from avm-common.toml to azmine-common.toml
• Existing configurations are migrated automatically where supported

The rebrand does not change the core purpose of the mod. Azmine continues the same project with expanded features, improved performance, and broader server compatibility.

---

🛠️ Supported Client Versions

Minecraft	Loader	Support
1.12.2	Forge	Supported
1.20.1	Forge	Supported
1.20.1	Fabric	Supported
1.21.1	Fabric	Supported
1.21.1	NeoForge	Supported

Each release includes its Minecraft version and loader in the filename to make builds easier to identify.

---

🔌 Supported Server Plugins

Legacy Endpoint

Minecraft	Platforms	Java
1.12.2	Bukkit, Spigot, Paper	Java 8

The legacy endpoint is specifically designed for CraftBukkit-compatible Minecraft 1.12.2 servers.

Modern Endpoint

Minecraft	Platforms	Java
1.20.1–1.21.11	Bukkit, Spigot, Paper, Purpur	Java 17+

Install exactly one Azmine Endpoint JAR in the server’s plugins directory.

Folia, Sponge, BungeeCord, Velocity, and Waterfall are not currently supported.

---

🔐 License & Permissions

All Rights Reserved (ARR)

You are allowed to:

• ✔ Use this mod on servers
• ✔ Include this mod in modpacks
• ✔ Distribute the mod unchanged as part of a modpack

You may not:

• ❌ Reupload the mod on other websites
• ❌ Redistribute modified versions
• ❌ Claim the mod, code, or assets as your own

For redistribution requests outside of modpacks, contact the author.

---

Developed and maintained by Azora Development.