# 框选与建筑模块 框选工具把已有建筑的一部分变成可重复使用的模块。适合重复的墙段、窗框、立柱、屋檐与装饰组合；模块保留每个方块自己的材质和方向，无需逐格重画。 ## 选取一段建筑 按 **S** 切换框选。在当前 Y 平面从一个角拖到对角，框定 X、Z 底面；使用框选面板的最低 Y、最高 Y 限制竖向范围。高度范围包含两端，允许选取 Y = −2 的地下部分。初次进入框选时，默认范围从当前层到其上方 7 格。 在框选工具中按 **Ctrl A** 可选中当前建筑的全部方块，框和 Y 范围自动匹配建筑包围盒；在输入框中按 Ctrl A 仍只选中输入文字。 选区显示包围框尺寸与实际命中的方块数。它只捕获框内已有方块，空气不成为可粘贴的方块，但框内的空白边距会保留。旋转或镜像时也使用完整框尺寸，因此带留白的窗框、门洞和墙段可以保持原本的对齐间距。 镜头可继续用中键环绕观察。框选始终按世界 X、Y、Z 坐标计算；剖层只改变可见范围，不会排除高度范围内被隐藏的方块。 ## 移动与精确位移 选中模块后点 **整体移动**，再在画布选择目标位置。指针对应选区的 **X、Z 最小角**，竖向保持选区原来的最低 Y；预览先显示最终结果，确认放置后一次完成。需要升降时使用精确位移。 也可在面板输入 **ΔX、ΔY、ΔZ**，按世界轴精确平移。例如 ΔX = 4 表示向 X 正方向移动 4 格，ΔY = −1 表示下降 1 格。使用位移移动时保留模块原有朝向。 移动允许与原选区重叠。提交前先从结果副本移除源方块，再计算目标，因此沿墙体平移一格不会把源与目标相互覆盖。预览取消或放置失败时，源建筑保持原位。 ## 复制、粘贴与连续盖章 **Ctrl C** 复制选区；**Ctrl V** 或 **粘贴** 按钮进入单次粘贴预览。点击目标最小角放置后结束。粘贴和盖章均以当前建造层作为模块最低 Y。 点 **连续盖章** 可反复选择位置，盖出相同模块；按 Esc 或再点一次连续盖章结束。每次盖章各占一次撤销记录，便于逐个调整重复的窗户或柱子。 剪贴板保存复制时的模块快照，后续修改源建筑不会改动已复制的内容。它属于当前页面会话，不会写入系统剪贴板，也不会保存在项目 JSON 中；重新打开页面后需要重新复制。 粘贴只写入模块中已有方块，模块的空气和空洞不会清空目标建筑。需要空出窗洞时，可先擦除目标区域，再盖上窗框。 ## 旋转与镜像 水平旋转每次 **90°**，绕 Y 轴旋转；镜像可沿世界 **X** 或 **Z** 方向翻转。旋转或镜像选区时使用其最小角作为对齐基准。矩形模块旋转后 X、Z 尺寸交换，Y 尺寸保持不变。 尚未进入放置预览时，旋转与镜像直接作用于当前选区，整体提交且可一次撤销。正在移动、粘贴或盖章时，它们只改变待放置模块，源建筑要等确认移动后才更新。粘贴和盖章预览中的变换也更新剪贴板方向，方便后续继续使用该方向。 所有支持水平朝向的方块随旋转和镜像更新 facing，包括楼梯、16 色带釉陶瓦、雕刻南瓜与南瓜灯；后面三类共 **18 种整块材质**。原木等柱状方块的 X / Z 轴向随 90° 旋转交换。楼梯的上下半部、台阶的 bottom / top / double 保持原值；当前工具不提供上下翻转或任意角度旋转。 ## 冲突、取消与撤销 放置方式有 **覆盖已有方块** 和 **仅空位**。仅空位模式发现任一目标格已占用时，整次放置拒绝；不会只粘贴一部分。移动时已移除的源格不算冲突。 有效编辑范围为 **X、Z 各 0–23，Y 为 −2 至 32**，建筑总量上限为 **16,384 格**。整个模块选框都必须在编辑边界内，包括框中空白边距；任一角越界，或结果超过上限，整次拒绝并保留源建筑。框选变换不使用普通填充工具的边缘裁切行为。 **Esc** 取消尚未确认的框选手势、移动或粘贴预览；框选工具中点鼠标右键也可取消。清除选区是单独操作；取消预览不等于擦除源建筑。切换工具、材质、层或视角也会终止正在进行的手势，不会留下半次移动。 每次移动、旋转、镜像或盖章只生成一次撤销记录。复制、框选、预览、取消，以及没有改变任何方块的操作均不增加记录。撤销、重做、新建、载入示例或打开项目会清除当前选区，避免旧坐标继续作用于另一份建筑；用其他工具实际编辑建筑也会清除选区。剪贴板中的副本仍可用于后续粘贴。 复制、粘贴和工具快捷键仅在画布或普通工具界面中生效；输入框、下拉框和打开的对话框保留原有键盘行为。未打开对话框时，Esc 即使在参数框中也可取消当前预览。 项目与蓝图导出保存提交后的方块及其属性，选框、预览和剪贴板不会写入 `.schem`。其他快速工具见 [QUICK-BUILD.md](QUICK-BUILD.md)，蓝图格式与游戏内验收见 [EXPORT.md](EXPORT.md)。