VeinMine

Version 1.0.0 – Initial Release

Features

Vein Mining Core

Players can vein-mine contiguous ores with a single block break. Supports configurable ore types via config.yml. Configurable search radius (searchRadius) to define how far vein mining spreads. Configurable maximum number of blocks mined per vein (maxBlocks). Option to drop all mined blocks at once (dropAtOnce) or naturally as they are mined. XP drops are calculated per ore type based on vanilla Minecraft mechanics. Prevents multiple players from mining the same vein simultaneously using a thread-safe block reservation system.

Tool Requirements

Requires the player to hold a pickaxe (wood, stone, iron, golden, diamond, netherite). Configurable toggle to enforce minimum pickaxe tier (requirePickaxeLevel). Automatic tool durability management with support for the Unbreaking enchantment. Stops vein mining if the tool breaks mid-process.

Cooldown System

Configurable cooldown (cooldown) between vein-mining attempts. Optional cooldown messages (cooldownMessage) to notify players of remaining wait time.

Commands

/veinminer reload – Reloads the plugin configuration. /veinminer enable – Enables vein mining globally. /veinminer disable – Disables vein mining globally. /veinminer stats – Displays runtime statistics including: Enabled/disabled state, Search radius and max blocks, Drop-at-once setting, Cooldown, Total veins and blocks mined, Average blocks per vein.

Permissions

veinminer.use – Allows a player to use vein mining. veinminer.reload – Allows reloading the config. veinminer.toggle – Allows enabling/disabling the plugin. veinminer.stats – Allows viewing plugin stats.

Internal Improvements

Synchronized processingBlocks set to safely handle concurrent mining events. Optimized block search to avoid loading unloaded chunks. Detailed error handling for invalid materials in the configuration. Accurate XP calculation per ore type. Respect vanilla Minecraft harvest tiers for ores.

Metrics

Tracks runtime statistics

Total veins mined. Total blocks mined. Average blocks mined per vein.