VeinMiner 连锁采集

VeinMiner 连锁采集
挖一块矿，整条矿脉一起碎。把枯燥的重复性挖掘变成令人满足的连锁体验——兼容原版数据包与服务端插件/Mod，支持 V1 轻量版与 V2 全自定义版两条体系。
基本信息

| 项目 | 信息 |
| --- | --- |
| 数据包 / 插件名称 | VeinMiner（连锁采集） |
| 开发者 | Miraculixx（Owner） |
| 最新版本 | V2 体系 2.12.1（2026-08-23，NeoForge / Fabric / Paper） |
| 许可协议 | AGPL-3.0-only |
| 兼容版本 | Minecraft Java 1.17.x – 26.2 |
| 运行平台 | V1：Bukkit、原版 Data Pack（Spigot/Paper 等均可用）；V2：Fabric、Quilt、Paper、Purpur、Folia、NeoForge、Forge |
| 项目地址 | https://modrinth.com/datapack/veinminer |
| 官方文档 | 项目页内 Wiki；群组配置模板由 @DereC4 整理 |
累计下载量约 6860 万（Modrinth），是连锁采集类中最广泛使用的方案之一。
简介

VeinMiner 的核心逻辑极简：当你正常挖掉一块符合条件的方块时，与之相连的同类方块（矿脉）会被一次性连锁破坏。原本要逐格敲几十下的深板岩矿脉，现在一镐到底。

它最初是 UHC、整合包、生存 PvP 中的常见机制，用于加速整条矿脉的采集；如今 VeinMiner 把它做成了一个可在原版服务端、Bukkit 插件、Fabric/Quilt Mod、NeoForge/Forge Mod 上运行的完整方案，预配置了矿石与镐的默认规则，开箱即用，也允许深度自定义。
两个版本体系

VeinMiner 同时提供 V1 与 V2，按服务端环境二选一即可：

| 版本 | 定位 | 适用环境 |
| --- | --- | --- |
| V1.x（Data Pack 轻量版） | 设置较少、即装即用，兼容原版与快照 | 任意服务端 / 世界，以数据包形式运行 |
| V2.x（Mod & Plugin 全自定义版） | 功能完整、可深度配置方块组、工具限制、覆盖规则 | Fabric/Quilt、Paper/Purpur/Folia、NeoForge/Forge |

V2 预配置同样面向矿石与镐，但额外提供方块组（Block Groups）、工具白名单、客户端热键、设置覆盖等进阶能力。V1 通过聊天菜单交互配置；V2 通过命令与 default_groups.json 配置文件管理。
核心特性
一键连锁整条矿脉
正常挖掘任一可连锁方块，相连的同组方块随之破坏。支持矿石、原木、农作物、沙石等任意可分组方块。
精细化方块组（V2）
多个方块可被归入同一"组"，组内方块视作同一类型一起连锁；一个方块可同时属于多个组。通过命令或 default_groups.json 直接编辑：
创建组：/veinminer groups create <组名> [命名空间] [ID]
增删方块：/veinminer groups edit <组名> add-block <方块> / remove-block
增删工具：/veinminer groups edit <组名> add-tool <工具> / remove-tool

支持用标签批量添加，例如 #minecraft:logs 代表所有原木，#minecraft:axes 代表所有斧。也可按 F3 查看准星所指方块的命名空间与 ID。
工具限制
组可限定仅某类工具可触发连锁（如 wood 组仅斧头生效）。规则如下：
组未添加任何工具 → 允许所有工具
方块属于多个组 → 多个组的工具均可
方块同时在一个"无工具限制组"和一个"限定组"中 → 仅限定的工具生效
丰富调速参数
通过 /veinminer settings <参数> [值] 修改，省略值即为查询当前值：

| 参数 | 说明 | 默认值 |
| --- | --- | --- |
| mustSneak | 是否必须潜行才连锁 | false |
| cooldown | 两次连锁允许的间隔（tick） | 20 |
| delay | 每次自动破坏方块之间的间隔（tick） | 1 |
| maxChain | 单次连锁最多破坏方块数 | 100 |
| needCorrectTool | 是否必须使用对应工具 | true |
| searchRadius | 相连判定的搜索半径（最大 5） | 1 |
| permissionRestricted | 是否启用权限限制 | false |
| mergeItemDrops | 是否把所有掉落物合并到源方块处 | false |
| autoUpdate | 是否自动检查并更新 | false |
| durabilityDecrease | 每块被连锁方块是否消耗耐久 | true |
| miningSpeedModifier | 随矿脉规模增加的挖掘时长系数 | 0.0 |
| hungerPerBlock | 每块连锁消耗的饱食度（原版基准 0.005） | 0.0 |
设置覆盖（Overrides，V2 进阶）
支持客户端覆盖与组覆盖两级覆盖，优先级为 普通 < 客户端 < 组：
客户端覆盖：对使用 Hotkey 客户端的玩家生效，例如给热键用户单独关闭潜行要求
组覆盖：对挖掘该组方块的玩家生效，例如让沙土组不消耗耐久
用 /veinminer ... override unset <参数> 移除覆盖
客户端热键与高亮（可选附加包）
安装 VeinMiner Hotkey 附加包后，可仅在按住快捷键时连锁，并获得挖掘预览；客户端可自选挖掘模式与深度、高亮掉落物（由客户端本地计算）。
作为附魔（可选附加包）
安装 VeinMiner Enchantment 附加包后，连锁采集被限制为仅带有该附魔的工具才能触发。
跨平台与权限
服务端侧运行，对所有客户端生效，跨加载器与版本兼容附加包。OP 默认拥有全部权限；非 OP 可通过 Luckperms 手动授权（NeoForge 暂不支持 Luckperms）。
环境要求

| 项目 | 要求 |
| --- | --- |
| 服务端 | V1：任意（数据包）；V2：Fabric/Quilt、Paper/Purpur/Folia、NeoForge/Forge |
| Minecraft | Java 版 1.17.x – 26.2 |
| 前置依赖 | V2 Fabric/Quilt 版需 Fabric API、Kotlin；其余按需 |
| 可选附加 | VeinMiner Hotkey、VeinMiner Enchantment |
Folia 用户需将 delay 设为 0。挖掘超大自然矿脉时可能因大量掉落物造成客户端/服务端卡顿，请合理设置 maxChain。
安装方法

V1（数据包）
下载对应 Minecraft 版本的 V1 数据包
放入世界 datapacks/ 目录，或在游戏内执行 /datapack enable
通过 /function veinminer:_config（需 OP / 作弊权限）打开交互式聊天菜单配置

V2（插件 / Mod）
根据服务端选择对应文件：Paper 用 veinminer-paper、Fabric/Quilt 放入 mods/、NeoForge/Forge 放入 mods/
Fabric/Quilt 需同时安装 Fabric API 与 Kotlin
重启服务端，生成默认配置
编辑 plugins/.../veinminer/default_groups.json（插件）或 config/.../veinminer/default_groups.json（Mod）
用 /veinminer settings、/veinminer groups 命令实时调整
建议始终下载与 Minecraft 版本匹配的文件；Modrinth 版本下拉框会随新版本更新，安装后请复核所选版本。
命令一览（V2）

| 命令 | 说明 |
| --- | --- |
| /veinminer blocks | 编辑可被连锁的方块 |
| /veinminer groups | 编辑方块组与工具规则 |
| /veinminer toggle | 全局开关 VeinMiner |
| /veinminer settings <参数> [值] | 修改 / 查询调速参数 |
| /veinminer presets | 快速套用预设（含石块、下界岩、成熟作物等） |

V1 对应命令为 /function veinminer:_config、/function veinminer:settings/general、/function veinminer:settings/pickaxe。
使用场景
UHC / 生存 PvP：加速矿脉采集，缩短无意义挖掘时间
整合包 / 空岛：搭配附魔附加包，把连锁做成工具附魔维度
原版纯净服：直接装 V1 数据包，零插件依赖
大型矿场 / 伐木：用方块组把矿石、原木、作物分组，配合工具限制平衡强度
近期更新
2.12.1（2026-08-23，NeoForge / Fabric / Paper）：将 Paper 事件优先级提升至 MONITOR，使 NeoForge/Fabric 方块破坏触发正常破坏事件；修复切换热键吞噬滚轮的问题
2.12.0（2026-08-13）：修复 Paper 挖掘速度减益（debuff）；新增设置 separateGroupMining 及对应覆盖
2.11.2（2026-07-26）：添加更多实用辅助工具
2.11.1（2026-07-18）：新增每方块饥饿值设置（默认 0.0）；添加 26.2 支持；修复 Fabric 加载器版本要求；修复 mergeItemDrops=true 时的经验合并问题；改进命令响应；修复 Paper 与大型叶子加载问题；新增自定义图案及客户端同步；新增 /veinminer presets、成熟作物连锁等
更新记录来自 Modrinth 版本页与第三方镜像，以项目页实际发布为准。
相关链接
Modrinth 项目页：https://modrinth.com/datapack/veinminer
版本与下载：https://modrinth.com/datapack/veinminer/versions
源码仓库：https://github.com/MiraculixxT/Veinminer
Discord 社区：https://dc.mutils.net
权限管理（Luckperms）：https://luckperms.net/
群组配置模板：由 @DereC4 在 Wiki 提供
许可

本项目基于 AGPL-3.0-only 许可发布，源代码可在上述仓库获取。