Effortless Building: Sophisticated (Enhanced Fork)

精妙建筑

精妙建筑是 Effortless Building 的一个注重稳定性、功能丰富的分支，专为大规模生存建筑而打造。 选择一种建造模式，点击两到三个点，查看实时预览，一整条线、墙、地板、立方体、圆、球、金字塔、圆锥或自然外观的山丘便会一次性放置完成。你可以镜像、径向镜像和阵列你的建筑，使用替换模式交换方块，并用 Ctrl+Z 撤销任何操作。

它支持从 1.16.3 到 26.2 的每一个 Minecraft 版本，在Fabric、NeoForge 和 Forge 上运行（只要该版本存在对应的加载器），并且在生存模式中保持公平：每个方块都会消耗其物品，批量破坏会使用你的工具、耐久度和饥饿值，撤销会精确返还应有的物品。配合可选的 精妙背包 集成，建筑升级可以直接从你的背包中为建筑提供材料。

---

目录

1. 功能一览
2. 快速上手（径向菜单、放置、破坏、取消、预览）
3. 能量等级与触及范围
4. 建造模式（每种模式与选项）
5. 修饰器（镜像、阵列、径向镜像）
6. 替换模式与保护
7. 生存规则（物品、批量破坏、撤销/重做）
8. 物品与配方
9. 精妙背包集成
10. 玩家设置与 HUD
11. 配置
12. 控制与命令
13. 支持的版本与兼容性
14. 常见问题与故障排除
15. 依赖项
16. 署名

---

1. 功能一览

• 15 种建造模式：禁用、单方块、直线、墙、地板、立方体、对角线、斜墙、斜面地板、圆、圆柱、球体、金字塔、圆锥和地形堆，每种模式都有各自的选项（填充、空心、骨架、线宽 1/3/5、从角落或中间开始、短边或长边凸起、五种地形形状并可选自然变化）。
• 3 种可叠加的修饰器：镜像（X、Y 和 Z 平面）、径向镜像（3 到 1000 个切片）和阵列（最多 100 份）。想加多少就加多少；它们按列表顺序生效。
• 替换模式：仅空气、方块和空气、仅方块和按副手过滤，外加快速替换和方块实体保护。
• 实时预览：幽灵方块、轮廓、方块数量和尺寸、所需方块列表，以及你拥有和缺少的数量。你无法支付或无法破坏的方块会被标记并跳过，绝不会伪造。
• 公平生存：精确的物品消耗（双台阶、蜡烛和其他多物品方块也一样），带数据的物品（命名方块、装满的潜影盒）保留其数据，放置失败不扣费，使用正确工具批量破坏、耐久、掉落、饥饿和短暂的挖掘延迟，工具永不损坏，可选生存替换。
• 撤销和重做（默认 50 步），遵循相同的生存规则。
• 随机袋（5、9、27 和 54 格），从你的模板中放置随机方块；Omega 袋每个槽位都有权重。
• 能量等级：触及升级 1 到 3 可提高你在生存模式下的触及距离和建造限制。
• 精妙背包集成：建造升级 1 到 4 级和 Omega 可让建造从你的背包（包括穿戴的背包）中取用方块，批量破坏则使用工具切换背包中的工具。
• 玩家设置界面涵盖所有预览和性能设置，无需编辑配置文件。
• 无需精妙背包也能工作：除背包功能外的一切都可独立运行；此时建造升级物品会作为无配方的惰性占位符保留。

---

2. 入门

5 步快速开始

1. 手持一个方块（例如一组石头）在主手。
2. 按住左 Alt 打开径向菜单，指向直线并松开按键（或点击）。
3. 右键点击直线应开始的方块。移动准星：白色轮廓和幽灵方块会显示直线。
4. 再次右键点击放置整条直线。改为左键点击则取消。
5. 出错了？Ctrl+Z 撤销上一次建造，Ctrl+Y 重做。

要回到原版的放置和挖掘方式，请在径向菜单中选择禁用。游戏始终以禁用模式启动。

径向菜单

按住左 Alt（按键径向菜单）打开它；按住按键期间它会保持打开，且不会暂停游戏。指向一个条目并点击它或松开按键。轻柔的点击声确认选择，新模式的名称会显示在快捷栏上方。

• 环形菜单：按颜色分组的 15 种建造模式（基础、对角线、圆形、屋顶、地形）。指向某个模式可查看其名称，以及在有描述时显示的描述。
• 左侧顶部：打开玩家设置。
• 左侧中间一行：重做、撤销、打开修改器设置、迷你方块预览（开/关），以及在允许替换方块时显示的保护方块实体（开/关）。
• 左侧底部一行（仅在允许替换方块时显示）：仅替换空气、替换方块和空气、仅替换方块、按副手物品筛选。
• 右侧：当前建造模式的选项，每个选项各占一行并带有标签；当前选项会高亮显示。
• 右下角：你的能量等级（或创造模式）。指向此处可查看当前等级和下一级的限制。

在创造模式下，你可以替换方块；在生存模式下，只有服务器启用了生存模式替换功能时才可以（默认关闭）。打开菜单不会取消已开始的建造；选择其他模式则会取消。

放置

主手拿着方块或随机袋，选择一种建造模式，然后右键点击各个点。建造过程中，你会看到：

• 白色轮廓和半透明的预览方块，
• 快捷栏上方显示的方块数量和尺寸，例如 5 blocks (5x1x1)（宽 x 深 x 高），
• 提示文字左键点击取消，右键点击放置，
• 屏幕左侧列出的所需方块（例如 5x Stone）。

第一次点击必须命中一个方块；点击空气不会开始建造。按住鼠标右键会每 4 个刻重复点击一次（建造速度设为快速时则每刻点击一次）。

破坏

启用建造模式时，左键点击会按相同形状破坏方块：用左键点击设定各个点，最后一点会破坏轮廓内的所有方块，右键点击则取消。在创造模式下，破坏会立即完成；在生存模式下，则遵循第 7 节中的生存规则。建造模式启用期间，模组会接管挖掘操作，而不是使用原版机制（在创造模式下，以及启用了生存模式破坏功能时的生存模式下）。切换到禁用即可恢复正常挖掘。

取消

放置过程中左键点击（或破坏过程中右键点击）、不潜行时右键点击箱子或门等可交互方块、打开环形菜单以外的任意界面，或选择其他建造模式，都会取消正在进行的建造或破坏。取消时会播放一段短音效。

预览

• 无法放置的方块（缺少物品，或生存模式下有方块挡路）或无法破坏的方块（工具不合适、无法破坏或受到保护）会显示灰色棋盘格轮廓，并被跳过。
• 迷你方块预览会在每个预览方块内绘制一个小方块，以便查看其旋转方向（可在环形菜单或玩家设置中调整）。
• 为保证性能，预览方块只会绘制到最大方块预览数（4096）范围内，并且仅显示在预览距离（64 个方块）以内；轮廓始终会绘制。

---

3. 能量等级与触及范围

在生存模式下，你的建造能力取决于能量等级（0 到 3）；创造模式有更高的独立限制。每个等级都会提高四项限制（默认值可在通用配置中调整）：

限制	等级 0	等级 1	等级 2	等级 3	创造模式
放置距离（方块）	0（原版触及距离）	8	16	32	200
每个轴向的最大方块数	8	16	24	32	1000
单次放置的最大方块数	128	256	512	2048	10000
最大（径向）镜像半径	16	32	48	64	200

• 放置距离：首次点击可以放置的位置距离你有多远。等级 0 时，你只能在原版触及距离内建造。第二次和第三次点击的位置可以比放置距离多出 6 个方块。
• 每个轴向的最大方块数：形状最长的一边可以有多少个方块。
• 单次放置的最大方块数：一次建造的规模（包括修改器复制的部分）；超出限制的预览会被截断。
• 最大镜像半径：镜像和径向镜像的作用范围。

按顺序使用 Reach Upgrade 1、2 和 3（第 8 节）即可提升你的力量等级；管理员也可以使用 /powerlevel（第 12 节）设置等级。此外，服务器会拒绝任何超过 Validation.maxBlocksPlacedAtOnce（10000 个方块）的单次建造，对所有人均如此。

---

4. 建造模式

点击方式

• 单击：禁用和单个。
• 两次点击：线条、墙面、地板、圆形。第 1 次点击设置起点，第 2 次点击放置。
• 三次点击：立方体、对角线、对角墙、斜坡地板、圆柱体、球体、金字塔、圆锥体、地形土丘。第 1 次点击设置起点，第 2 次点击设置一个同一高度的点（底面），第 3 次点击设置高度（沿着第二个点上方的垂直线向上或向下看），然后放置。

右键点击可放置，左键点击可破坏同样的形状。各模式共用选项（例如，所有支持填充的模式都使用同一项设置），并且重启游戏后会恢复默认值。

选项

选项	可选项	默认值	适用模式
建造速度	普通、快速	普通	单个
填充	实心、空心	实心	墙面、地板、对角墙、圆形、圆柱体、球体、金字塔、圆锥体、地形土丘
填充（立方体）	实心、空心、框架	实心	立方体
线条粗细	1、3 或 5 格厚	1	线条、对角线
抬高边缘	短边、长边	短边	斜坡地板
起点	角落、中心	角落	圆形、圆柱体、球体、圆锥体、地形土丘
自然变化	平滑、自然	自然	地形土丘
地形形状	土丘、斜坡、平地、山脉、墙面	土丘	地形土丘

起点：选择角落时，第一次点击指定形状边界框的一个角，第二次点击指定对角；选择中心时，第一次点击指定中心，第二次点击设置半径。

基础模式

• 禁用 – “禁用模组并使用原版放置规则。” 你手动放置方块时，修饰键和快速替换仍然生效。
• 单个 – “类似原版，但可增加触及距离并预览放置效果。” 在你的放置范围内，每次点击放置一个方块。建造速度：普通模式下，按住按钮时每 4 tick 放置一次；快速模式下，每 tick 放置一次。
• 直线（点击 2 次）- 沿 X、Y 或 Z 轴（与视线方向最接近的轴）建造一条直线。线条厚度设为 1、3 或 5，可形成方形横截面。
• 墙面（点击 2 次）- 沿 X 或 Z 轴建造垂直墙面。可选择填充或中空（仅建造外框）。
• 地板（点击 2 次）- 在第 1 次点击的高度建造水平矩形。可选择填充或中空（仅建造边框）。
• 立方体（点击 3 次）- 先点击地板的两个角，再设置高度。可选择填充、中空（保留六个面，内部为空）或骨架（仅保留十二条棱）。

斜向模式

• 斜向直线（点击 3 次）- 朝任意方向建造直线：从第 1 次点击的位置延伸至由第 2、3 次点击确定的点。线条厚度可设为 1、3 或 5。
• 斜向墙面（点击 3 次）- 先通过第 1、2 次点击在地面上确定一条斜线，再根据第 3 次点击的位置向上延伸。可选择填充或中空（仅建造底部和顶部的线条，以及两端的立柱）。厚度始终为 1 格。
• 斜坡地板（点击 3 次）- 建造斜坡：第 1、2 次点击确定矩形范围，第 3 次点击确定较高一侧的高度。抬高边缘：可选择沿短边或长边倾斜。

圆形模式

• 圆形（点击 2 次）- 建造平面圆形或椭圆形。可设置起点，并选择建造填充圆盘或中空圆环。
• 圆柱体（点击 3 次）- 将圆形沿高度方向延伸。可设置起点，并选择建造实心或中空圆柱。
• 球体（点击 3 次）- 先在地面上确定尺寸，再设置高度，以建造球体或椭球体。可设置起点，并选择建造填充球体或中空外壳。

屋顶模式

• 金字塔（点击 3 次）- 从矩形底面开始，逐层向上（或向下）收缩，直至达到设定高度。选择中空时，底层和顶层保持填满，中间各层仅建造边框。
• 圆锥（点击 3 次）- 从圆形底面开始逐渐收窄至顶点。可设置起点，并选择填充或中空（仅建造外表面）。

地形土丘

地形土丘（点击 3 次）- “建造自然逼真的地形。” 第 1 次点击设置中心点（或角点），第 2 次点击设置半径（至少为 1），第 3 次点击设置最大高度（不超过每个轴向的最大方块数）。

• 填充方式：填充会从底部填至表面；中空则只放置表层。

• 自然变化：自然（默认）会让表面高低起伏，更显自然；平滑则保持形状规整。此设置仅适用于高度超过 2 格的形状。每个位置的变化都是固定的，因此预览不会闪烁，最终建造效果也会与你看到的预览完全一致。

• 地形形状：

  • 土丘 – 圆润的小山。
  • 斜坡 – 斜坡在靠近你的一侧最高，并沿你的视线方向向下延伸。
  • 平顶 – 边缘不规则、呈阶梯状的平台。
  • 山峰 – 尖锐、呈阶梯状的山峰。
  • 峭壁 – 从你所在的一侧缓缓升高，并在远端陡然下落的悬崖。

  建造斜坡和峭壁时，它们会根据你的视线方向调整朝向。

---

5. 修饰键

修饰符会复制你在每种建造模式（包括单点和禁用）下放置或破坏的所有内容。

修饰符设置界面

用小键盘 +（按键修饰符菜单）或径向菜单按钮打开；再次按该键、Escape 或 « 按钮即可关闭（你的设置此时会保存到服务器，因此重新加入时会恢复）。

• 右上角的三个 + 按钮分别添加阵列、镜像或径向镜像。
• 每个修饰符面板都有一个复选框（启用/禁用）、一个垃圾桶（移除）和上下箭头（排序）。
• 你可以添加任意多个，也可以添加多个相同类型的。它们从上到下依次应用，每个都会复制其上方产生的所有内容：阵列后接镜像会镜像整个阵列。
• 数字字段：在字段上滚动鼠标滚轮（Shift 更快，Ctrl 更慢）、方向键或 +/-。

复制会计入一次放置的最大方块数，在生存模式下每个复制都会消耗其物品。

镜像

设置	默认值	说明
位置 X/Y/Z	添加时你的位置	半格步进；设为玩家位置按钮
方块角/中心	角	“将位置设为方块中心，用于奇数建造”（或角，用于偶数建造）
轴 X、Y、Z	X 开启	组合它们：X+Z 产生 4 个副本，X+Y+Z 产生 8 个
半径	10	仅镜像此距离内（一个立方体）的方块；0 到你的最大镜像半径；能力等级变化时设为最大值
显示镜像线/区域	开/开	在世界中绘制轴线与平面

被镜像的方块也会翻转，因此楼梯和其他方向性方块会朝向镜像方向。

阵列

设置	默认值	范围
偏移 X/Y/Z	0, 0, 0	任意整数（偏移 0, 0, 0 不产生效果）
数量	5	1 到 100 个副本，附加到原始内容上

面板会显示阵列长度（最大偏移 × 数量）与你每轴最大方块数的对比，例如 0/32；当阵列过长时会变红。这只是警告，副本仍会生成（一次放置的最大方块数限制仍然适用）。

径向镜像

围绕垂直轴复制方块，就像蛋糕的切片——适用于圆形塔楼、喷泉、玫瑰窗。

设置	默认值	范围/说明
位置 X/Y/Z	你的位置	与镜像相同的控件
切片数	4	3 到 1000
交替	关	每隔一个切片进行镜像而非仅旋转，用于对称图案
半径	20	仅此距离内（一个球体）的方块；0 到你的最大镜像半径
显示线/区域	开/关

复制的方块会随其切片一起旋转。

---

6. 替换模式与保护

替换模式

模式	作用
仅替换空气（默认）	普通建造：方块会放置在空气和可替换方块的位置（高草、水、雪层）。
替换方块和空气	填满整个形状，并覆盖原有内容。
仅替换方块	仅覆盖已有方块；空气仍为空气。非常适合给墙壁或地板换个样式。
按副手物品筛选	仅替换与你副手物品类型相同的方块；副手未持有物品时，仅填充空气。此模式也会筛选破坏操作：批量破坏时只会移除与副手物品类型相同的方块。

创造模式下可使用替换模式；生存模式下则只有服务器启用了生存替换功能时才能使用。

快速替换

除仅替换空气外，其他替换模式均为快速替换：点击时会选中你注视的方块，而不是它前方的空间。此功能在禁用模式下也有效：每次右键点击都会替换你注视的方块，并预览该方块。

保护方块实体

默认开启。包含数据的方块（箱子、熔炉、漏斗、木桶、告示牌等）不会被建造替换，也会在批量破坏时跳过。该开关显示在替换模式旁边；当替换模式被隐藏时（未启用生存替换的生存模式），保护仍会开启，因此请在禁用模式下挖掘这类方块。

合并

建造时，如果其中一种方块放置在同类方块上，会合并升级一级，而不是跳过，并消耗一个对应物品：半砖变为双层半砖、蜡烛数量增加一支、海泡菜增加一株、海龟蛋增加一枚、雪层增加一层，或粉红色花瓣增加一片（蜡烛自 Minecraft 1.17 起加入，粉红色花瓣自 1.20 起加入）。其他带状态的方块（农作物、堆肥桶、重生锚）不会因在其上建造而升级。

---

7. 生存模式规则

生存模式中一切都需要付出代价，且服务器会检查所有操作。无法建造的玩家（例如处于冒险模式的玩家）不能使用此模组；服务器也可以在生存模式中禁用此功能，或将其限制为白名单玩家（见第 11 节）。

会使用哪些物品

• 每个方块都需要消耗对应物品。无法支付物品的方块会被标记并跳过；其余方块照常放置。
• 需要多个物品的方块会消耗全部所需物品：双层半砖需要两块半砖，三支蜡烛需要三支蜡烛；合并时只消耗新增的那件物品。
• 消耗顺序：先使用你的背包（若启用了建筑升级，则最多使用到对应等级），再使用手中的物品堆，最后使用物品栏中的其他物品。
• 带有数据的物品会保留数据：带名称的方块、装满物品的潜影盒或锦致装饰的袋子，会从对应的物品堆中放置，并保留其名称和内容物（依次检查主手、副手和物品栏）。
• 放置失败不会消耗物品：如果服务器未能放置方块（例如保护模组在 NeoForge 或 Forge 上取消了放置操作、下界中的水生植物，或该方块已存在），你会保留该物品。
• 启用建筑升级且背包中有相同方块时，手中最后一个方块会保留，因此只要背包里还有方块，手上就不会空掉。

批量破坏

默认开启（SurvivalBreaking.enabled）。

• 工具选择：主手、快捷栏其余槽位、物品栏、副手，然后是启用了工具切换器或高级工具切换器的背包中的工具。每个方块使用第一个有效工具（镐、斧、锹、锄、剪刀）。需要正确工具才能掉落的方块（石头、矿石）只接受正确的工具。
• 瞬间破坏的方块（花、火把、草）不需要工具。没有有效工具且不需要工具的方块可以用主手中的工具破坏；如果完全没有工具，这类方块会被跳过（不能空手批量挖掘）。
• 不可破坏的方块始终会被跳过。工具永不损坏：剩余 1 次使用次数的工具不会被使用。
• 耐久、掉落、饥饿：每个方块消耗一次使用次数（耐久、时运和精准采集与原版一致），掉落物直接进入你的物品栏，每个方块消耗 0.005 饥饿值，与原版挖掘相同。
• 受保护的方块会被跳过：出生点保护（管理员除外）、世界边界、冒险模式规则，以及在 NeoForge 和 Forge 上会取消破坏事件的保护模组。
• 挖掘延迟：模组会累加每个方块及其工具的 vanilla 挖掘时间并等待该时长，默认最多 2 秒（maxDelayTicks = 40）。倒计时会显示“Breaking N blocks in X s”并带有进度条。在你点击之前，HUD 会显示将要使用的工具（各带数量）、一个带有无法破坏方块数量的屏障图标，以及预计时间（~X s）。
• 如果什么都无法破坏：“No suitable tool for the selected blocks (switch to Disable mode for vanilla mining)”；如果部分被跳过：“N Block(s) skipped: no suitable tool”。

在创造模式下，批量破坏是瞬间完成的，不需要工具，也不产生掉落物。

生存替换

默认关闭（SurvivalReplace.enabled）。开启后，替换模式和快速替换可在生存模式下使用：路径上的每个方块都会按照上述规则被挖掘（工具、耐久、掉落物进入你的物品栏、饥饿、跳过、延迟显示为“Replacing N blocks in X s”），然后放置新方块并支付费用。会先检查物品；如果没有物品或工具，该位置不会挖掘或扣费。

撤销与重做

Ctrl+Z / Ctrl+Y（或径向菜单按钮）。服务器会为每位玩家保留最近 50 个操作（Memory.undoStackSize，10 到 200），并有一个单独的重做列表。当你退出登录或切换维度时，这些列表会被清空，且不会在服务器重启后保留。撤销和重做会立即执行（无延迟）。

在生存模式下，它们遵循与建造和破坏相同的规则：

• 撤销建造会用你的工具挖掘已放置的方块，并给予你它们的掉落物（用普通镐挖掘放置的石头会得到圆石）。你无法挖掘的方块会保留。
• 撤销破坏会把方块放回，并消耗它们的物品（多物品方块的所有物品）。
• 撤销合并会直接从方块上取下所添加的物品而不进行挖掘，并将其返还。
• 撤销替换会挖掘新方块并恢复旧方块（需要生存替换和旧方块的物品）。
• 重做在相反方向上以相同方式工作。
• 失败的条目会保留在列表中，并在下次优先重试；如果完全没有任何操作成功，你会看到“Nothing could be undone (missing items or blocks you can’t mine)”。已经恢复为旧状态的方块视为已撤销。

在创造模式下，撤销和重做是瞬间且免费的。

---

8. 物品与配方

随机化袋子

将方块作为模板放入袋中；使用袋子建造时，会在每个位置放置模板中的随机方块。方块本身取自你的物品栏（以及带有建造升级的背包），而非取自袋子，并且只会选取你实际拥有的模板（创造模式下则选取全部）。

• 潜行 + 右键打开袋子。每个槽位存放一个物品，每种方块类型只能放入一次。
• 在禁用模式下右键放置一个随机方块。在建造模式下，像拿方块一样手持袋子：形状中的每个方块都是随机选取（预览会显示选取结果）。
• 当所有模板都已用完时：“物品栏中缺少随机袋所需的方块！”
• 重命名后的袋子会在袋子窗口中显示自己的名称。

袋子	槽位	配方
精妙皮革随机袋	5	任意木板放在中心，皮革放在上、下、左、右
精妙金质随机袋	9	皮革放在中心，金锭放在两侧，石英放在四角
精妙钻石随机袋	27	皮革放在中心，钻石放在两侧，紫水晶碎片放在四角
欧米伽随机袋	54	皮革放在中心，下界合金锭放在两侧，紫水晶碎片放在四角

在 Minecraft 1.16.x 上（没有紫水晶），钻石袋和欧米伽袋使用海晶石晶体代替紫水晶碎片。

欧米伽权重：在欧米伽袋中，将鼠标滚轮滚动到某个槽位上可更改其权重（1、2、3、4、5、7、10、15、20、30、40、50、65、80、90；默认 1）。每个权重都会显示一个徽章；指向某个槽位会显示权重以及以百分比表示的概率。重置会将所有权重恢复为 1。权重存储在袋子上。

触及升级

右键消耗。每个升级会将你的能量等级提升一级（第 3 节），并且必须按顺序使用。

物品	需要能量等级	给予	配方
触及升级 1	0	等级 1	4 个黏液球围绕一个末影珍珠（十字形）
触及升级 2	1	等级 2	4 个烈焰粉围绕一个末影珍珠（十字形）
触及升级 3	2	等级 3	末影水晶放在中心，紫颂果放在两侧，恶魂之泪放在四角

不按顺序使用会提示“请先使用触及升级 N。”；使用已经拥有的升级会提示“已经使用过此升级！”。你的能量等级在死亡后仍会保留。

压缩方块

建造升级的制作材料：3×3 摆放 9 个方块可得到 1 个压缩方块，1 个压缩方块可反向合成 9 个。

物品	由……制成
压缩泥土	9 个泥土
压缩圆石	9 个圆石
压缩沙子	9 个沙子
压缩深板岩圆石	9 个深板岩圆石（Minecraft 1.16.x 上为 9 个黑石）

建造升级

用于精妙背包的背包升级（第 9 节）。每一级都由上一级制作而成：

物品	每次建造可从背包取用的方块数	合成配方
建造升级 1 级	32	在 Sophisticated Backpacks 升级基座周围放置 8 个压缩泥土
建造升级 2 级	64	在 1 级升级周围放置 8 个压缩圆石
建造升级 3 级	128	在 2 级升级周围放置 8 个压缩沙子
建造升级 4 级	256	在 3 级升级周围放置 8 个压缩深板岩圆石
欧米伽建造升级	2048	7 个下界合金块、中心放置 4 级升级、底部中央放置 1 个下界之星

只有安装 Sophisticated Backpacks 后才会出现这些配方。

---

9. Sophisticated Backpacks 联动

建造升级

将建造升级放入背包的升级槽。升级启用时，建造会优先从该背包取用方块，然后才从你的物品栏取用。升级等级决定每次建造最多可从背包取用多少方块：32、64、128、256 或 2048（欧米伽）。它不会提高你的能力等级限制（范围、每轴方块数、一次放置的方块数）；这些限制仍然有效。超过该等级上限的部分会从你的物品栏取用。

• 每个背包只能装一个（“每个背包只能安装一个建造升级”）；你可以直接替换为其他等级的升级。
• 多个背包：你携带的所有装有已启用升级的背包都会提供方块；可取用数量上限由其中等级最高的升级决定。
• 计入范围的背包：主物品栏、副手、胸部槽位，以及装备在 Curios（Forge、NeoForge）、Trinkets 或 Accessories 槽位中的背包；具体取决于 Sophisticated Backpacks 本身对这些槽位的支持情况。
• 匹配规则：背包中的方块堆必须与用于建造的方块属于同一种物品且数据相同。
• 设置选项卡：升级会在背包界面中提供一个选项卡，内含启用 / 禁用按钮和“N 级 – 最多 M 个方块”提示。禁用升级后将不会提供方块。
• HUD：屏幕上的方块数量会包含背包中的方块（见第 10 节）。
• 工具提示：“可从背包物品栏一次放置最多 N 个方块”。

工具切换器

在生存模式下批量破坏方块时，也会使用装有已启用的工具切换器或高级工具切换器升级的背包中的工具（且不能设为“禁用切换”）。高级工具切换器的筛选条件同样有效。耐久度从背包中的工具扣除。

支持联动的加载器和版本

加载器	支持联动的 Minecraft 版本
NeoForge	所有 NeoForge 版本：1.20.4、1.21/1.21.1、1.21.4、1.21.5、1.21.8、1.21.10、1.21.11、26.1/26.1.1、26.1.2、26.2；以及通过 Forge jar 支持的 1.20.1
Forge	1.16.3、1.16.4、1.16.5、1.17.1、1.18、1.18.1、1.18.2、1.19/1.19.1、1.19.2、1.20.1
Fabric（Sophisticated Backpacks 的非官方 Fabric 移植版）	1.19.2、1.19.4（测试版构建）、1.20.1、1.20.4、1.21.1

其他情况下（例如 Fabric 1.21.4 或 Forge 1.20.4 及更新版本），该加载器没有 Sophisticated Backpacks 版本，因此此模组将以独立模式运行。

未安装 Sophisticated Backpacks 时

其他一切功能都正常。五种建筑升级物品仍然存在（因此世界和物品列表保持完整），但它们只是没有配方、也没有任何效果的占位物品。不会读取背包中的物品，批量破坏也只会使用你自己的工具。

---

10. 玩家设置与 HUD

玩家设置界面

点击径向菜单左上角的按钮，或按下 打开玩家设置 键（默认未绑定）即可打开。开关为开/关按钮，数字选项为滑块（按方向键可逐步调整）。更改会立即生效；点击 完成 或按 Escape 可将设置保存到客户端配置中；点击 恢复默认设置 可还原所有数值。每项设置都有工具提示。

设置	默认值	范围	功能
视觉效果
方块预览	开		建造时显示方块的幽灵预览。
仅在建造时显示预览	开		仅在使用建造模式时显示预览。
迷你方块预览	开		在每个预览中显示一个小方块，以展示其旋转方向（与径向菜单中的开关相同）。
方块预览数量上限	4096 个方块	0 – 100000（0 = 仅显示轮廓）	超过此数量时，仅绘制轮廓。
出现动画	5 刻	0 – 100（0 = 关闭）	放置的方块出现所需的时间。
破坏动画	10 刻	0 – 100（0 = 关闭）	破坏动画的持续时间。
预览缩放	25%	5% – 100%	幽灵方块的大小。
性能
预览距离	64 个方块	16 – 256	超过此距离后不再显示单个预览。
更新节流	开		静止不动时跳过预览计算。
迷你预览数量上限	4096 个方块	0 – 100000（0 = 不限）	迷你方块预览的最大数量。

HUD

• 建造时：轮廓和幽灵方块；快捷栏上方显示 N blocks (W x D x H)；提示文字为 左键取消，右键放置（或 左键破坏，右键取消）；左侧边缘显示所需方块列表（5x Stone）。
• 准星旁（放置时）：建造所需的方块及其数量；缺少的方块数量以红色显示。在创造模式中，仅当建造需要多种方块时显示。
• 准星旁（生存模式破坏时）：将使用的工具及各自能破坏的方块数量、无法破坏的方块数量及其屏障图标，以及预计耗时 ~X s。
• 准星下方：破坏倒计时 “Breaking N blocks in X s” / “Replacing N blocks in X s”，并显示红色进度条。
• 右下角（生存模式）：显示你背包和背包容器中手持方块（或手持随机袋中每种模板方块）的数量，并以 11.2k 这样的形式缩写。
• 径向菜单右下角：显示你的力量等级；将指针移到等级上，可查看当前及下一级的所有限制。

---

11. 配置

共有三个配置文件。下方列出了每个选项的默认值和允许范围。

文件	Fabric	NeoForge / Forge	范围
客户端	config/sophisticatedbuilding-client.json	config/sophisticatedbuilding-client.toml	你自己的预览（也可在玩家设置界面中编辑）
通用	config/sophisticatedbuilding-common.json	config/sophisticatedbuilding-common.toml	能力等级上限
服务器	config/sophisticatedbuilding-server.json	<world>/serverconfig/sophisticatedbuilding-server.toml	服务器强制执行的规则；玩家加入时发送给客户端

• Fabric：损坏或过时的文件会自动修正（添加缺失的键、限制超出范围的值、移除未知的键）；旧文件会保留为 <name>.json.bak（之后依次为 -1、-2、……）。无效的 JSON 文件会保持原样，并使用默认设置。
• NeoForge：可在模组列表中打开配置界面（1.20.4 中除外）。Forge：没有配置界面；请编辑文件。
• 通用配置会在客户端和服务器两端读取；请确保客户端和服务器上的副本一致。

服务器配置

选项	默认值	范围	含义
Validation.allowInSurvival	true		是否允许在生存模式中使用此模组。若为 false，则只有创造模式玩家可以使用。
Validation.useWhitelist	false		只有白名单中的玩家才能使用此模组。
Validation.whitelist	["Player1", "Player2"]		白名单中的玩家名称（不会发送给客户端）。
Validation.maxBlocksPlacedAtOnce	10000	1 – 100000	服务器最终检查：超过此数量的建造会被拒绝。
Memory.undoStackSize	50	10 – 200	每位玩家可撤销（和重做）的步数。需要重启世界。
SurvivalBreaking.enabled	true		允许在生存模式中批量破坏方块。
SurvivalBreaking.stopBeforeToolBreaks	true		工具仅剩 1 次耐久时，不会继续使用。
SurvivalBreaking.maxDelayTicks	40	0 – 1200	一次生存模式破坏或替换操作的最长挖掘延迟（20 刻 = 1 秒）。
SurvivalBreaking.exhaustionPerBlock	0.005	0.0 – 1.0	每破坏一个方块增加的饥饿消耗。
SurvivalReplace.enabled	false		允许在生存模式中使用替换模式和快速替换（挡路的方块会按生存模式破坏规则挖掉）。

通用配置（能力等级上限）

选项	创造模式	等级 0	等级 1	等级 2	等级 3	范围
Reach	200	0	8	16	32	0 – 1000
MaxBlocksPlacedAtOnce	10000	128	256	512	2048	0 – 100000
MaxBlocksPerAxis	1000	8	16	24	32	0 – 1000
MaxMirrorRadius	200	16	32	48	64	0 – 1000

如果一次放置方块数量或每轴方块数量的等级 0 上限设为 0，则在提升能力等级之前，建造模式将无法使用。

客户端配置

上述十项玩家设置：Visuals.showBlockPreviews、onlyShowBlockPreviewsWhenBuilding、showMiniBlockPreview、maxBlockPreviews、appearAnimationLength、breakAnimationLength、previewScale，以及 Performance.previewRenderDistance、enableUpdateThrottling、maxMiniBlockPreviews。

---

12. 控制与命令

所有按键均位于“选项 > 控制”中，分类为 Sophisticated Building。

按键	默认值	操作
径向菜单	左 Alt（按住）	选择建造模式、选项和操作
修饰键菜单	小键盘 +	打开或关闭修饰键设置
撤销	Ctrl + Z	撤销上一次建造或破坏
重做	Ctrl + Y	重做
激活上一个建造模式	未绑定	切换回上一个建造模式
切换 禁用 <> 上一个建造模式	未绑定	在“禁用”和你上一个建造模式之间切换
打开玩家设置	未绑定	打开玩家设置界面

鼠标：右键放置/设置点，左键破坏/取消放置，潜行 + 右键随机化袋子可打开它，鼠标滚轮悬停在 Omega 袋子槽位上可更改其权重。

命令（管理员权限等级 2）：

• /powerlevel query – 显示你的能量等级。/powerlevel query <player> – 显示某位玩家的能量等级。
• /powerlevel set <player> <0-3> – 设置某位玩家的能量等级。

---

13. 支持的版本与兼容性

每个 Minecraft 版本和加载器对应一个 jar；文件名中同时标明两者：sophisticatedbuilding-<loader>-<minecraft>-5.0.0.jar。请将其安装在客户端和服务端上。

Minecraft	Fabric	NeoForge	Forge	背包集成	Java
26.2	是	是	是	NeoForge	25
26.1.2	是（适用于 26.1 – 26.1.2 的 jar）	是	是（适用于 26.1 – 26.1.2 的 jar）	NeoForge	25
26.1, 26.1.1	26.1.2 的 jar	单独的 jar（NeoForge beta builds）	26.1.2 的 jar	NeoForge	25
1.21.11, 1.21.10, 1.21.8, 1.21.5, 1.21.4	是	是	是	NeoForge	21
1.21.1	是（适用于 1.21 – 1.21.1 的 jar）	是（适用于 1.21 – 1.21.1 的 jar）	是	Fabric、NeoForge	21
1.21	1.21.1 的 jar	1.21.1 的 jar	单独的 jar	NeoForge	21
1.20.4	是	是	是	Fabric、NeoForge	17
1.20.1	是	Forge 的 jar	是	Fabric、Forge、NeoForge	17
1.19.4	是	–	是	Fabric（beta 移植版）	17
1.19.2	是（适用于 1.19 – 1.19.2 的 jar）	–	是	Fabric、Forge	17
1.19, 1.19.1	1.19.2 的 jar	–	两者各有单独的 jar	Forge	17
1.18.2	是	–	是	Forge	17
1.18.1, 1.18	两者共用一个 jar	–	各自使用单独的 jar	Forge	17
1.17.1	是	–	是	Forge	16
1.16.5, 1.16.4	两者共用一个 jar	–	各自使用单独的 jar	Forge	8
1.16.3	是	–	是	Forge	8

Fabric 需要 Fabric API。最低加载器版本见各文件的详细信息；如果加载时使用了较旧版本的 Sophisticated Backpacks/Core，jar 会拒绝加载，并显示指出所需版本的提示。

版本说明

• NeoForge 26.1 / 26.1.1： NeoForge 只发布了 beta 版本；neoforge-26.1 jar 需要 26.1.0.19-beta 或更新版本。搭配精妙背包时请使用 Backpacks 26.1-3.25.48 与 Core 26.1-1.4.26：Core 1.4.27 需要 NeoForge 26.1.2，并且在 beta 版本中打开背包时会崩溃，因此该 jar 会拒绝它。
• NeoForge 上的 Minecraft 1.20.1： 使用 Forge jar（已在 NeoForge 1.20.1-47.1.106 上测试）。
• Forge 1.16.3 和 1.16.4 服务器： Forge 34 和 35 无法在 Java 8u321 或更新版本上启动（无论是否安装此模组）；专用服务器请使用较旧的 Java 8。Minecraft 启动器自带的 Java 8 没有问题。
• Minecraft 1.16.3（Forge）： 适用于 1.16.3 的精妙背包版本没有工具切换器，也没有升级槽检查（一个背包可以容纳多个建筑升级；它只计一次，使用其已启用的最高等级）。
• Minecraft 1.16.x – 1.18.x（Forge）： 每个背包只能有一个建筑升级，这由升级本身强制执行；在 1.18.x 上，请取出已安装的升级来更改等级。
• Minecraft 1.19.4（Fabric）： 精妙背包的 Fabric 移植版只有适用于 1.19.4 的 beta 版本（已使用 Backpacks 3.19.5 build 105 和 Core 0.5.109 测试）。
• Minecraft 1.21（Fabric）： Fabric 移植版没有 1.21 版本；该集成在 1.21.1 上可用。
• 1.16.x 上的配方： 没有深板岩或紫水晶，因此压缩深板岩圆石使用黑石，钻石包和欧米伽包使用海晶石水晶。
• 按键分类： 自 Minecraft 1.21.9 起，按键分类 id 为 key.category.sophisticatedbuilding.main（自定义语言包需要新的键；你的按键绑定会保留）。

其他模组

• 保护和领地模组： 在 NeoForge 和 Forge 上，模组放置或破坏的每个方块都会触发正常的放置和破坏事件，因此领地和保护模组可以拒绝它们（被拒绝的方块不会被扣除）。在 Fabric 上没有这样的标准事件；出生点保护、世界边界和冒险模式规则始终会被遵守。
• 存储方块（潜影盒、锦致装饰的袋子等）在被建筑放置时保留其内容和名称。
• 手持时使用右键的物品（例如扳手）不会被阻止：模组只在你手持方块物品时接管放置。
• 该模组不需要机械动力、Flywheel 或 Ponder；预览渲染是内置的。

已知问题

• Fabric： 你的能量等级和修饰符设置只在服务器（或你的单人游戏）运行时保留；重启后它们会从等级 0 和空修饰符列表开始。NeoForge 和 Forge 会随玩家保存它们。
• Forge： 使用 --quickPlaySingleplayer 直接加载单人世界可能会崩溃，并显示“Can not retrieve LootModifierManager until resources have loaded once”——这是 Forge 的 bug，即使没有此模组也会发生。
• Fabric： 非官方的精妙背包 Fabric 移植版在启动时会记录一个无害的 No data fixer registered for 错误。

---

14. 常见问题与故障排除

方块没有从我的背包中取出。 请检查背包是否有建筑升级、其标签页中是否已启用、背包中的方块是否与你建造时使用的方块是完全相同的物品且数据相同，以及精妙背包是否有适用于你的加载器和版本（第 9 节）。记住等级限制：1 级升级每次建造最多提供 32 个方块。

预览不显示。请确保你处于某种建造模式（而不是“禁用”），并手持方块或随机袋。检查玩家设置中的方块预览选项。大型建造超过最大方块预览数后只显示轮廓，超出预览距离的内容则不会显示。在生存模式下，力量等级为 0 时，你的可达距离与原版相同，请瞄准附近的方块。

径向菜单提示建造模式已禁用。你的力量等级允许放置 0 个方块（服务器设置）。请使用触及距离升级，或联系管理员。

批量破坏没有效果或会跳过方块。你需要一把有效工具（放在物品栏中，或放在工具切换背包中）；剩余 1 次耐久的工具不会使用；受保护、无法破坏以及带有方块实体的方块会被跳过；服务器可能已禁用生存模式下的破坏功能。正常采矿时请使用“禁用”模式。

我无法在生存模式下替换方块。生存模式替换默认关闭。请让服务器所有者将 SurvivalReplace.enabled = true 设为启用。

撤销后没有拿回石头，而是得到了圆石。在生存模式下，撤销会像正常采矿一样挖掉方块，因此你会获得它们正常掉落的物品。

我的配置被重置了 / 出现了一个 .bak 文件。在 Fabric 上，如果配置文件中有错误值或未知键，系统会自动修正配置，并将旧版本保存为 sophisticatedbuilding-<name>.json.bak。对比这两个文件，并将你的值复制回有效范围内。

提交错误报告时应该附上什么？Minecraft 版本、加载器及其版本、Sophisticated Building 的 jar 文件名、已安装时的 Sophisticated Backpacks/Core 版本、logs/latest.log（如果游戏崩溃，还请附上 crash-reports/ 中的崩溃报告），以及复现问题的步骤。请在 https://github.com/navrelis/EffortlessBuildingSophisticated/issues 提交问题。

---

15. 前置与依赖

• 必需：Fabric 上需要 Fabric API。NeoForge 或 Forge 上无需其他依赖。
• 可选：安装 Sophisticated Core 后，可搭配 Sophisticated Backpacks 使用建造升级和工具切换功能；Fabric 上则使用非官方 Fabric 移植版。穿戴背包可使用 Curios、Trinkets 或 Accessories，具体取决于 Sophisticated Backpacks 的支持情况。

---

16. 致谢与归属

Sophisticated Building 基于 Requios 开发的 Effortless Building（CurseForge 项目 ID：302113）制作；原作者创作了原始模组，以及建造模式和修饰器的概念。原页面：
https://www.curseforge.com/minecraft/mc-mods/effortless-building

此分支由 Navrelis 维护，并采用 LGPL-3.0-only 许可。源代码：
https://github.com/navrelis/EffortlessBuildingSophisticated