CustomVeins

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