## ⛏️ 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: ```yaml 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 ---
