UltraVein

UltraVein

按住一个键。敲掉一个方块。整条矿脉一并开采。

适用于 Minecraft 1.18 至 26.3 所有版本的通用矿脉挖掘模组——矿脉、隧道、区域、阶梯，以及你亲手绘制的形状；每一种都会在你挥镐前高亮显示。

显示的形状与模组计算结果完全一致。黄色标记表示你正对着的方块。

为什么还要做一个矿脉挖掘模组

大多数矿脉挖掘模组挖完矿脉就没别的了。UltraVein 提供滚轮可切换的十种形状，还能让你绘制自己的形状；方块被破坏前会准确显示出来，而且同一套代码即可运行于 Fabric、Quilt、Forge 和 NeoForge——无需 Architectury、配置库或其他额外安装。

操作方式

V 是默认按键，原版中没有任何功能占用它。你可以像其他按键一样，在选项 → 控制 → UltraVein中重新绑定；此外还有两个可选按键，让你无需滚轮也能逐个切换形状。

切换时，角落中的提示会展开为完整的形状列表，标记随之移动；列表项目不会跳动，因此你总能看清下一个形状。

形状介绍

所有几何形状都会沿着你所看的方向延伸。对着墙壁挖掘时，隧道会横向延伸；低头看着地面时，它就会向下挖。黄色方块就是你敲击的方块。

无形状

就是矿脉挖掘本身——挖掘所有相连的同类方块。

层

只挖掘当前高度上的同类方块。适合平整地面。

柱

垂直向上或向下延伸。适合清理竖井。

3×3 区域

贴着你敲击的面延伸的平面方形区域。

5×5 区域

同样的形状，只是更宽。四次挥镐就能挖出采石场墙面。

3×3×3 立方体

围绕目标方块挖掘一个立方体——变暗的那一层表示其后方的深度。

1×1 隧道

笔直向前延伸的一格宽通道。

3×3 隧道

可以步行通过的通道。你敲击的方块就是地面。

向上阶梯

每级高两格，真正可以走上去。

向下阶梯

同样的设计，向着深板岩延伸。

为什么隧道贴着地面延伸

你瞄准的方块是隧道的地板，而不是隧道中央。瞄准中央会让通道偏移：瞄准高一格，整个横截面也会随之移动，其中一半已经是空气，隧道就会偏离原来的路线。地板是明确的瞄准目标。如果想反过来设置，请将tunnelAnchor设为center。

绘制自己的形状

打开/ultravein config，前往形状，然后点击+ 新建。编辑器会在你击中的方块前方显示一个 7×7×7 的方框——该方块位于最前一层切片的中央。

• 点击单元格在切片网格上添加方块，右键点击可移除方块，拖动鼠标可绘制，滚动鼠标滚轮可在七个切片间切换。
• 网格旁的3D 视图
• 会显示整个形状，拖动时还会随之旋转。当前切片的快捷图案包括：X 形、十字形、3×3、5×5 圆环、填充和清空。点击复制到下一层
• ，即可将当前切片向里重复一层，几下就能画出 X 形隧道。为形状命名

并保存——它会以该名称显示在形状轮盘中，并根据你击中的面旋转，就像隧道形状一样。查看形状 → 已有形状会在 3D 查看器中打开所有形状：内置形状、服务器形状以及你自己的形状。可修改的形状旁会显示✎ 编辑

，点击即可打开编辑器；内置形状会另存为你自己的副本。

致服务器所有者/ultravein config所有设置都在

• 中完成——无论是单人游戏、作为局域网主机，还是在专用服务器上担任管理员。无需输入任何命令。形状筛选器：三种模式可选——关闭（所有形状）、白名单（仅限勾选的形状）或黑名单
• （除勾选形状外的所有形状）。下方列表为每种形状都提供了勾选框。被筛选排除的形状会从所有玩家的轮盘中消失，服务器也会拒绝使用这些形状。玩家形状：允许 / 禁止
• ——设置玩家是否可以使用自己绘制的形状。集中查看所有玩家的形状：
• 客户端会将自己绘制的形状发送到服务器，因此管理员可以在列表中看到这些形状及绘制者，包括离线玩家；还可以逐一将它们加入白名单或黑名单。与所有人分享形状：管理员保存形状时（保存并分享
• ），所有玩家的轮盘都会立即收到该形状及其名称。工具筛选器：
• 可选的工具黑名单或白名单，用于限制哪些工具可以进行连锁挖掘；列表包含游戏中的所有物品，并支持搜索。游戏玩法与规则和筛选器选项卡也可供专用服务器的管理员使用：点击保存并应用即可将更改发送到服务器。

哪些方块会被挖掘，哪些会保留

默认情况下，即使是几何形状，也只会挖掘匹配的方块。在石头中挖掘 1×1 隧道时，矿石会保留下来，因为它们不是你开始挖掘的那种方块。如果想一路挖穿所有方块，请将geometryMatchMode设为any。

“匹配”指相同方块，以及自动识别出的变种：iron_ore和deepslate_iron_ore会被视为一组，mod:zinc_ore和mod:deepslate_zinc_ore也一样，oak_log与oak_wood亦然。这套机制依据命名规则运行，而非依赖列表，因此也能识别无人手动添加的模组矿石。未能识别的内容可添加到extraBlockGroups。

耐久损耗确实存在

每多挖一个方块，都会像普通挥动工具那样，通过同一套原版调用来破坏。这是有意为之：工具损耗、时运、精准采集、掉落物、经验、饥饿消耗，以及每个保护类模组的权限检查都会照常生效，而不是重新实现一遍、导致结果出现细微偏差。

挖掘四十个方块，就会消耗四十点耐久。preventToolBreak会在你的镐子损坏前停止。

安装方式

选择适用于你的 Minecraft 版本和加载器的文件。Fabric 和 Quilt 需要Fabric API；Forge 和 NeoForge 无需其他前置。Quilt 使用 Fabric 文件——Quilt Loader 可直接运行该文件，因此它同时标注支持两者。

在 1.20.1 中，NeoForge 仍可直接替代 Forge，因此 Forge 文件也适用于两者。从 1.20.2 到 1.20.4，Forge 和 NeoForge 各有自己的文件。从 1.20.6 开始，NeoForge 文件也能在 Forge 上运行——使用任一加载器时都选择它。

服务器端也要安装。挖掘操作在服务器端进行。仅在客户端安装时，虽然会显示高亮，但不会造成任何破坏——而且它会用红字明确提示你，不会悄无声息地什么都不做。

此模组在客户端和服务器端均为可选安装：安装了模组的客户端可以加入未安装模组的服务器，反之亦然。玩家不会因此被踢出。

配置

两个普通的 JSON 文件，位于config/，可在游戏中通过/ultravein reload重新加载。

ultravein-server.json决定具体行为：

ultravein-client.json 仅控制外观和输入：HUD 位置、高亮颜色、透视高亮、滚动行为，以及你自己绘制的形状。服务器记录的玩家形状存放在 ultravein-player-shapes.json 中。

在多人游戏中，以服务器的规则为准；玩家加入时，服务器会将规则推送给每个客户端，因此高亮始终会准确显示实际效果。

命令

• /ultravein config — 打开游戏内配置菜单（实时设置规则和视觉效果）
• /ultravein info — 查看当前生效的规则（包括 drop at player）
• /ultravein dropAtPlayer [true|false] — 切换或设置掉落物是否传送到玩家处（权限等级 2）
• /ultravein reload — 重新加载配置（权限等级 2）

对于服务器控制台，配置界面中的所有操作也都可以通过命令完成（权限等级 2）：/ultravein rule <key> <value>、/ultravein shapes list、shapes mode <none|whitelist|blacklist>、shapes whitelist|blacklist add|remove <shape>（ID 示例：tunnel_3x3、server:Name、player:Name/Shape）、shapes playerShapes <true|false>、shapes unshare <name>、toolblacklist|toolwhitelist list|add|remove|clear <item>。

采用 MIT 许可证。 灵感来自 FTB Ultimine。