⛏️ VeinBreaker
一次性挖掘整个矿脉、晶洞结构和洞穴构造,砍伐整棵树木,收割作物,并使用向外扩散的动画放置方块。
一款轻量级且高度可配置的生活质量优化插件,专为生存服务器打造。
? 官网 · ? 报告 Bug · ? 请求功能
? 实时演示

✨ 功能特性
| 功能 |
描述 |
| ⛏️ 矿脉挖掘 |
在主世界、下界和深板岩中,只需挥动一次工具即可破坏整个相连的矿脉 |
| ? 晶洞开采 |
同时采集紫水晶簇、芽、方块、方解石和光滑玄武岩 |
| ? 洞穴构造 |
挖掘滴水石锥、滴水石块、幽匿结构、凝灰石变体和原矿石方块 |
| ? 整树砍伐 |
砍倒整棵树(原木、木材和巨型树干)并彻底清理树叶冠层 |
| ? 作物收割与补种 |
一次性收割成熟的作物区块,并自动立即补种年龄为 0 的新作物 |
| ? 向外渐进动画 |
观看方块以定时向外扩散的波纹波次进行破坏或放置,并伴随逐渐增强的声学叮当声 |
| ? 向外方块放置 |
潜行时按顺序向外在二维平面上放置匹配的方块 |
| ?️ 防止工具损坏 |
当工具耐久度降至 1 时自动停止矿脉挖掘,保护你的顶级工具 |
| ? 直接掉落至背包 |
将挖掘出的物品直接路由到你的物品栏中,避免掉入岩浆或黑暗深渊 |
| ⚡ 经验值自动收集 |
直接将符合原版机制的经验值添加到经验条中,无需拾取实体掉落物 |
| ? 灵活的激活修饰符 |
选择始终开启 (/vb)、潜行激活 (Shift) 或疾跑激活 (Ctrl) 模式 |
| ? 多层粒子特效 |
完整的方块破坏效果 (Effect.STEP_SOUND)、25 个粒子的爆发以及矿物闪光效果 |
| ?️ 尊重修复公式 |
准确计算原版“经验修补”附魔数学逻辑,公平消耗耐久度 |
| ? 邻近矿脉检测 |
使用 3x3x3 的 26 邻域扫描桥接对角线间隙,确保矿脉不会被截断 |
| ?️ 紫水晶母岩保护 |
可选的安全措施保护紫水晶母岩方块,以保留晶体生成器 |
| ?️ 创造模式清理 |
支持创造模式下的快速世界清理,且不会造成杂物掉落 |
| ? 持久化切换状态 |
玩家偏好设置 (/vb, /vb place, /vb anim) 通过 playerdata.yml 在重启后保持持久化 |
| ⏱️ 独立冷却时间 |
每个功能独立的冷却计时器,以防止滥用并保持服务器性能 |
| ? 世界黑名单 |
在特定世界中禁用 VeinBreaker 功能(例如出生点、大厅、小游戏地图) |
| ? 丰富的颜色消息 |
所有聊天消息均支持标准 Minecraft & 颜色格式化和占位符 |
| ♻️ 游戏内实时重载 |
/vb reload 刷新 config.yml 和玩家缓存,无需重启服务器 |
| ? 1.21.x - 26.2 兼容性 |
经过全面测试,完全兼容 Spigot、Paper 及现代服务端分支 |
? 安装方法
- 从 Releases 页面下载最新的
VeinBreaker-2.0.0.jar。
- 将 JAR 文件放入服务器的
plugins/ 目录中。
- 重启或重载你的服务器。
- 根据需要自定义
plugins/VeinBreaker/config.yml。
- 执行
/vb reload 以即时应用配置更改,无需重启服务器。
要求:
- Minecraft 1.21.x - 26.2
- Spigot 或 Paper(强烈推荐 Paper 以获得最佳调度器性能)
- Java 21+
? 命令
所有命令均支持完整命令 /veinbreaker 和简写 /vb。
| 命令 |
权限节点 |
描述 |
/vb |
veinbreaker.use |
开关 VeinBreaker(按玩家持久化保存) |
/vb toggle |
veinbreaker.use |
开关功能的别名 |
/vb place |
veinbreaker.use |
开关向外顺序放置方块功能 |
/vb anim |
veinbreaker.use |
开关向外渐进波纹动画效果 |
/vb status |
veinbreaker.use |
显示当前玩家的偏好设置、修饰符和服务端限制 |
/vb help |
veinbreaker.help |
查看完整的命令列表和使用说明 |
/vb reload |
veinbreaker.reload |
实时重载配置和玩家数据 |
/vb permission add <node> |
veinbreaker.admin |
向允许使用的列表中添加入自定义权限节点 |
/vb permission remove <node> |
veinbreaker.admin |
从允许使用的列表中移除权限节点 |
? 权限节点
| 权限节点 |
默认值 |
描述 |
veinbreaker.use |
OP |
允许开关和使用 VeinBreaker 的挖掘功能 |
veinbreaker.admin |
OP |
授予所有管理命令的访问权限 |
veinbreaker.reload |
OP |
授予执行 /vb reload 的权限 |
veinbreaker.help |
Everyone |
授予查看 /vb help 的权限 |
[!TIP]
你可以在 config.yml 的 permissions.use 下或通过 /vb permission add <node> 直接从第三方插件添加自定义权限节点。
? 深入功能
⛏️ 矿石、晶洞与洞穴挖矿
VeinBreaker 按矿物家族对相连的方块进行分组:
- 矿石: 煤、铁、铜、金、红石、青金石、钻石、绿宝石、下界合金残骸(Nether Gold)、下界石英、远古残骸,以及深板岩变体。
- 粗矿块: 包含
RAW_IRON_BLOCK、RAW_COPPER_BLOCK 和 RAW_GOLD_BLOCK 的大型洞穴矿脉。
- 晶洞: 紫水晶块、萌发的紫水晶、紫水晶簇、小/中/大紫水晶芽、方解石和光滑玄武岩。
- 洞穴特征: 滴水石锥、滴水石块、发光地衣、凝灰岩变体,以及深暗之域菌落结构(
SCULK、SCULK_CATALYST、SCULK_SENSOR、SCULK_SHRIEKER、SCULK_VEIN)。
- 萌发保护: 启用
features.protect-budding-amethyst: true 以防止玩家意外挖掘晶体生成方块。
- 邻近检测: 3x3x3 的 26 邻居扫描桥接了对角角落,确保自然生成的矿脉不会中断。
? 渐进式涟漪动画与粒子特效
VeinBreaker 不再采用瞬时且突兀的大面积方块破坏,而是向外辐射:
- 可配置的波纹时序: 调整
delay-ticks(默认:1 tick = 0.05秒)和 blocks-per-step(默认:每步 2 个方块)。
- 波纹起点: 从玩家位置(
PLAYER)或点击的方块(ORIGIN)向外扩散。
- 音调级联音效: 在整个波纹过程中,音效的音调逐步升高,营造出令人满意的涟漪钟声效果。
- 多层粒子效果:
- 原生方块破坏: 调用 Minecraft 的原生方块破坏事件(
Effect.STEP_SOUND),所有客户端均可见。
- 动态碎裂爆发: 带有速度属性的 25 个方向性
Particle.BLOCK 粒子。
- 矿物闪光点缀: 紫水晶使用末影 rods 星形粒子,菌落使用灵魂萤火粒子,钻石/绿宝石使用暴击闪光粒子,金/铜/红石使用附魔光晕粒子。
?️ 工具耐久度与物品栏保护
- 防止工具损坏: 当工具耐久度降至 1 时停止矿脉挖矿(
tool-durability.prevent-tool-break: true),确保你的附魔下界合金工具永远不会丢失。
- 无损整合: 耐久度损耗严格按照
unbreaking / (unbreaking + 1) 的概率跳过计算每个方块的损坏。
- 直接存入物品栏: 挖掘掉落物直接进入玩家物品栏(
behaviour.direct-to-inventory: true),防止掉入岩浆湖、深渊或虚空。多余的掉落物会在原方块位置自然掉落。
- 经验自动收集: 矿石经验值自动填充玩家的等级条(
behaviour.xp-auto-collect: true),防止经验球卡顿。精准采集正确抑制符合原版规则的经验掉落。
? 激活模式与控制
VeinBreaker 提供多种直观的方式供玩家激活功能:
- 始终开启: 运行一次
/vb;每次破坏匹配的方块都会自动触发矿脉挖矿(sneak-to-activate: false)。
- 按住激活(Shift / Ctrl): 当启用
sneak-to-activate: true 或 sprint-to-activate: true 时,按住 Shift(潜行)或 Ctrl(疾跑)即可触发矿脉挖掘。
- 创造模式: 管理员和创造世界建造者可以在不造成物品杂乱的情况下进行矿脉挖掘,以实现即时地形改造(
behaviour.allow-creative: true)。
? 向外放置方块
- 潜行放置匹配的方块,以向外扩展的方式构建地板、天花板或墙壁。
- 平面限制: 严格限制方块扩展仅限于垂直于点击面的二维平面内。
- 支撑检查: 确保相邻方块共享相同的背面支撑材料,防止出现失控的悬浮方块。
- 默认禁用:
features.block-placement: false 确保标准的潜行建造行为不会意外触发大规模放置。请在 config.yml 或通过 /vb place 命令启用它。
?️ 从源代码构建
git clone https://github.com/Usama-Balhasal/VeinBreaker.git
cd VeinBreaker
mvn clean package
编译后的 shaded JAR 文件将位于 target/VeinBreaker-2.0.0.jar。
要求: Java 21, Maven 3.8+
? 许可证与致谢
VeinBreaker 根据 MIT License 许可发布。
由 Usama Balhasal 开发 | 网站 · GitHub
⛏️ VeinBreaker
Mine entire ore veins, geode formations, and cave structures, fell whole trees, harvest crops, and place blocks with outward ripple animations.
A lightweight, highly configurable quality-of-life plugin built for survival servers.
? Website · ? Report a Bug · ? Request a Feature
? Live Demo

✨ Features
| Feature |
Description |
| ⛏️ Ore Vein Mining |
Break an entire connected ore vein with a single swing across Overworld, Nether, and Deepslate |
| ? Geode Mining |
Harvest Amethyst clusters, buds, blocks, calcite, and smooth basalt simultaneously |
| ? Cave Formations |
Mine pointed dripstone, dripstone blocks, sculk structures, tuff variants, and raw ore blocks |
| ? Tree Felling |
Chop down whole trees (logs, wood, and giant trunks) and cleanly clear leaf canopies |
| ? Crop Harvesting & Replant |
Harvest mature crop patches in one swing with automatic, instant age-0 replanting |
| ? Outward Progressive Animation |
Watch blocks break or place in timed outward ripple waves with escalating acoustic chimes |
| ? Outward Block Placement |
Place matching blocks sequentially outward in 2D planes while sneaking |
| ?️ Prevent Tool Break |
Automatically halts vein mining when tool durability hits 1, saving your max-tier tools |
| ? Direct-to-Inventory Drops |
Routes mined items directly into your inventory so drops never fall into lava or dark ravines |
| ⚡ XP Auto-Collection |
Grants vanilla-accurate XP directly to your experience bar without entity orb clutter |
| ? Flexible Activation Modifiers |
Choose always-on (/vb), sneak-to-activate (Shift), or sprint-to-activate (Ctrl) modes |
| ? Multi-Layer Particle Juice |
Full block break effects (Effect.STEP_SOUND), 25-particle bursts, and mineral sparkles |
| ?️ Unbreaking Formula Respect |
Accurately calculates vanilla Unbreaking enchant math for fair durability consumption |
| ? Proximity Vein Detection |
3x3x3 26-neighbor scanning bridges diagonal gaps so veins aren't cut short |
| ?️ Budding Amethyst Protection |
Optional safeguard protects budding amethyst blocks to preserve crystal spawners |
| ?️ Creative Mode Clearing |
Supports Creative mode for rapid world clearing without dropping clutter |
| ? Persistent Toggle State |
Player preferences (/vb, /vb place, /vb anim) persist across reboots via playerdata.yml |
| ⏱️ Independent Cooldowns |
Per-feature cooldown timers to prevent spam and preserve server performance |
| ? World Blacklist |
Disable VeinBreaker functionality in specific worlds (e.g., spawn, hubs, minigames) |
| ? Rich Color Messages |
All chat messages support standard Minecraft & color formatting and placeholders |
| ♻️ Live In-Game Reload |
/vb reload refreshes config.yml and player caches without restarting the server |
| ? 1.21.x - 26.2 Compatibility |
Fully tested and compatible across Spigot, Paper, and modern server forks |
? Installation
- Download the latest
VeinBreaker-2.0.0.jar from the Releases page.
- Place the JAR into your server's
plugins/ directory.
- Restart or reload your server.
- Customize
plugins/VeinBreaker/config.yml to your liking.
- Execute
/vb reload to apply configuration changes instantly without a server restart.
Requirements:
- Minecraft 1.21.x - 26.2
- Spigot or Paper (Paper highly recommended for optimal scheduler performance)
- Java 21+
? Commands
All commands support both /veinbreaker and the shorthand /vb.
| Command |
Permission |
Description |
/vb |
veinbreaker.use |
Toggle VeinBreaker on/off (persisted per player) |
/vb toggle |
veinbreaker.use |
Alias for toggle |
/vb place |
veinbreaker.use |
Toggle outward sequential block placement |
/vb anim |
veinbreaker.use |
Toggle progressive outward ripple animation |
/vb status |
veinbreaker.use |
Display active player preferences, modifiers, and server limits |
/vb help |
veinbreaker.help |
View complete command list and usage |
/vb reload |
veinbreaker.reload |
Reload configuration and player data live |
/vb permission add <node> |
veinbreaker.admin |
Add a custom permission node to the allowed use list |
/vb permission remove <node> |
veinbreaker.admin |
Remove a permission node from the allowed use list |
? Permissions
| Permission |
Default |
Description |
veinbreaker.use |
OP |
Allows toggling and using VeinBreaker mining features |
veinbreaker.admin |
OP |
Grants access to all administrative commands |
veinbreaker.reload |
OP |
Grants permission to execute /vb reload |
veinbreaker.help |
Everyone |
Grants permission to view /vb help |
[!TIP]
You can add custom permission nodes from third-party plugins directly in config.yml under permissions.use or via /vb permission add <node>.
? In-Depth Features
⛏️ Ore, Geode & Cave Mining
VeinBreaker groups connected blocks by mineral family:
- Ores: Coal, Iron, Copper, Gold, Redstone, Lapis, Diamond, Emerald, Nether Gold, Nether Quartz, Ancient Debris, and Deepslate variants.
- Raw Ore Blocks: Mega cave veins containing
RAW_IRON_BLOCK, RAW_COPPER_BLOCK, and RAW_GOLD_BLOCK.
- Geodes: Amethyst blocks, budding amethyst, amethyst clusters, small/medium/large buds, calcite, and smooth basalt.
- Cave Features: Pointed dripstone, dripstone blocks, glow lichen, tuff variants, and deep dark sculk formations (
SCULK, SCULK_CATALYST, SCULK_SENSOR, SCULK_SHRIEKER, SCULK_VEIN).
- Budding Protection: Enable
features.protect-budding-amethyst: true to prevent players from accidentally mining crystal spawning blocks.
- Proximity Detection: 3x3x3 26-neighbor scanning bridges diagonal corners so naturally generated veins aren't cut short.
? Progressive Ripple Animation & Particle Juice
Instead of instantaneous, jarring mass block breaks, VeinBreaker can radiate outwards:
- Configurable Wave Timing: Adjust
delay-ticks (default: 1 tick = 0.05s) and blocks-per-step (default: 2 blocks).
- Sort Origin: Ripple outward from the player's position (
PLAYER) or the clicked block (ORIGIN).
- Acoustic Pitch Cascade: Sound effects incrementally shift in pitch throughout the wave to create a satisfying ripple chime.
- Multi-Layer Particles:
- Native Block Destruction: Calls Minecraft's level break event (
Effect.STEP_SOUND) visible on all clients.
- Dynamic Fracture Burst: 25 directional
Particle.BLOCK particles with velocity.
- Mineral Sparkle Accents: End Rod stars for Amethyst, Soul wisps for Sculk, Crit sparkles for Diamonds/Emeralds, and Enchanted glints for Gold/Copper/Redstone.
?️ Tool Durability & Inventory Protection
- Prevent Tool Break: Halts vein mining when your tool reaches 1 durability (
tool-durability.prevent-tool-break: true), guaranteeing your enchanted Netherite tools are never lost.
- Unbreaking Integration: Durability damage strictly calculates
unbreaking / (unbreaking + 1) skip chances per block.
- Direct to Inventory: Mined drops route straight into the player's inventory (
behaviour.direct-to-inventory: true), preventing losses into lava lakes, ravines, or the void. Excess drops fall naturally at the block location.
- XP Auto-Collect: Ore experience automatically fills the player's experience bar (
behaviour.xp-auto-collect: true), preventing XP orb lag. Silk Touch correctly suppresses XP drops matching vanilla rules.
? Activation Modes & Controls
VeinBreaker provides multiple intuitive ways for players to activate features:
- Always-On: Run
/vb once; every matching block broken automatically vein-mines (sneak-to-activate: false).
- Hold-to-Activate (Shift / Ctrl): When
sneak-to-activate: true or sprint-to-activate: true is enabled, holding Shift (Sneak) or Ctrl (Sprint) triggers vein-breaking.
- Creative Mode: Operators and creative world builders can vein-break without item clutter for instant terraforming (
behaviour.allow-creative: true).
? Outward Block Placement
- Sneak-place matching blocks to construct floors, ceilings, or walls in outward ripples.
- Planar Alignment: Restricts block expansion strictly to the 2D plane perpendicular to the clicked face.
- Support Checking: Ensures neighbor blocks share the same backing support material, preventing runaway floating blocks.
- Disabled by Default:
features.block-placement: false ensures standard sneak-building never triggers accidental mass placement. Enable it in config.yml or via /vb place.
?️ Building from Source
git clone https://github.com/Usama-Balhasal/VeinBreaker.git
cd VeinBreaker
mvn clean package
The compiled shaded JAR will be available in target/VeinBreaker-2.0.0.jar.
Requirements: Java 21, Maven 3.8+
? License & Attribution
VeinBreaker is licensed under the MIT License.
Developed by Usama Balhasal | Website · GitHub
评论 0
登录后参与评分
还没有评论,来抢沙发吧