[HEADING=2]CustomVeins[/HEADING]
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:
This allows complete control over when vein mining is active.

[HEADING=3]Features[/HEADING]

• 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>

[HEADING=3]Command[/HEADING]
Permission:
- `/customveins true` enables the system
- `/customveins false` disables it immediately

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

[HEADING=3]Configuration[/HEADING]
Generated on first run:

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

[HEADING=3]How It Works[/HEADING]

• 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
• Breaks all qualifying blocks naturally

[HEADING=3]Requirements[/HEADING]

• Java 17+
• Paper or Spigot 1.20+

[HEADING=3]Source Code[/HEADING]
The full source is available on GitHub:
https://github.com/BlockForge-Studios/CustomVeins