GTMB · 玩法指南

结构预览、等级信道与仓室规划

Structure Preview and Hatch Planning

安装环境：GTNH 2.9.0 · GTMB 0.3.8

本页资料：GTMB 0.3.7 · 与当前下载版本的差异尚待核对

介绍与使用

对机器控制器右键导入结构后，把工作台当作搭建前的规划桌：查看形状、检查每层、选定线圈或仓室，再让材料清单告诉你还差什么。

先看目标与现场差在哪里

目标展示计划结构，现场展示实际方块，差分突出需要改变的位置。拖动可旋转预览，滚轮缩放；W/S 沿水平视角前后移动摄像机，A/D 左右移动。两页预览均可使用 WASD，文字输入框聚焦时正常输入；弹窗、改绑、框选、移动轴拖动及 Ctrl/Alt 操作时暂停相机移动。复位视角清除平移，相机移动不改变蓝图或世界坐标。选择单层能看内部布局，切换层只影响观察，不会自动改变施工范围。

状态颜色	含义
绿色	当前位置已经满足目标
蓝色	等待补齐
红色	所需材料不足
金色	位置受保护
紫色	当前数据或设备不支持此操作

候选材料来自机器实际的 StructureLib / GregTech 结构声明。改变等级 / 信道设置后，候选按声明家族刷新；已选择的家族会保留，无效选项会明确标注。自定义子信道使用名称和正整数值，其意义由目标机器解释。

玩法速查

用仓室预设建立初稿，再手动微调

仓室预设按选定电压级和已识别的结构配额分配位置，生成后施工范围同步为全结构，并保留已有合法仓室与手选目标。开启降级时，按类型使用不高于目标等级的最高有料档位；关闭时保持目标等级。材料不足也会保留目标并显示缺口。

自动规划共享材料预留数量，同一枚物品不会被重复算给多个位置。材料页还可显示控制器自身库存，但该库存受访问权限限制，只读展示，不会成为取料来源。

手动指定合法 ItemBlock、GT 机器或线圈，可按自己的管线布局安排位置。预设无法完整理解的自定义定义会给出原因；额外的外壳最低数量和成型条件仍由原机器检查。

玩法速查

朝向与原位升级

新仓室优先朝向可证明的外部空气，并遵循仓室与结构允许的方向。按 R 或六面转向按北、东、南、西、上、下轮询，跳过不合法方向。

补建只填空位，会保留已有仓室的方向。需要改已有仓室的朝向或升级部件时，使用替换模式。对同一仓室仅改方向时无需拆除和扣材料；涉及更换设备则先核对材料与回收结果。替换必须绑定真实控制器，并确认原结构已完整构建。

校准可读取已识别的现场等级和线圈家族，保留仓室布局与朝向。混合材质不会被猜成统一档位；无法可靠反推的尺寸和自定义信道会保留当前值并给出提示。诸神之锻炉环数读取原机器数据。

进度与等待

采集或区域发现期间可查看当前阶段的进度。能确定范围时显示已处理量与总量；结构声明尚未遍历完、总量未知时显示等待时长，不把已发现格数当作整张结构总数。最终完整结果到达后，再继续编辑或施工。

玩法速查

自定义整套搭配与快捷复用

控制器结构页的仓室预设与确认构建高亮用于引导；不选择预设也可确认构建。仓室页可切换基础预设与自定义搭配，命名保存、覆盖或删除自己的整套搭配。整套记录仓室角色、物品身份、metadata、定义 NBT 与数量，不记录世界坐标或现场库存。手选目标和现场设备保持固定；位置、声明候选或已声明的配额冲突时整套拒绝，原规划保留。规划会少占用壳体位置；超出计算预算也会明确失败，不应用半套。应用预设不自动扣料或施工。

仓室与材料来源分别提供使用上次预设，只记住上次被服务器真实接受的本类配置；两项相互独立，失败或迟到快照不覆盖成功记录。命名仓室搭配与这两项记忆保存在本机 config/gtmb-hologram-presets.nbt，不同于蓝图库、作者处理流程预设与服务端剪切日志。

所选格提示与默认规划

选中方块后可直接点所选格提示词，核对作用范围后保存；全局、所选格与区域提示分别编辑。重置为默认先要求确认，清除自定义目标并恢复结构默认规划；已成型结构提供校准为当前。两者只更新规划，不自动施工，也不删除已保存预设。

玩法速查

恢复已捕获的 GT 原件

蓝图中已捕获的原生 GT 设备按原件的物品类型、机器型号与实际方块身份核对。原件身份完全匹配且原生可放置时，编辑候选列表遗漏不会把它当作非法替换。另选替换目标仍须符合当前候选规则；资源、权限、现场与原生放置检查继续生效，机器是否成型由原机器检查。

区域导入按原生结构声明与实际现场核对尺寸和材料信道，完成后查看所选结构识别到的参数。已有蓝图也须核对真实尺寸和信道；文件中的默认参数不代表现场原尺寸。对提供可重建原生声明的蓝图成员，调整主信道或子信道会重新生成所选结构的范围。等待更新完成，再核对材料、作者处理与保存结果；其他结构、共享格和明确编辑保留。来源声明不可用或重建失败时查看具体提示，原蓝图保留。

旧蓝图若只记录了结构底段的归属，首次调整尺寸前会先核实保存内容中的完整原范围。只有能唯一匹配原生声明的完整范围才参与新旧范围更新；其他结构、共享格、明确编辑和无法安全确认的数据保留。无法唯一核实时保留原图并提示重新从完整原结构导入。等待恢复与更新完成，再检查缩小后的上层、封顶材料和保存结果。

线圈、分级外壳、框架与玻璃普通点击只选当前格。选中后，仍可扩选的同结构同族格以紫色边框提示，全选 T持续显示；按 T 或按住 T 点击明确选择本结构的完整等级族。已改成仓室的格子保留其设备身份，不随外壳族扩选。普通同种选择继续按精确方块和机器型号核对。

工作区顶部的文字转蓝图可在空白工作区、结构编辑和放置前的蓝图编辑中生成 LittleTiles 文本。可选游戏资源包字体、Miao Wiki Pixel、Fusion Pixel 和 DejaVu 字体，切换字体保留其余草稿设置。竖向排列让每个字保持直立、一字一行；弧形以整行或整列的中点对称展开，弯曲与扭转沿同一中心方向计算。可调整尺寸、厚度、加粗、下划线、旋转、环形、弯曲与扭转。空工作区确认内容后直接生成；非空工作区先按炫彩请选择文字位置提示点击可见面或空白平面选位，位置随当前视角计算。选位时 R 整体旋转、Alt + R 竖转，小键盘和位移手柄微调，确认放置时由服务器核对冲突；冲突保留原文字与预览供移动重试。文字整体选中、编辑及旋转。基础材质与瓷砖染色分别设置，背包以标准槽位选材，RGB/HSV 调色器、色板与十六进制值同步体现在字形和放置预览。相邻微体素自动合并为三维长方体，不填平字形孔洞；未额外染色、填满整格且有等价普通实心立方体的材质直接保存为完整方块，其他情况保留小瓷砖，材料按实际体积核算。文本定义随蓝图保存；世界中的实体是普通方块或小瓷砖，重新从世界框选不会恢复文字编辑身份。

蓝图、结构、文字与图片共用彩色位移手柄：拖动轴线约束一个轴，拖动 XY / XZ / YZ 小面可在对应平面自由平移。拖动仅更新本地虚化预览，确认后仍校验目标空位。蓝图编辑选择内容后可按 Delete 删除并撤销或重做；文字和图片保持整体选择，普通结构成员可单格删除；控制器结构模式的 Delete 继续恢复原结构预设外壳。编辑不会直接改动世界。

用图片生成小瓷砖像素画

工作区顶部的添加图片从当前客户端 .minecraft/MiaoBlueprintPicture 自动读取 PNG、JPEG、BMP 或 GIF 首帧；新增文件后点刷新图片。默认每像素为 1/16 格、厚度 1/16 格，短边为 64 像素；原图只提供纵横比，不直接决定成品大小。保持纵横比时按短边联动长边，取消后可分别设置横向和竖向像素；每边最多 1024、总像素最多 1,048,576。像素边长为 1–16 个小单位，超过 16 时须为 16 的整数倍，最大 1024，图片厚度为 1–64 个小单位，16 个小单位等于 1 格；生成仍受体积和编辑范围限制。新建文字默认使用 Chisel 的 16 色羊毛粘土；颜色与材料可直接选择羊毛粘土、陶瓦、羊毛或背包方块。新建图片默认采用羊毛粘土为主 + 陶瓦 + 羊毛固定配色：颜色接近时优先使用羊毛粘土，较大的色差由染色陶瓦和羊毛补充。旧的羊毛与染色黏土、仅羊毛、仅混凝土配色仍可选择，已有蓝图和处理预设保留原材质。新默认配色需要 Chisel；混凝土组合需要 Et Futurum Requiem，图片不能自定义材料。可启用颜色抖动。滤镜提供原图、黑白、怀旧、反色、色阶、柔化、锐化和轮廓，可调亮度、对比度、饱和度。自动抠图先找图片边缘最常见的背景色，再去除从边缘连通的同色区域；内部独立同色图案保留，透明处不生成。背景色容差默认 0、最多 64，调大也可能去除相近的边缘前景。图片沿用文字的选位、整体 R/Alt + R、轴面移动和服务端冲突检查，不提供文字扭曲效果。空工作区直接生成，非空工作区点击选位后确认。点击整幅图片后可编辑图片，蓝图保存有界图像采样，分享后没有本地原文件也能重新调整尺寸和滤镜；大图细节受归一化采样及目标像素限制。相同材质的瓷砖精确合并，混色不会折叠为单一方块。图片在蓝图内整体选择、复制、删除与撤销；世界结果为普通小瓷砖或完整方块，重新从世界采集不恢复图片身份。原图文件最多 16 MiB、1600 万像素，最多列出 256 张。

文字与图片按各颜色材料的实际体积核算，支持完整材料方块或相应成品瓷砖；同批施工累计不足整格的体积，缺料不生成方块。同材质连续体积合并为精确大瓷砖，完全填满且等价的单材质格使用普通方块；混色与空洞保持。覆盖保存选择目标时名称自动带入，未手动改名时跟随目标，手动改过后保留自定义名称。

图片预设位于刷新图片左边，字体预设位于返回工作区右边。列表支持套用、改名和删除；文字与图片分别保存处理参数，保留当前文字内容、图片源及放置位置。确认时若参数不匹配已有同类预设，会弹出是否保存为预设，输入名称后选择保存或不保存继续生成；关闭弹窗返回编辑。预设保存在当前客户端 config/gtmb-attachment-presets.nbt，不随蓝图分发。图片源数据分块上传，文字和图片在后台生成并精确合并瓷砖，服务端分批校验后一次加入工作区，期间显示进度，可按 Esc 取消。图片分辨率最大 1024×1024；放大、加厚或复杂图片仍受有效体积、宿主数、编辑范围和蓝图数据预算限制。工作区有内容时，清空工作区红色高亮；清空后回到无内容状态。文字保留原有像素宽高，不另设统一缩放。

猫猫装饰抵用券默认包含羊毛粘土、羊毛、硬化黏土、染色陶瓦及 Et Futurum 混凝土的全部颜色，以及 AE2 的石英玻璃与聚能石英玻璃、Ender IO 石英玻璃注册方块的六个变种（石英/纯净、荧光与黑暗系列）；不开放 Ender IO 机器。旧服务器配置首次升级会补齐这些方块以及 Ztones、Chiseltones 的完整 Mod 范围，保留自定义允许规则、禁用状态与黑名单；之后手动移除的项目不会在重启时反复恢复。管理员通过 /gtmb voucher 保存成功后立即采用新规则，并自动重新核算已打开的材料确认界面；等待更新完成后可在原界面继续操作。旧报价和旧确认失效，黑名单仍优先。有可抵扣方块就高亮并允许勾选查看方案，不要求其他材料或抵用券已备齐；生存施工前仍须在主背包备券，创造施工不扣券。主动选用抵用券后优先抵扣，即使库存充足也保留对应库存。抵扣仅适用于实际放置的方块及受支持装饰材料，容器里的物品、工业资产和流体继续计费。

保存蓝图或升级旧蓝图时才生成完全抵用标记。全部有效内容可抵用且没有内部库存、流体等额外费用时，游戏蓝图库右上角显示加宽的金色斜跨条幅，条幅与猫猫头共用一套完整像素图案。悬浮提示说明这是可使用猫猫装饰抵用券抵扣建造材料的纯装饰蓝图；具体范围与消耗以当前服务器规则和材料核算为准。蓝图站只读取 JSON 内严格的 fullyVoucherCovered 布尔值，在预览卡片和详情页显示同款完整像素条幅，按网页整数倍尺寸展示；鼠标悬浮或键盘聚焦均可查看纯装饰与抵用券说明；手填同名网站标签不会触发角标。普通导入与浏览不会生成标记，实际施工仍以当前服务器的材料核算为准。

联机保存的同名 JSON 与 PNG 一起放入游戏目录 MiaoBlueprints 后，单人档打开或刷新蓝图库即可发现，无须复制集合清单；原文件、作者、版本与抵用标记保留。

猫猫装饰抵用券默认包含 OpenBlocks 普通电梯和旋转电梯各 16 色，只开放这两个注册方块的颜色变种。旧配置首次升级补齐这 32 项，保留自定义允许规则、黑名单和禁用状态；之后手动移除的项目不反复恢复。仅抵扣实际放置的合格方块，容器里的物品仍独立计费。

工作台与独立工作区

蓝图编辑画布使用中键拖动平移、右键拖动调整观察方向、滚轮缩放；左键继续用于选格、框选与操作手柄。右键短按并松开仍打开当前内容的操作菜单；拖动观察时不弹出菜单。旋转查看同样只调整观察方向，不改变蓝图内容与默认放置朝向。世界蓝图框选的等距观察同样使用中键平移、右键旋转；投影工作区、剪切列表预览与世界放置保留各自原有的镜头操作。剪切和世界放置的等距观察仍以左拖旋转、右拖平移。

蓝图设置标题右侧的旋转图标用于调整整份蓝图的默认放置朝向：每次水平旋转 90°，四个固定方向循环。悬停查看当前与下一方向；Ctrl + Z / Y 可撤销或重做。保存成功后，下次载入和放置沿用保存的朝向。设备或物品 NBT 没有已适配的转向规则时会拒绝，原蓝图保留。

普通蓝图的实际记录格数必须少于 1,000,000 格，最多 999,999 格；采集、编辑、载入、保存和放置均受此限制。外接范围中未记录的空白不计入格数；蓝图明确记录的空气和排除格仍计入。文件大小、数据预算和现场检查另行核对。

投影工作区使用最近一次真实控制器投影。打开蓝图前，若投影仍有内容，先明确确认放弃当前投影及投影记忆；取消时保留投影，目标蓝图打开失败时也保留原工作区。确认并成功打开蓝图后，原投影记忆清除，不再保留另一份可切回的投影。没有可恢复的投影时仍可切入空投影页：顶部模式切换及其以上控件可用，其余区域灰化，中央提示右击控制器开启投影模式。重新右键真实控制器才建立新的投影；工作区切换仍核对原投影仪、世界、会话与规划版本。投影模式不支持添加文字或图片。

左右工具栏默认只显示图标，名称各自收起，可分别展开；空间不足时采用紧凑布局。右侧入口打开属性、结构配置、蓝图处理、材料、量子网络、提示词或施工面板，功能面板可拖动浮出并用图钉停靠。有操作提示的蓝图按钮以对应颜色的边缘呼吸高亮引导，仍须阅读按钮文字与悬停说明。收纳入口汇总内部可用控件的高亮，展开后仍须阅读具体提示。蓝图库有独立收纳控制，按钮同时显示图标与文字，保存条目列表占满剩余高度，长名称最多显示两行，完整名称可悬停查看。任务进度集中在工作台顶部，保留各任务的真实阶段与结果。Ctrl + Shift + Delete 清空当前工作区，未保存内容仍须确认；此操作不拆除世界方块。Esc 或未在文本字段输入时按 E 逐层返回，先关闭当前弹窗、浮动工具或子面板，最后才退出工作台。牛皮纸界面使用原 HTML 工作台的像素素材；界面外观不改变权限、材料和现场检查。

蓝图工作区默认展开独立的可收纳蓝图库。普通点行载入所选蓝图供预览和编辑，保留观察镜头；重复当前项不重新载入。未保存的内容将被替换时，先确认放弃；取消保留原稿、当前项和预览。选择覆盖目标模式下点行只指定覆盖目标，保存仍须核对目标。库文件的管理入口继续按当前来源和权限开放。

剪切在同一工作台根界面显示私有暂存列表和原始数据预览，不再打开独立剪切弹窗。点行只切换预览，可独立旋转与缩放；需要搬移时明确点放置所选，原位恢复须先点撤回原处再确认。同步列表与重试预览不提交放置或撤回。暂存仍属于当前存档的对应玩家，不进入蓝图库或分享。

隔离教学

投影教程使用真实电力高炉的采集规划副本；蓝图教程从空白草稿开始，打开蓝图库后仍为空白。中央画布不预填机器，首次从空稿载入无需丢弃确认。

明确点击教学内存库的一行才载入规划。蓝图教学布局以同一观测数据派生两台高炉，一台在地面，一台在有支柱的平台上，含 168 格平台、支柱、台阶承托与地基，共 240 格；地面预留移动和复制位置。派生布局不是多台机器的实机采集照片，也不表示机器已经成型。教学物品按稳定注册名恢复，仓室候选来自当前 GregTech 电力高炉的原生声明，不沿用另一次运行的数字物品 ID。

整选地面高炉后，沿 X 正向移动 2 格，仍落在地基上；平台高炉保持原位，当前仍为两台高炉、240 格。模型沿原生手柄按整格吸附。

轴向移动后切换另一行：取消并保留当前规划，当前仍为两台高炉；随后明确确认放弃修改并载入另一行，恢复原始两台布局。取消不会替换当前几何、选择和来源；确认并载入后才恢复所选教学文档的原始布局。

重新整选地面高炉后，先沿 XZ 平面向正 X 移动 3 格、正 Z 移动 1 格，将它移入地基右侧空位，高度保持不变；平台高炉保持原位。XY、YZ 平面使用同样的原生逆解。

平面移动后，于起拖时按 Ctrl 沿 X 负向复制 5 格。原机留在右侧，副本落在左侧空位，两台之间留出通道；平台高炉保持原位。此时才形成两台地面、一台平台的三炉规划，共 276 格，168 格建材不变。教学只在无重叠且底部有承托的位置提交手柄结果，未到达本课目标时恢复拖动前布局并停在当前动作。

教学中打开蓝图库会收起右侧属性栏，打开功能页会收起蓝图库；选格、整选、移动与复制前，自动收起蓝图库、属性栏和结构列表，让画布保留操作空间。

载入的教学规划不预放文字或图片；蓝图课程只查看文字与图片工具的入口及提示，不创建附件，投影模式不提供图文添加。作者蓝图的整机仓室预设保持禁用，课程只悬停查看限制；NBT 入口沿用实际来源与处理门禁，课程只悬停，不打开或编辑窗口，不编造逐格 NBT 原值。保存侧栏分别标识另存与覆盖，教学只查看名称、保存和覆盖入口，不提交文件。

材料课直接使用正式材料与施工确认窗口，需求按当前教学规划核算，教学库存为零；窗口只用于讲解，不提交真实付款或 AE 订单。

普通与等距框选、剪切课程通过重新选取第二角调整世界选区，不使用编辑器的 XZ 移动手柄。扩大后的教学选区按完整 120 格体积记录：来源 36 格包含既有空气，另纳入 84 格空气；设备的原生 NBT 随副本保留。剪切命名保存复用正式界面的控件；保存后从共用剪切列表点击放置所选，再进入世界预览。

锁定后再次操作才打开独立放置确认，取消保留教学暂存，再次从列表取出并明确确认后才消费。放置确认复用正式界面控件；教程中的操作只改变教学模型，不会改动你的世界、剪切暂存、蓝图库或材料库存。

剪切列表课程的两行是同一采集规划的教学副本，复用实际列表和预览控件。上一步、重新开始、完成与跳过按课程检查点恢复状态；Esc 或 E 退出教程并返回原工作区。教程保留正常工作区比例，四个导航按钮浮动显示，不占用底部说明栏；焦点随当前控件、弹窗与布局实时更新，焦点外柔化灰显。

重叠条件中的仓室配额

同一原生仓室能满足重叠的多组条件时，按原声明的实际贡献分别计入对应配额，同一位置的物料只预留一次。原生或组合中的重复分支沿用原生计数；未知自定义条件仍受保护，显示候选不会授予施工资格。

资料依据

玩法速查

通用声明决定可解释的结构

GTMB 采用通用结构声明策略，不按机器名称、固定模组版本或外形相似程度补写结构。GTNL / GTNLLib 不是本候选的构建依赖；这里也没有特定机器的支持清单。结构中的几何、主信道、子信道、偏移和材料集合须来自可以解释的声明。

一次采集固定使用同一份 definition 图，分批继续时复用它；重新扫描、改变参数或开始另一轮采集时重新读取。这样可以处理每次创建新元素对象的动态声明，但不能据此推定该机器的全部条件已被识别。

未知 supplier、predicate、提示、检查回调或隐藏条件不用于试探。无法通用证明的格子保持未知，不能因为预览显示、手选材料或名称匹配就取得自动施工资格。通用仓室预设只按已明确声明的配额规划；原机隐含的成型条件和实际运行仍由原机判断。

来源说明与当前资格分别核对

来源可以区分新建模板与现场快照，并提供本轮只读状态观察。用途变化需要重新采集。来源注销、声明或材料规则代际变化、相关状态变化及区块卸载，均可能使已有资格失效；出现重扫提示时重新读取并核对材料。

保存的 metadata 只说明原方案，不保存当前运行时来源证明。载入、复制或分享旧文件不会自动取得 fresh 资格。当前通用声明须接受本轮目标；存在明确注册的纯整单规则时一并核对。缺少施工证明的默认格保持保护并跳过，其余已验证格可以继续；明确指定却无法验证的目标仍拒绝整次请求，并报告位置和原因。

本文说明当前已审阅的通用声明候选源码，基础环境为 GTNH 2.9.0 正式版与 Core 0.2.0 或更新版本。候选尚未发布 Release；正式下载以 Release 页面为准。此前专属实现的运行结果保持历史归属，不能作为本候选的客户端、施工、网络或性能验收。

玩法速查

候选完整性与具体目标施工

候选列表是否穷尽，与当前目标能否施工分别核对。原生工厂明确提供的施工输出可逐材料验证；透明包装保留这项证据，或分支中有一个已证明的分支即可授权对应材料。未知条件、延迟工厂和仅用于显示的备选不授予施工资格，不能因为列表里出现某种材料就直接施工。

缺少施工证明的默认格保持保护，保留现场且不扣材料；其余已验证格可以继续。明确指定却无法验证的目标仍会拒绝整次请求，并以中文说明位置和原因。遇到来源失效、用途变化、整单规则或读集核对失败时，仍须按提示重新采集或修正方案。

通过声明核对后，仍使用真实物品放置、实际支付与世界读回；失败按原事务恢复。普通物理蓝图沿用自己的合法身份与材料校验，不能借结构声明绕过原有检查。预览可见、候选列表完整或进度结束，都不等于机器成型。

玩法速查

结构提示与大型结构准备

标准仓口声明可显示固定的预览标记；这项提示只说明位置，不授予材料或施工权限。世界预览仍需结合当前目标、区块和材料状态核对，不能仅凭提示已出现判断模型绘制或施工已经完成。

大型结构重复使用标准仓口声明时，复用有界缓存中的注册表候选展开；每格选材、完整信道参数和声明失效检查仍保留。这里不承诺固定耗时、无卡顿或 TPS 提升。

结构信息、设置与默认目标准备只观察已加载区块。NBT 键观察未完成时不会记为完整缓存；相关区块载入后重新读取并核对完整结果，不把暂时未观察到的内容当作空数据。

玩法速查

原生声明入口与坐标边界

原生采集同时识别 GT buildPiece 与直接调用 StructureLib 默认 IStructureDefinition.buildOrHints 的入口，在原生元素遍历前记录实际结构图、分段和触发物品。续批复用实际捕获的同一份图；同世界、等效朝向的相对 XYZ 锚点会归一化到原有坐标。

跨世界、控制器上下文改变、非提示建造模式、不同有效朝向、同次多份结构图或混用两种入口时，采集明确拒绝。自定义重写默认方法且不委托原实现的入口不在这个钩子的覆盖内，需要来源提供者给出可解释的声明。记录几何不授予未知元素回调或施工权限，来源有效性和具体目标证明仍须分别通过。