极致血管

UltraVein

按住一个键。开采一个方块。整条矿脉随之瓦解。

适用于 Minecraft 1.20.1 的通用连锁挖矿模组 —— 矿脉、隧道、平面和楼梯，在你挥动镐子之前，每一个都会被高亮显示。

每一种形状，与模组的计算结果完全一致。黄色标记的是你正看着的方块。

---

为什么还要再做一个连锁挖矿模组

大多数连锁挖矿模组只挖掉一条矿脉就结束了。UltraVein 通过滚轮为你提供十种形状，在破坏之前精确显示将要被破坏的方块，并且用同一套代码同时支持 Fabric、Forge 和 NeoForge —— 无需 Architectury，无需配置库，无需安装任何额外内容。

功能	含义
先看后挖	按住按键时方块会亮起。无需猜测，没有意外。
十种形状	矿脉、平面、柱状、区块、隧道、楼梯。滚轮切换。
实时调整大小	无需打开菜单即可将 3×3 隧道变成 5×5 或 1×1。
诚实的耐久度	四十个方块消耗四十点耐久。时运和精准采集正常生效。
兼容性好	尊重领地与保护插件。双方均为可选安装。
即插即用	一个 jar 用于 Forge 和 NeoForge，一个用于 Fabric。安装就这么多。

---

操作

输入	作用
按住 V	激活 UltraVein —— 将要被破坏的方块会亮起
V + 潜行 + 滚轮	切换形状
V + 滚轮	扩大或缩小形状
破坏一个方块	所有高亮的方块一同被破坏

V 是默认按键，原版游戏中没有任何功能使用它。你可以在选项 → 控制 → UltraVein中像其他按键一样重新绑定，还有两个可选按键用于不使用滚轮时逐步切换形状。

切换形状时，角落的读数会展开为完整的形状列表，标记在其中移动 —— 列表项保持固定，因此你始终能看到下一个是什么。

---

形状

每一种几何形状都遵循你正看着的那个面。朝墙挖掘，隧道就横向钻入；朝地板向下看，隧道就向下钻。黄色方块是你击中的方块。

不定形

连锁挖矿的本体 —— 所有相连的同类方块。

平面

仅限此高度上的匹配方块。用于平整地面。

柱状

垂直上下。用于清理竖井。

3×3 平面

贴在你击中的面上的方形平面。

5×5 平面

相同，但更宽。四下挖掘即可清理采石场墙面。

3×3×3 立方体

以目标方块为中心的立方体 —— 暗色层是其背后的深度。

隧道 1×1

一条笔直向前的单格宽走廊。

隧道 3×3

一条可通行的走廊。你击中的方块是地板。

上行楼梯

每级两格高，这样你才能真正走上去。

下行楼梯

相同，朝向深板岩。

为什么隧道以地板为基准

你看着的方块是隧道的地板，而不是其中心。以中心为基准会导致走廊偏移：瞄高一格，整个横截面就会随你移动，其中一半已经是空气，隧道就会偏离原定路线。地板是一个明确无歧义的瞄准目标。如果你想要另一种方式，可以将 tunnelAnchor 设为 center。

---

什么会被挖掉，什么会留下

默认情况下，即使是几何形状也只挖掉匹配的方块。 穿过石头的 1×1 隧道会留下矿石，因为它们不是你起始挖掘的方块。将 geometryMatchMode 设为 any 即可直接挖穿一切。

“匹配”指的是相同的方块，加上自动推导出的变种：iron_ore 和 deepslate_iron_ore 会归为一组，mod:zinc_ore 和 mod:deepslate_zinc_ore 也是如此，oak_log 和 oak_wood 也是。这基于命名规则而非列表运行，因此能处理模组添加的、从未被告知的矿石。它遗漏的任何内容都可以放入 extraBlockGroups。

---

耐久度是真实的

每一个额外的方块都通过与普通挥动相同的原版调用被破坏。这是刻意为之：工具损耗、时运、精准采集、掉落物、经验、统计数据、饥饿消耗以及每个保护模组的权限检查都完全照常生效，而不是被重新实现并出现微妙的错误。

四十个方块消耗四十点耐久。preventToolBreak 会在你的镐子断裂前停止。

---

安装

加载器	Jar
Fabric	ultravein-fabric-1.20.1 + Fabric API
Forge 47.x	ultravein-forge-1.20.1
NeoForge 20.1.x	ultravein-forge-1.20.1 —— 同一个文件

在 1.20.1 上，NeoForge 仍然是 Forge 的即插即用替代品，因此一个 jar 同时覆盖两者。UltraVein 未声明对两者的依赖，仅依赖 Minecraft。

服务器端也要安装。 挖掘是在服务端进行的。仅客户端安装会显示高亮但不会破坏任何方块 —— 并且它会用红色文字告诉你，而不是默默地什么都不做。

该模组在双方均为可选：装有它的客户端可以加入未安装它的服务器，反之亦然。没有人会被踢出。

---

配置

config/ 目录下有两个纯 JSON 文件，可在游戏内通过 /ultravein reload 重新加载。

ultravein-server.json 决定实际行为：

键	默认值	含义
maxBlocks	64	相连形状的上限 —— 一组掉落物
maxShapeBlocks	256	几何形状的上限
tunnel3x3Length	10	一条 3×3×10 的走廊，90 个方块
tunnel1x1Length	16	1×1 隧道的深度
staircaseLength	16	每段楼梯的级数
tunnelAnchor	floor	或 center
veinMatchMode	grouped	strict / grouped / any
geometryMatchMode	grouped	同上，用于几何形状
requireCorrectTool	true	只破坏你的工具能采集的方块
preventToolBreak	true	在工具断裂前停止
blockBlacklist	[]	永不触碰的方块 id
disabledShapes	[]	服务器禁止的形状

ultravein-client.json 仅涉及外观和输入：HUD 位置、高亮颜色、透视高亮、滚轮行为。

在多人游戏中，服务器的规则优先，并在加入时推送给每个客户端，因此高亮始终显示实际将要发生的情况。

---

命令

• /ultravein info —— 当前生效的规则
• /ultravein reload —— 重新加载配置（权限等级 2）

---

MIT 许可。 灵感来自 FTB Ultimine。