CaveMiner

Mine the vein. Not just the block.

A lightweight VeinMiner-style plugin — fully configurable in a single config.yml. No bloat, no dependencies except an optional PlaceholderAPI hook.

---

✨ Features

Feature	Description
Vein Mining	Breaks all connected ore blocks of the same type in one swing.
Fortune Support	Applies vanilla Fortune logic to every block in the vein.
Smart Tool Check	Each ore has its own allowed-tool whitelist — wrong pick = no vein.
Durability Loss	Unbreaking-aware durability drain per block mined. Tool breaks naturally.
Drop Consolidation	All drops from the entire vein land at the first broken block.
Sound on Trigger	Fully configurable sound plays when vein mining activates.
Creative Mode Guard	Vein mining is disabled in Creative by default (configurable).
Sneak Toggle	Optional: hold sneak to activate (or deactivate) vein mining.
PlaceholderAPI Support	Expose per-player stats to any PAPI-compatible plugin.
/caveminer reload	Reload config without restarting the server.

---

📦 Dependencies

• PlaceholderAPI — optional — Modrinth

---

📋 PlaceholderAPI Placeholders

Placeholder	Description
%caveminer_blocks_mined%	Total blocks broken via vein mining
%caveminer_veins_triggered%	How often vein mining was triggered

---

⚙️ Configuration

Everything is controlled from a single config.yml:

# Master switch
enabled: true

# Disable vein mining for Creative mode players
disable-in-creative: true

# Maximum blocks broken in a single vein event (prevent lag on huge veins)
max-chain-size: 64

# Sneak key behaviour
sneak:
  required: false        # true = sneak key controls activation
  sneak-activates: true  # true = must sneak to activate | false = sneak disables it

# Drop behaviour
drops:
  all-at-source-block: true  # false = drops at each block's own location

# Sound played when vein mining triggers
sound:
  name: "block.stone.break"
  volume: 1.0
  pitch: 1.2

# Per-ore tool whitelist — only listed tools trigger vein mining for that ore
ore-tool-map:
  DIAMOND_ORE:
    - IRON_PICKAXE
    - DIAMOND_PICKAXE
    - NETHERITE_PICKAXE
  ANCIENT_DEBRIS:
    - DIAMOND_PICKAXE
    - NETHERITE_PICKAXE
  # ... all vanilla ores pre-configured out of the box

🔩 How It Works

1. Player breaks an ore with the correct pickaxe tier
2. Plugin runs a BFS flood-fill through all touching blocks of the same ore type (diagonal included)
3. Each block is broken individually — Fortune applies per block, Unbreaking is respected per durability tick
4. All drops teleport to the position of the first broken block
5. A sound fires at the source block on trigger

---

👥 Credits

Author	LucasTHCR

Discord: dc.gg/paperstream