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

• Vein mine ores and logs – Break connected blocks of the same type instantly or with a configurable delay.
• Fully configurable blocks and tools – Define which blocks can be vein mined and exactly which tools are required.
• Player groups with granular control – Create groups like vip and premium with custom limits, activation modes, and break speeds.
• Per-vein and per-block overrides – Set different max blocks, distances, and settings for specific ores or logs within the same group.
• Multiple activation modes – Choose between NONE (always active) or SNEAK (crouch to activate).
• Tool damage and Unbreaking support – Optionally apply durability loss for extra blocks broken, with full respect for the Unbreaking enchantment.
• Instant or delayed breaking – Break all blocks at once or sequentially with a tick delay to prevent server lag.
• Admin commands with tab completion – 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.

# 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