CustomVeins

Minecraft 版本： 1.2.1 1.2.2 1.2.3 1.2.4 1.2.5 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： paper spigot

标签： utility

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