CustomVeins

A fully configurable vein-mining plugin for Paper and Spigot servers.

Unlike most vein-miner plugins, CustomVeins does not activate automatically. Server administrators must enable it manually using:

/customveins true

This allows complete control over when vein mining is active.

Features

• Configurable global enable/disable toggle
• Fully customizable vein block list (vein-blocks)
• Optional pickaxe-only mode
• Optional durability usage
• Adjustable maximum vein size
• Toggle diagonal/3D vein searching
• Simple admin command: /customveins <true|false>

Command

/customveins <true|false>

Permission:

customveins.admin

• /customveins true enables the system
• /customveins false disables it immediately

If the command is never used, the plugin remains inactive.

Configuration

Generated on first run:

settings:
  enabled: false               # Must be set to true via /customveins
  include-diagonals: false     # true = 26-direction search, false = 6-direction scan
  require-pickaxe: true
  use-durability-per-block: true
  max-vein-size: 64

vein-blocks:
  - coal_ore
  - deepslate_coal_ore
  - iron_ore
  - deepslate_iron_ore
  - diamond_ore
  - deepslate_diamond_ore

Block IDs available at:
https://minecraft-ids.grahamedgecombe.com/

How It Works

• Detects block break events
• Checks if the plugin is enabled
• Verifies if the block type is vein-minable
• Performs a flood-fill (BFS) search for connected blocks
• Respects max vein size and diagonal settings

Requirements

• Java 17+
• Paper or Spigot 1.20+

Source Code

The full source is available on GitHub here