?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
CaveMiner

CaveMiner

A lightweight VeinMiner-style plugin — break one ore, mine the whole vein. Fortune-aware, Unbreaking-aware, fully configurable in a single config.yml. Optional PlaceholderAPI support.

2
0
2
0

Compatibility

Minecraft: Java Edition

26.1.x
1.21.x

Platforms

Links

Join Discord server

Tags

Creators

Details

Licensed ARR
Published 13 hours ago

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