矿脉矿工

Viper Vein Miner

Viper Vein Miner 是一个轻量级的 客户端 + 服务端 连锁挖矿模组，适用于 Minecraft 1.21.x、26.1.x 和 26.2.x。默认情况下，它只挖掘 矿石和树木，不会影响其他任何方块。矿脉包括面不相接的对角相连方块。

支持的版本

版本	Java	状态
1.21.x	21	完全支持
26.1.x	25	完全支持
26.2.x	25	完全支持

---

用途与功能

Viper Vein Miner 的目标是让挖矿和砍树更快，同时不会意外破坏普通方块。矿石之间通过全部 26 个相邻位置连接，而原木则使用直接面对面的连接。

• 安全的默认选择： 矿石和原木默认启用；所有其他方块默认禁用。
• 对角矿石检测： 矿石方块可以通过面、棱或角相连。它们不需要共享一个面。
• 树木挖掘： 砍伐直接相连的原木，无需逐个破坏每个方块。
• 可选的全方块模式： 当你需要更广泛的行为时，可以启用任意匹配的方块类型作为矿脉。
• 原版风格工具使用： 手持工具会为每个挖掘的方块消耗耐久度。
• 耐久保护： 在手持工具即将损坏前停止挖掘。
• 可配置的矿脉上限： 控制一次可挖掘的方块数量；默认值为 64。
• 实时预览： 挖掘前会高亮显示相连的方块，让你看到将受影响的范围。
• 服务端权威挖掘： 方块破坏由服务端处理，以实现多人游戏同步。

---

主要特性

特性	描述
仅矿石与树木	矿石和原木默认启用；普通方块不会
26 位置矿石搜索	查找面、棱和角相连的矿石，包括对角相连
树木挖掘	挖掘同方块类型的面对面相连原木
3 种激活模式	选择 CROUCH、KEYBIND 或 ALWAYS
自定义按键绑定	使用 KEYBIND 模式时默认按住 V
矿脉预览	在受影响的方块上显示半透明黄色高亮
工具保护	在工具达到损坏点前停止挖掘
矿脉大小限制	可配置的最大值，默认为 64 个方块
全方块模式	可选地允许任意类型的相连方块作为矿脉
多人游戏支持	服务端挖掘，客户端预览和按键绑定支持
轻量级	仅需要 Fabric Loader 和 Fabric API

增强你的服务器配置！ 在我的其他服务端模组中查看： Fabric Server Essentials

---

如何使用

1. 安装 Fabric Loader、Fabric API 和 Viper Vein Miner。
2. 在服务器上安装该模组 以进行多人游戏；在客户端安装以获得高亮和按键绑定支持。
3. 潜行 并使用默认配置破坏一个矿石或原木。
4. 观察相连的矿脉被破坏，直到达到配置的上限或工具即将损坏。

默认激活模式为 CROUCH。要改用按键绑定，请将 activationMode 设置为 KEYBIND，然后在挖掘时按住 V。

---

配置

配置文件会自动生成在：

config/viper_vein_miner_config.json

默认配置：

{
  "enableTreeMiner": true,
  "enableOreMiner": true,
  "allBlocksAreVeins": false,
  "maxVeinSize": 64,
  "activationMode": "CROUCH",
  "renderHighlight": true,
  "highlightAlpha": 0.4
}

选项	描述	默认值
enableTreeMiner	启用面对面相连的原木挖掘	true
enableOreMiner	启用面、棱和角相连的矿石挖掘	true
allBlocksAreVeins	允许任意相连的匹配方块作为矿脉挖掘	false
maxVeinSize	一次操作中挖掘的最大方块数量	64
activationMode	激活方式：CROUCH、KEYBIND 或 ALWAYS	CROUCH
renderHighlight	显示受影响方块的预览	true
highlightAlpha	预览不透明度，从 0.0 到 1.0	0.4

编辑配置文件后，请重启游戏或服务器。

现有配置文件会保留其已保存的值。要获得预期的仅矿石与树木行为，请使用 enableTreeMiner: true、enableOreMiner: true 和 allBlocksAreVeins: false。

---

安装

需求	是否需要
Fabric Loader	是
Fabric API	是
客户端安装	单人游戏、预览和按键绑定模式所需
服务端安装	多人游戏矿脉挖掘所需
Mod Menu	不需要

使用与你 Minecraft 版本匹配的 JAR，并将其放入 mods 文件夹。

---

为那些想要减少重复性方块破坏又不失去控制的矿工而打造。看见矿脉，保护你的工具，一击挖掘。