VeinminerPlus

VeinminerPlus

VeinminerPlus is a highly customizable vein mining plugin for Paper and Spigot servers (1.20+). Break entire ore veins and tree logs with a single block break while respecting tool requirements and durability. Every setting can be adjusted per player group, per vein type, and even per individual block.

Features

- Permission-based groups – Break connected blocks of the same type instantly or with a configurable delay. - Permission-based groups – Define which blocks can be vein mined and exactly which tools are required. - Permission-based groups – Create groups like `vip` and `premium` with custom limits, activation modes, and break speeds. - Permission-based groups – Set different max blocks, distances, and settings for specific ores or logs within the same group. - Permission-based groups – Choose between `NONE` (always active) or `SNEAK` (crouch to activate). - Permission-based groups – Optionally apply durability loss for extra blocks broken, with full respect for the Unbreaking enchantment. - Permission-based groups – Break all blocks at once or sequentially with a tick delay to prevent server lag. - Permission-based groups – Toggle vein mining globally, per player, or per group. Reload configuration on the fly. - Permission-based groups – Players join groups via permissions like `veinminerplus.group.vip` (no extra YAML files required).

Commands

| Command | Description | |---------|-------------| | `/veinminer reload` | Reload the configuration from disk. | | `/veinminer toggle global <on|off>` | Enable or disable vein mining for everyone. | | `/veinminer toggle player <name> <on|off>` | Toggle vein mining for a specific player. | | `/veinminer toggle group <group> <on|off>` | Enable or disable an entire player group. | | `/veinminer status [player]` | Show global, group, and per-player status. | | `/veinminer set global activation <NONE|SNEAK>` | Change the global activation mode. | | `/veinminer set group <group> activation <NONE|SNEAK>` | Change a group's activation mode. |

All commands have full tab completion for arguments.

Permissions

| Permission | Description | |------------|-------------| | `veinminerplus.admin` | Access to all admin commands. | | `veinminerplus.use` | Allows vein mining (subject to toggles). | | `veinminerplus.group.vip` | Membership in the VIP group. | | `veinminerplus.group.premium` | Membership in the Premium group. |

Installation

1. Download the latest `VeinminerPlus-x.x.x.jar`. 2. Place the JAR file into your server's `plugins` folder. 3. Restart your server (or run `/reload confirm`). 4. Edit the generated `config.yml` to your liking. 5. Use `/veinminer reload` to apply changes without restarting.

Support

For issues, feature requests, or questions, please join our Discord server. ---

*VeinminerPlus is built for Paper 1.20+ and requires no additional dependencies.*

Configuration

The configuration is divided into intuitive sections. Below is an annotated excerpt showing the main components.

```yaml

Global defaults (fallback values)

global-enabled: true max-blocks: 64 max-distance: 16 apply-tool-damage: true apply-unbreaking: true activation-mode: SNEAK break-mode: instant: true delay-ticks: 1

Predefined tool sets for easy reference

default-tools: ores-tools: [WOODEN_PICKAXE, STONE_PICKAXE, IRON_PICKAXE, DIAMOND_PICKAXE, NETHERITE_PICKAXE] logs-tools: [WOODEN_AXE, STONE_AXE, IRON_AXE, DIAMOND_AXE, NETHERITE_AXE]

Vein groups define which blocks belong together and what tools can break them

vein-groups: low-tier-ores: blocks: COAL_ORE: {} COPPER_ORE: {} tools: ores-tools

mid-tier-ores: blocks: IRON_ORE: {} GOLD_ORE: {} DIAMOND_ORE: max-blocks: 10 # Per-block override tools: mid-tier-ores-tools

logs: blocks: OAK_LOG: {} SPRUCE_LOG: {} tools: logs-tools

Player groups define who can vein mine what, with full override capability

player-groups: default: vein-groups: low-tier-ores: enabled: true logs: enabled: true max-blocks: 64 activation-mode: SNEAK break-mode: instant: false delay-ticks: 2

vip: permission: veinminerplus.group.vip enabled: false vein-groups: low-tier-ores: enabled: true activation-mode: NONE mid-tier-ores: enabled: true max-blocks: 200 max-blocks: 128 activation-mode: SNEAK break-mode: instant: true