# Better Veinminer<\/p>\n
**Version:** 1.4.0 | **API:** Paper 1.21+ | **Author:** Duong2012G
\n**License:** Apache-2.0 | **Link:** Modrinth<\/p>\n
Mine an entire ore vein in one swing \u2014 with **tier progression, persistent statistics,
\na custom event API, and deep configuration.**<\/p>\n
—<\/p>\n
## Features<\/p>\n
### Core
\n– **6-direction BFS** \u2014 accurate face-adjacent vein detection matching vanilla ore generation; no false positives from diagonal neighbours
\n– **Strict same-type matching** \u2014 only collects blocks of the exact same material
\n– **Fortune & Silk Touch** \u2014 work automatically on every block in the vein
\n– **Per-player toggle** \u2014 each player can enable\/disable independently with `\/bvm toggle`
\n– **Unbreaking-aware durability** \u2014 matches vanilla’s per-hit random probability model
\n– **World whitelist\/blacklist** \u2014 restrict which worlds allow veinminer
\n– **Hot reload** \u2014 `\/bvm reload` applies config changes without a restart<\/p>\n
### Tier System
\nPlayers progress through 4 tiers as they mine more blocks:<\/p>\n
| Tier | Blocks Required | Max Blocks (default) |
\n|:—-:|:————–:|:——————-:|
\n| 1 | 0 | 32 |
\n| 2 | 100,000 | 64 |
\n| 3 | 500,000 | 128 |
\n| 4 | 1,000,000 | 256 |<\/p>\n
All thresholds and max-block limits are configurable. Check progress with `\/bvm tier`.<\/p>\n
### Persistent Statistics ### Custom Event API “`java \/\/ Double EXP on ancient debris plugin.getLogger().info(event.getPlayer().getName() ### Protection Plugin Support ### Permission-Based Limits ### Ore Multipliers ### Per-Ore Cooldowns ### Daily Limits —<\/p>\n ## Installation<\/p>\n 1. Download `BetterVeinminer-1.4.0.jar` **Requirements:** Paper (or any Paper fork) 1.21+, Java 21+<\/p>\n —<\/p>\n ## Permissions<\/p>\n | Permission | Description | Default | —<\/p>\n ## Commands<\/p>\n | Command | Description | Permission | —<\/p>\n ## How to Use<\/p>\n 1. Hold a pickaxe from `tool-whitelist` Fortune and Silk Touch both work automatically on every block in the vein.<\/p>\n —<\/p>\n ## Configuration Reference<\/p>\n ### Basic Settings ### Tier System ### Ore Multipliers ### Per-Ore Cooldowns ### Permission Levels ### Daily Limits ### Custom Messages | Message key | Placeholders | ### EXP Rewards ### World Restrictions ### Effects effects: —<\/p>\n ## Config Examples<\/p>\n ### Survival \/ Economy Server daily-limits: ore-multipliers: ### Hardcore Mode —<\/p>\n ## Developer API<\/p>\n Add as a soft dependency: Listen to `BetterVeinmineEvent`: @EventHandler event.setExpReward(exp * 2); —<\/p>\n ## Bug Fixes in v1.4.0<\/p>\n | # | Bug | Status | —<\/p>\n ## Troubleshooting<\/p>\n **Veinminer not activating:** **Stats reset after restart:** **Daily limit resets too early \/ not resetting:** —<\/p>\n ## Changelog<\/p>\n See [CHANGELOG.md](CHANGELOG.md)<\/p>\n —<\/p>\n ## License<\/p>\n Apache-2.0 \u00a9 Duong2012G<\/p>\n","protected":false},"excerpt":{"rendered":" A Paper 1.21 veinminer plugin that mines entire ore veins instantly. Uses strict same-type BFS matching, so adjacent ores are never accidentally destroyed. Fully configurable via config.yml.<\/p>\n","protected":false},"featured_media":29648,"template":"","meta":{"_minecraft_slug":"better-veinminer","_minecraft_project_id":"3Njs3FsV","_minecraft_author":"Duong2012G","_minecraft_license":"Apache-2.0","_minecraft_downloads":348,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"better-veinminer.zip","_minecraft_size_bytes":175578,"_minecraft_version_count":9,"_minecraft_updated_at":"2026-05-16T11:30:51.790365Z","_minecraft_date_created":"2026-03-10T00:06:15.088189Z","_minecraft_date_modified":"2026-05-14T05:08:42.226571Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/better-veinminer","_minecraft_icon_attachment_id":29648,"_minecraft_imported_at":"2026-06-01T12:15:32+00:00","_minecraft_import_hash":"e01f38c2cd5abc25fb399eb7d742916f","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,124,126,127,128,129,869,92],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-29647","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-bukkit","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-transportation","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\nStats survive server restarts. Saved per-player to
\n`plugins\/BetterVeinminer\/stats\/
\n– Total blocks mined via veinminer
\n– Total veinmines performed
\n– Current tier
\n– Auto-save every 5 minutes (thread-safe snapshot) + on player quit<\/p>\n
\n`BetterVeinmineEvent` lets other plugins hook into every veinmine:<\/p>\n
\n@EventHandler
\npublic void onVeinmine(BetterVeinmineEvent event) {
\n \/\/ Cancel completely (e.g. in protected regions)
\n if (isProtected(event.getPlayer())) {
\n event.setCancelled(true);
\n return;
\n }<\/p>\n
\n if (event.getOreType() == Material.ANCIENT_DEBRIS) {
\n event.setExpReward(event.getExpReward() * 2);
\n }<\/p>\n
\n + ” veinmined ” + event.getBlocks().size() + ” blocks.”);
\n}
\n“`<\/p>\n
\nA `BlockBreakEvent` is fired for each extra block before it is broken.
\nWorldGuard, GriefPrevention, Lands, and Residence can cancel individual blocks
\nwithin protected regions. Per-block events are guarded by an anti-recursion lock
\nso the plugin never triggers itself in a loop.<\/p>\n
\nGive VIP\/Premium players special treatment via `permission-levels` in config.<\/p>\n
\nConfigure different EXP multipliers per ore type.<\/p>\n
\nDifferent cooldown per ore type.<\/p>\n
\nCap veinmines per player per day. Resets at real midnight (persisted across restarts).<\/p>\n
\n2. Drop into your server’s `plugins\/` folder
\n3. Restart or reload the server
\n4. Edit `plugins\/BetterVeinminer\/config.yml`
\n5. Use `\/bvm reload` to apply changes without restarting<\/p>\n
\n|—|—|—|
\n| `betterveinminer.use` | Use veinminer + `\/bvm toggle\/stats\/tier` | `true` |
\n| `betterveinminer.admin` | Reload config (`\/bvm reload`) | `op` |
\n| `betterveinminer.vip` | VIP tier (custom limits via config) | `false` |
\n| `betterveinminer.premium` | Premium tier (best limits via config) | `false` |<\/p>\n
\n|—|—|—|
\n| `\/bvm toggle` | Enable\/disable veinminer for yourself | `betterveinminer.use` |
\n| `\/bvm stats` | View your mining statistics | `betterveinminer.use` |
\n| `\/bvm tier` | Check your current tier & progression | `betterveinminer.use` |
\n| `\/bvm reload` | Reload configuration file | `betterveinminer.admin` |<\/p>\n
\n2. Sneak (Shift) if `require-sneak: true`
\n3. Break any ore block \u2014 the entire connected vein drops at once<\/p>\n
\n“`yaml
\nenabled: true # Master on\/off switch
\nrequire-sneak: true # Player must sneak to activate
\nrequire-pickaxe: true # Player must hold a whitelisted pickaxe
\nmax-blocks: 64 # Max blocks per veinmine (fallback when tier system is off)
\ncooldown-ms: 200 # Cooldown between veinmines in milliseconds
\ndamage-tool: true # Whether the pickaxe takes extra durability damage
\ndamage-multiplier: 1.0 # Multiplier applied to the extra durability loss
\n“`<\/p>\n
\n“`yaml
\ntier-system:
\n enabled: true
\n tier-2-threshold: 100000
\n tier-3-threshold: 500000
\n tier-4-threshold: 1000000
\n tier-1-max-blocks: 32
\n tier-2-max-blocks: 64
\n tier-3-max-blocks: 128
\n tier-4-max-blocks: 256
\n“`<\/p>\n
\n“`yaml
\nore-multipliers:
\n enabled: true
\n multipliers:
\n DIAMOND_ORE: 1.5
\n EMERALD_ORE: 2.0
\n COAL_ORE: 0.5
\n“`<\/p>\n
\n“`yaml
\nper-ore-cooldowns:
\n enabled: false
\n cooldowns:
\n DIAMOND_ORE: 1000
\n COAL_ORE: 200
\n“`<\/p>\n
\n“`yaml
\npermission-levels:
\n betterveinminer.vip:
\n max-blocks: 128
\n cooldown-ms: 100
\n betterveinminer.premium:
\n max-blocks: 256
\n cooldown-ms: 50
\n“`<\/p>\n
\n“`yaml
\ndaily-limits:
\n enabled: false
\n limit-per-day: 10
\n“`<\/p>\n
\nAll messages support `\u00a7` colour codes.<\/p>\n
\n|—|—|
\n| `veinmine-success` | `{count}` |
\n| `tier-up` | `{tier}`, `{blocks}` |
\n| `stats` | `{blocks}`, `{tier}`, `{uses}` |
\n| `daily-limit` | \u2014 |
\n| `cooldown` | `{remaining}` |<\/p>\n
\n“`yaml
\nexp-settings:
\n enabled: false
\n base-exp: 10
\n per-extra-block: 5
\n multiply-by-fortune: true
\n“`<\/p>\n
\n“`yaml
\nwhitelist-worlds: []
\nblacklist-worlds: []
\n“`<\/p>\n
\n“`yaml
\nparticle-effect: true
\nsound-effect: true<\/p>\n
\n particle-type: BLOCK
\n particle-color: “0xFFFFFF”
\n particle-speed: 1.0
\n completion-sound: BLOCK_STONE_BREAK
\n warning-sound: ENTITY_ITEM_PICKUP
\n“`<\/p>\n
\n“`yaml
\ntier-system:
\n enabled: true
\n tier-2-threshold: 50000
\n tier-3-threshold: 250000
\n tier-4-threshold: 500000<\/p>\n
\n enabled: true
\n limit-per-day: 5<\/p>\n
\n enabled: true
\n multipliers:
\n DIAMOND_ORE: 1.5
\n EMERALD_ORE: 2.0
\n“`<\/p>\n
\n“`yaml
\nmax-blocks: 16
\ncooldown-ms: 2000
\ntier-system:
\n enabled: false
\ndamage-multiplier: 2.0
\n“`<\/p>\n
\n“`yaml
\nsoftdepend: [BetterVeinminer]
\n“`<\/p>\n
\n“`java
\nimport dev.duong2012g.bvm.BetterVeinmineEvent;<\/p>\n
\npublic void onVeinmine(BetterVeinmineEvent event) {
\n Player player = event.getPlayer();
\n Material ore = event.getOreType();
\n List
\n int exp = event.getExpReward();<\/p>\n
\n event.setCancelled(true);
\n}
\n“`<\/p>\n
\n|—|—|—|
\n| 1 | Async save race condition \u2014 stats partially written while main thread modifies them | \u2705 Fixed \u2014 snapshot taken on main thread before async I\/O |
\n| 2 | Cooldown cleanup used hardcoded 60 s regardless of configured cooldown | \u2705 Fixed \u2014 cleanup now uses `config.getCooldownMs()` |
\n| 3 | Daily reset based on server uptime ticks, not real calendar date | \u2705 Fixed \u2014 `LocalDate.now()` with persistence in `data.yml` |
\n| 4 | 26-direction BFS could link two separate nearby veins | \u2705 Fixed \u2014 changed to 6-direction (face-adjacent) matching vanilla ore generation |
\n| 5 | `breakNaturally()` bypassed protection plugins (WorldGuard, GriefPrevention\u2026) | \u2705 Fixed \u2014 `BlockBreakEvent` fired per block + anti-recursion guard |
\n| 6 | Unbreaking durability formula was deterministic average, not vanilla per-hit random | \u2705 Fixed \u2014 vanilla-style per-hit random check |
\n| 7 | Tool swap exploit | \u2705 Already fixed in v1.2.1 (slot + `isSimilar()` validation) |
\n| 8 | `PlayerStats` exposed public mutable fields \u2014 external code could set negative values | \u2705 Fixed \u2014 private fields with validated getters\/setters and `copy()` method |
\n| 9 | Config accepted invalid values (`max-blocks: -1`, `damage-multiplier: -100`) | \u2705 Fixed \u2014 all numeric values clamped on load |
\n| 10 | Concurrent async writes could corrupt the same YAML file | \u2705 Fixed \u2014 single-threaded `ExecutorService` serialises all file I\/O |<\/p>\n
\n– Check `enabled: true` in config
\n– Verify the ore is in `ore-types`
\n– Confirm you hold a pickaxe from `tool-whitelist`
\n– Check you are sneaking if `require-sneak: true`
\n– Verify the world is not blacklisted<\/p>\n
\n– Check `plugins\/BetterVeinminer\/stats\/` is writable
\n– Look for `”Failed to save stats”` warnings in server logs<\/p>\n
\n– Upgrade to v1.4.0 \u2014 the old tick-based timer drifted and was skipped on restarts
\n– The new system persists the last reset date to `data.yml`<\/p>\n