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