Перейти к содержимому
Mineforgian

VeinMiner999

VeinMiner999 automatically mines complete ore veins in one click, featuring configurable scan ranges, smart same-type detection, and adjustable XP/durability mechanics to deliver balanced mining enhancement for minecraft servers.

Загрузки
2K
Подписчики
3
Обновлён
28 марта 2026 г.
Лицензия
All-Rights-Reserved

Опубликован 1 августа 2025 г.

⛏️ Features

Vein Mining

Break one ore block and all connected ores of the same type will be mined automatically. Supports all vanilla ores including deepslate variants and nether ores.

Tree Capitator

Chop one log with an axe and the entire tree falls instantly. All connected logs of the same wood type are broken together.

Auto-Smelt

When enabled, iron, gold, and copper ores are automatically smelted into ingots. Consumes fuel items (coal, charcoal, etc.) from your inventory.

Ore Highlighting

Right-click an ore with a pickaxe to see particle effects on all connected ore blocks in the vein. Great for planning your mining!

Silk Touch Support

When using a Silk Touch pickaxe, ore blocks drop as themselves instead of raw materials.

Cooldown System

Configurable cooldown between vein mining actions to balance gameplay.

Tool Durability

Tool durability is consumed for each block mined. Respects Unbreaking enchantment for reduced durability loss.

Configurable Commands

All commands can be individually enabled/disabled with customizable permission groups.


🎮 Commands

Command Description Default Permission
/veinminer Shows plugin usage information Everyone
/veinminer help Displays all available commands Everyone
/veinminer toggle Toggles vein mining on/off for yourself Everyone
/veinminer status Shows your current vein mining settings Everyone
/veinminer reload Reloads the plugin configuration Operators

🔐 Permissions

Permission Description Default
veinminer.use Allows basic VeinMiner usage true
veinminer.command.reload Allows reloading configuration op
veinminer.command.toggle Allows toggling vein mining true
veinminer.command.help Allows viewing help true
veinminer.command.status Allows viewing status true

⚙️ Configuration

General Settings

Setting Description Default
max_horizontal_range How far horizontally to search for ores 5
max_vertical_range How far vertically to search for ores 5
require_same_type Only mine ores matching the first broken true
give_exp Award XP when vein mining true
take_durability Consume tool durability per block true
max_blocks Maximum blocks mined per action 64
max_vein_size Absolute maximum vein size (lag prevention) 128
cooldown_seconds Cooldown between vein mining actions 2
sneak_to_veinmine Require sneaking to activate false

Display Settings

Setting Description Default
show_vein_message Show action bar message after mining true
vein_message The message format (%blocks% = count) "&aVein mined &e%blocks% &aadditional blocks!"
enable_highlighting Allow right-click ore highlighting true

Tool Settings

Setting Description Default
tool_list_mode "whitelist" or "blacklist" mode blacklist
tool_list Tools for whitelist/blacklist [WOODEN_PICKAXE]
enable_silk_touch_mode Drop ore blocks with Silk Touch false

Tree Capitator Settings

Setting Description Default
enable_tree_capitator Enable tree chopping feature true
tree_capitator_max_blocks Maximum logs chopped at once 64
tree_capitator_sneak_required Require sneaking to chop trees false

Auto-Smelt Settings

Setting Description Default
enable_auto_smelt Enable automatic ore smelting false
auto_smelt_fuels Items that count as fuel [COAL, CHARCOAL, COAL_BLOCK, LAVA_BUCKET, BLAZE_ROD]

Command Settings

Each command can be configured individually:

commands:
  reload:
    enabled: true
    permission: "op"
  toggle:
    enabled: true
    permission: "default"
  help:
    enabled: true
    permission: "default"
  status:
    enabled: true
    permission: "default"

Permission Values:

  • "default" - All players can use the command
  • "op" - Only operators can use the command
  • "custom.permission.node" - Players with this permission can use it

📋 Supported Blocks

Ores (Vein Mining)

  • Coal Ore / Deepslate Coal Ore
  • Iron Ore / Deepslate Iron Ore
  • Copper Ore / Deepslate Copper Ore
  • Gold Ore / Deepslate Gold Ore
  • Diamond Ore / Deepslate Diamond Ore
  • Emerald Ore / Deepslate Emerald Ore
  • Lapis Ore / Deepslate Lapis Ore
  • Redstone Ore / Deepslate Redstone Ore
  • Nether Gold Ore
  • Nether Quartz Ore

Logs (Tree Capitator)

  • Oak Log
  • Spruce Log
  • Birch Log
  • Jungle Log
  • Acacia Log
  • Dark Oak Log
  • Mangrove Log
  • Cherry Log
  • Crimson Stem
  • Warped Stem

Auto-Smelt Conversions

  • Raw Iron → Iron Ingot
  • Raw Gold → Gold Ingot
  • Raw Copper → Copper Ingot
  • Ancient Debris → Netherite Scrap

Ченджлог

1.0.6Релиз1.21.9, 1.21.10, 1.21.11 · 28 марта 2026 г.

Added

  • Added queued vein processing that mines connected blocks in small batches each tick to reduce lag spikes.
  • Added per-world control using enabled_worlds and disabled_worlds.
  • Added /veinminer mode <ore|tree|both|off> so players can switch between ore-only, tree-only, both, or fully off.
  • Added a configurable queue_batch_size setting for tuning processing smoothness and speed.
  • Added separate command settings for the new mode subcommand.

Changed

  • Split mining cooldown behavior into separate settings: ore_cooldown_seconds and tree_cooldown_seconds.
  • Updated cooldown handling so ore actions and tree actions now use independent cooldown timers.
  • Updated /veinminer toggle behavior to switch between off and both mode.
  • Updated /veinminer status and /veinminer help to include the new mode and cooldown details.
1.0.5Релиз1.21.9, 1.21.10, 1.21.11 · 15 января 2026 г.

Added

Tree Capitator Feature

  • New tree chopping system that breaks all connected logs when using an axe
  • Supports all vanilla log types including Nether stems
  • Configurable maximum blocks per chop (tree_capitator_max_blocks)
  • Optional sneak requirement (tree_capitator_sneak_required)
  • Separate enable/disable toggle (enable_tree_capitator)

Auto-Smelt System

  • Automatically smelt iron, gold, and copper ores into ingots
  • Consumes fuel from player inventory (coal, charcoal, coal blocks, lava buckets, blaze rods)
  • Configurable fuel types in auto_smelt_fuels list
  • Bonus smelting XP awarded to players
  • Does not activate when using Silk Touch pickaxe

Configurable Commands

  • All commands can now be individually enabled or disabled
  • Customizable permission groups per command:
    • "default" - All players
    • "op" - Operators only
    • Custom permission nodes supported

New Commands

  • /veinminer help - Shows all available commands with descriptions
  • /veinminer status - Displays current vein mining settings for the player

1.0.4Релиз1.21.8, 1.21.9, 1.21.10 · 24 ноября 2025 г.

New Features

  • Silk Touch Mode: A new option enable_silk_touch_mode has been added to the configuration (config.yml). When set to true, vein mining with a Silk Touch enchanted tool will convert ore blocks to their silk-touched versions (e.g., diamond ore remains as diamond ore block).
  • Cooldown Settings: Added cooldown_seconds option to the configuration to set a cooldown period between vein mining actions to prevent spam.
  • Maximum Vein Size Limits: Added max_vein_size option to the configuration to prevent extremely large veins that could cause server lag.

Improvements

  • Diagonal Ore Detection: Improved ore detection algorithm to check all 26 adjacent blocks (including diagonals) instead of just 6 directions, making vein detection more accurate.
  • Better XP Drops: Corrected experience drop values to match Minecraft's standard values for each ore type.
  • Tool Break Handling: Fixed tool breakage handling to prevent issues when updating durability after a tool has already broken.
1.0.3Релиз1.21.8, 1.21.9, 1.21.10 · 23 октября 2025 г.

New Features

  • Toggle Vein Mining: Players can now enable or disable vein mining for themselves using the /veinminer toggle command. This requires the veinminer.use permission.
  • Sneak to Veinmine: A new option sneak_to_veinmine has been added to the configuration (config.yml). When set to true, players must be sneaking (holding shift) to trigger a vein mine.
  • Tool Whitelist/Blacklist: Server owners can now control which pickaxes are allowed for vein mining.
    • A new tool_list_mode option in config.yml can be set to either "whitelist" or "blacklist".
    • The tool_list in the config allows you to specify the materials for the list (e.g., "DIAMOND_PICKAXE").

Changes

  • The /veinminer command now shows usage for reload and toggle.
  • Added a new permission veinminer.use (defaults to true) which is required to use the /veinminer toggle command and the vein mining feature itself.
1.0.2Релиз1.21.6, 1.21.7, 1.21.8 · 28 сентября 2025 г.
  1. Configuration Changes

Added new configurable options:

show_vein_message (boolean) → toggles whether the player sees an action bar message when mining veins.

vein_message (string) → allows customizing the vein mining message with placeholder %blocks%.

enable_highlighting (boolean) → allows enabling/disabling vein highlighting via right-click.

Updated default ores list for Minecraft 1.21, including proper ordering and new variants.

Default messages now use color codes with & (configurable).

  1. Vein Mining Behavior

BlockBreakEvent is now fully cancelled for ores to manually handle drops and XP:

event.setCancelled(true);

event.setDropItems(false);

event.setExpToDrop(0);

Original block is now processed the same as vein blocks, instead of skipping it.

XP calculation now uses a new method getOreExpDrop(Material type) for more controlled and configurable XP drops per ore type.

Durability handling improved:

Correctly handles Unbreaking enchantment with proper chance calculation.

Tools now break naturally if durability is exceeded during vein mining, with a message to the player.

Tool meta is updated after all blocks are mined instead of updating per block.

Block drop handling is more robust:

Drops are manually spawned in the world for all mined blocks.

Ensures only valid ores are dropped.

Action bar message now uses configurable veinMessage and only displays if showVeinMessage is true.

Supports %blocks% placeholder.

Only shows if more than 1 block is mined.

  1. New Feature – Vein Highlighting Added right-click highlighting for ore veins:

Triggered on PlayerInteractEvent when right-clicking an ore block with a pickaxe.

Shows CRIT particle effects on all vein blocks.

Shows a chat message indicating the number of blocks in the vein.

Respects enableHighlighting and maxBlocks limits.

Supports requireSameType config.

  1. Code Optimizations / Refactors

isPickaxe(Material) helper method added for tool checks.

findAdjacentOres:

Uses a separate visited set for O(1) lookup (performance improvement).

Vein scanning logic remains the same but now avoids redundant additions.

BlockBreakEvent processing streamlined with local variables:

isDamageable, damageable, currentDamage, maxDurability, isUnbreakable.

XP and drops calculation separated from event logic.

getOreExpDrop(Material type) provides consistent XP drops per ore type.

Removed redundant checks and simplified durability/unbreaking handling.

Tool meta casting safely with Damageable instead of direct ItemMeta.

  1. Minor Improvements

Messages now use ChatColor for consistent coloring.

/veinminer command usage message updated with version info.

Command permission and reload logic remain the same but cleaner.

Added safeguards for null tools, unbreakable items, and invalid ore types.

1.0.1Релиз1.21.6, 1.21.7, 1.21.8 · 25 августа 2025 г.

Version 1.0.1 (Improvements and Fixes) Improvements:

Config Defaults & Reloads: Implemented saving defaults, copying values, and reloading configurations cleanly. Flexible Ore List: Allowed server administrators to customize the list of ores through the configuration file. BFS Vein Search: Replaced recursion with a queue-based BFS algorithm to avoid stack overflow issues during vein mining. Durability Handling: Correctly accounted for the Unbreaking enchantment when applying durability damage to tools. Action Bar Feedback: Added user experience enhancements by displaying the number of additional blocks mined in the action bar. Permission Check for Reload: Implemented permission checks to restrict access to the reload command. Fixes:

Removed Duplicate Imports: Cleaned up the code by removing duplicate import statements. XP Calculation: Adjusted XP handling to ensure it aligns with vanilla mechanics, providing appropriate rewards for mined ores. Durability Application: Fixed the issue of double counting durability damage for the original mined block. Block Drops Duplication: Ensured that drops for the original block are not duplicated, preventing inconsistencies.

Efficiency: Enhanced performance by breaking early once the maximum block limit is reached, reducing unnecessary processing. Silk Touch Check: Added support for the Silk Touch enchantment, allowing players to mine ores without breaking them into drops. Tool Whitelist: Implemented a check to ensure only pickaxes can activate vein mining, preventing unintended usage with bare hands. Multi-thread Safety: Considered offloading scanning to async to improve performance for large veins (optional). Fixes:

Distance Check Bug: Corrected the distance checks in the BFS algorithm to ensure accurate range limits from the original mined block. Missing Imports: Added missing imports for Collectors and Enchantment to ensure the code compiles correctly.

Enhanced XP Handling: Improved XP calculation by utilizing the BlockExpEvent for extra blocks, allowing for better integration with other plugins. Improvements:

Documentation: Updated comments and documentation within the code for better clarity and understanding. Fixes:

General Bug Fixes: Continuously monitored and addressed any bugs or issues reported by users to ensure a smooth experience.

V1.0Релиз1.21.6, 1.21.7, 1.21.8 · 1 августа 2025 г.

the first release

Комментарии

Загружаем…