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.
2560обновлён 3 нояб. 2026 г.
Механики игрыУтилиты
Описание
CaveMiner
Break one ore, get the whole vein. CaveMiner chains connected ore blocks into a single mining action, keeps the tool's durability and enchantments honest, and drops the loot either where each block stood or all at once at your feet.
Every chained block is announced as a normal block break event, so region protection, claim plugins and block loggers see the vein exactly as they would see a player mining it by hand - a vein that runs into someone else's claim stops at the border instead of tunnelling through it.
Requirements
- Spigot, Paper or a fork on Minecraft 1.21+
- Java 21
- PlaceholderAPI (optional, only for the placeholders)
Commands
| Command | Description | Permission |
|---|---|---|
/caveminer stats | Show your own mining statistics | - |
/caveminer toggle | Switch vein mining off or on for yourself | caveminer.toggle |
/caveminer toggle | Switch vein mining off or on for yourself | caveminer.toggle |
/caveminer reload | Reload config.yml | caveminer.reload |
/cm is an alias. Vein mining itself needs caveminer.use, which defaults to
true; caveminer.reload defaults to op.
Placeholders
| Placeholder | Value |
|---|---|
%caveminer_blocks_mined% | Blocks broken through vein mining |
%caveminer_veins_triggered% | Number of veins triggered |
%caveminer_enabled% | false while the player switched vein mining off |
%caveminer_enabled% | false while the player switched vein mining off |
Configuration
config.yml is documented inline. The parts worth knowing:
max-chain-sizecaps how many blocks one vein may cover. The search never loads a chunk that is not already loaded, so a vein simply stops at the edge of loaded terrain instead of generating it on the main thread.merge-deepslate-variantstreatsDIAMOND_OREandDEEPSLATE_DIAMOND_OREas the same vein, so an ore pocket sitting on the deepslate border is not cut in half.sneak.requiredandsneak.sneak-activatesdecide whether the sneak key turns vein mining on or off.disabled-worldslists worlds where vein mining never triggers.hunger.exhaustion-per-blockmakes every extra block cost hunger;0.005matches mining by hand.drops.all-at-source-blockcollects the whole vein's loot at the block you broke. Experience orbs follow the drops.ore-tool-maplists which ores chain at all and which tools are allowed. An empty tool list means any tool - and bare hands - will do.
Drops and experience come from the block's own loot table, so Fortune and Silk Touch behave exactly as they do in vanilla.
Durability
Each chained block costs one point of durability, Unbreaking included. The block that finally breaks the tool is still mined, the chain stops after it.
Statistics
stats.yml keeps the counters across restarts. Only online players are held in
memory; on quit their values move back into the file, which is written every five
minutes and on shutdown.
Building
mvn clean package
The jar lands in target/caveminer-<version>.jar. paper-api and PlaceholderAPI are
provided and stay out of it.
License
GNU General Public License v3.0. See LICENSE.
Последние версии
Все версии →release
1.4.0-RELEASE
1.4.0-RELEASE3 нояб. 2026 г.6Minecraft: 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 26.1, 26.1.1, 26.1.2, 26.3bukkit, folia, paper, purpur, spigot
Что нового
### Added
- Tree felling. Logs of every wood and stem type work like ores: break one and the whole tree
comes down. `trees.merge-wood-variants` treats log, stripped log and wood of one species as one
tree, `trees.break-leaves` also takes the leaves hanging on it (they never cost durability),
`trees.max-leaves` limits how many. Only axes trigger it by default. A fresh config contains the
log entries under `ore-tool-map`. An existing config needs them copied over from the new default
file, since that map is yours.
- `durability.max-per-vein`: the most durability one vein may use up. `0` means no limit.
- `durability.stop-before-break` (on by default): the vein stops before the tool would break, so
the tool survives with one point left.
release
1.3.0-RELEASE
1.3.0-RELEASE12 окт. 2026 г.106Minecraft: 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 26.1, 26.1.1, 26.1.2, 26.3bukkit, folia, paper, purpur, spigot
Что нового
### Added
- `/cm toggle`. Every player can switch vein mining off and on for themselves, and the choice
survives restarts (stored in `stats.yml`). Permission `caveminer.toggle`, on by default.
`%caveminer_enabled%` shows the current state.
- `disabled-worlds`: worlds where vein mining never triggers, for creative or plot worlds.
- `hunger.exhaustion-per-block`: makes a vein cost hunger for every extra block. `0.005` matches
mining by hand. Default `0`, so nothing changes until you set it.
### Changed
- First stable release with the Folia support from 1.2.0-BETA, so servers on the default
`release` update channel get it as well.
Existing servers: the new options are not added to an existing `config.yml`. Without them the
plugin behaves as before.
beta
CaveMiner 1.2.0-BETA
1.2.0-BETA24 сент. 2026 г.7Minecraft: 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 26.1, 26.1.1, 26.1.2bukkit, folia, paper, purpur, spigot
Что нового
- Runs on Folia. Work that touches the world or a player now goes through the region and entity schedulers there, and bStats stays off on Folia. Paper, Purpur and Spigot behave as before.
release
CaveMiner 1.1.0
1.1.015 авг. 2026 г.35Minecraft: 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 26.1, 26.1.1, 26.1.2bukkit, paper, purpur, spigot
Что нового
Vein mining for ores: break one block and the connected vein follows, with durability and enchantments handled the way vanilla would.
This release is also the first open source one: https://github.com/LucasTHCR/CaveMiner
### Fixed
- Vein mining ignored every protection and logging plugin. Chained blocks were removed without a block break event, so WorldGuard, claim plugins and block loggers never saw them - a vein could be pulled straight through someone else's claim. Every block now fires its own event, and a block another plugin vetoes is skipped while the rest of the vein continues.
- Fortune had no effect. The bonus was read from the block after it had already been set to air, so it never matched. Drops now come from the block's loot table, which applies Fortune and Silk Touch exactly as vanilla does.
- Chained blocks dropped no experience at all. Coal, diamond, emerald, lapis, redstone and quartz gave experience for the one block broken by hand and nothing for the rest of the vein.
- Break particles never appeared - the option was read nowhere. `particles.enabled` now exists in config.yml.
- Bare hands ended the chain after the first block, although an empty tool list is documented as "any tool, or fist".
- The block that breaks the tool is mined instead of being lost.
- Statistics survive a restart and no longer overcount veins that stopped early.
### Added
- `caveminer.use` (default true) and `caveminer.reload` (op) - there was no permission at all before
- `/caveminer reload` and `/caveminer stats`, alias `/cm`
- `merge-deepslate-variants` so an ore pocket on the deepslate border stays one vein
- `sound.name` accepts both `BLOCK_STONE_BREAK` and `block.stone.break`
### Changed
- The listener runs on `HIGHEST`, after protection plugins have had their say. On `HIGH` a plugin cancelling later came too late.
- The vein search skips unloaded chunks instead of generating terrain on the main thread.
- `stats.yml` keeps only online players in memory.
Requires Java 21. PlaceholderAPI is optional.
release
CaveMiner 1.0-RELEASE
1.0-RELEASE13 июн. 2026 г.102Minecraft: 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 26.1, 26.1.1, 26.1.2bukkit, paper, purpur, spigot