超采掘形状+

Ultimine Shapes+

通过 JSON 文件为 FTB Ultimine 添加你自己的挖掘形状。Ultimine Shapes+ 是一个 Forge 1.20.1 的附属模组，它无需修改 FTB Ultimine 本身，即可为 Ultimine 的常规选择器添加形状。

包含的形状

• Flatten 3x3、5x5 和 9x9： 在目标方块所在的 Y 层选择水平切片，无论点击哪个面。
• Plane（平面）： 可配置宽度和深度。
• Wall（墙体）： 可配置沿 X 或 Z 轴的宽度和高度。
• Box（箱体）： 可配置宽度、高度和深度。
• Column（柱体）： 可配置高度，向上或向下延伸。
• 自定义偏移： 为你自己的图案选择精确的相对方块坐标。

三个 Flatten 示例会在首次启动时自动安装。其他形状可以通过 JSON 添加。

要求与安装

1.0.1 版本针对 Minecraft 1.20.1 / Forge 47.4.0，并且需要：

• FTB Ultimine（Forge）2001.1.8（精确版本）
• FTB Library（Forge）2001.2.1 或兼容的更新 2001.x 版本
• Architectury API（Forge）9.2.14 或兼容的更新 9.x 版本

在客户端和服务器端都安装该附属模组及其依赖项。替换旧版本的 Ultimine Shapes+ JAR 文件，请勿同时安装两个版本。

无需重新构建即可添加形状

在以下目录中创建一个 UTF-8 编码的 JSON 文件：

config/ultimineshapes/shapes/

例如，将此文件保存为 flatten_7x7.json：

{
  "id": "flatten_7x7",
  "display_name": "Flatten 7x7",
  "type": "plane",
  "width": 7,
  "depth": 7
}

将相同的形状文件复制到服务器和每个客户端，然后完全重启它们。按住常规的 Ultimine 按键，并在其常规形状选择器中循环切换。新名称会根据 display_name 自动生成；无需重新构建或手动设置资源包。

必须进行完全重启。 /reload 不会重新加载形状。FTB Ultimine 1.20.1 通过列表索引来识别形状，因此客户端/服务器端形状文件不匹配可能会显示不正确的选择器名称。

对于精确图案，请使用 "type": "custom_offsets" 和一个 offsets 数组，例如 [[0,0,0],[1,0,0],[-1,0,0],[0,0,1],[0,0,-1]]。包含目标方块 [0,0,0]。坐标使用世界坐标轴，不会随玩家旋转。

常规 Ultimine 规则仍然适用

FTB Ultimine 管理耐久度、饥饿值、掉落物、权限和常规挖掘限制。形状使用其选择检查和有效方块限制。一个完整的 9x9 平面至少需要 81 个符合条件的方块，并且有效限制为 81 或更高；若限制较小，则会故意选择较少的方块。

无效的 JSON 会被跳过，并在 logs/latest.log 中显示警告。每个形状 ID 必须是唯一的。尺寸有界限，生成的形状会优先选择最接近目标方块的方块。

这是一个独立的附属模组，不是官方 FTB 项目。必须单独安装 FTB Ultimine；其源代码和 JAR 未捆绑在内。