Vein Pocket ⛏️📦

Vein Pocket is a modern and lightweight utility mod developed for NeoForge (Minecraft 1.21.1) using Kotlin. It allows players to safely and efficiently mine entire ore veins in a single action, delivering all extracted resources directly to the player's inventory to prevent them from falling into lava, voids, or despawning.

🌟 Key Features

• Vein Mining: Breaking an ore triggers a 3D recursive search (including diagonals) up to a configurable block limit, automatically breaking all connected ores of the same type.
• Smart Auto-Pickup: Instead of dropping items at the mined block's location, all resources are inserted straight into the player's inventory.
• Overflow Protection: If your inventory becomes full while vein mining, any remaining items drop safely at the player's feet.
• Full Enchantment Support: Respects vanilla enchantment logic seamlessly—works with Fortune to increase item yield and Silk Touch to drop raw blocks.
• Smart Durability Management:
• Tool Protection: Vein mining stops automatically if your pickaxe reaches 1 remaining durability point to prevent accidental breakage.
• Accurately calculates probabilities for the Unbreaking enchantment.
• Crouch Activation (Sneak): By default, the vein mining ability triggers only while holding the sneak key (Shift).
• Creative Mode Protection: Intentionally disabled in Creative Mode to prevent accidental destruction of structures or terrain.
• Performance Optimized: Employs efficient Breadth-First Search (BFS) algorithms without causing server lag, while processing block removal cleanly.

⚙️ Configuration (veinpocket-settings.toml)

The mod generates a .toml configuration file in your Minecraft config directory upon first launch:

.minecraft/config/veinpocket-settings.toml

Automatic Recovery: If the file is missing, corrupt, or contains syntax errors, Vein Pocket will rewrite it using safe default values.

File Structure (veinpocket-settings.toml)

# This is the limit of ores that can be mined with this mod.
blockLimit = 128

# Multi-mining only allowed while crouching
alwaysCrouching = true

# Allow all mined blocks to emit particles. Disabled by default to improve performance.
showParticles = false

Configuration Details

🛠️ Requirements & Installation

1. Install NeoForge for Minecraft 1.21.1.
2. Download the latest release of Vein Pocket.
3. Place the downloaded .jar file into your mods folder: .minecraft/mods/
4. Launch the game and enjoy!

📜 Credits

• Developer: Moddy
• Framework: NeoForge / Kotlin