适配范围、旋转与施工边界

GTMB 接入 GTSWN 量子节点原生外观和链路节点覆盖板离线快照：量子节点按审阅的颜色、在线状态、连接方向和 AE 部件绘制；high 覆盖板绘制浮雕与两层材质，old/oldplus 沿用 GT 原生覆盖板面。工作台、世界 ghost 和保存 PNG 使用对应预览路径，不运行节点 tick、真实网络、世界粒子或安装动画。

本轮已按 GTSWN 的持久化 schema 审查：已识别的 lastAppliedMigration 非负 long 是来源存档的迁移游标，蓝图省略它，放置时按目标网络重建；负值、错误类型及未审阅数据仍会阻塞。搭配 GTSWN 时，GTMB 的量子分类与目标网络选择方式见 量子网络作者处理。

质量设置、六向颜色和 AE 部件组合有各自边界，不承诺所有变体或整包场景均已通过验证。Drive 与 Interface 预览仅绘制外观，设备数据仍通过已审阅的保存和施工规则处理。

com.miaokatze.gtmb.api 提供合约版本 1 的十组接入：结构来源 StructureSources、声明 Declarations、普通蓝图变换 BlockTransforms、原生采集 NativeCapture、原生放置 NativePlacement、资源容器 ResourceContainers、显示家族 GTMBExtensions.nativeDisplay、客户端渲染 ClientRendering、快照检查 BlueprintSnapshots，以及独立原始剪切变换 CutTransforms。扩展使用命名空间 ID 注册，并返回可关闭的注册句柄；重复 ID 被拒绝，关闭仅撤回该注册。

StructureSources 按控制器精确类型提供结构定义与 piece 列表，触发物品使用副本。结果只属于本次采集，不跨采集全局缓存。BlueprintSnapshots 在采集完成和作者处理完成时提供分离的只读快照，扩展可检查数据并返回命名空间报告；这不提供会话或直接写世界的接口，也不是施工授权。渲染入口由客户端加载，接入仍须遵守对应模块的数据与机器规则。

CutTransforms 单独处理当前存档中玩家原始剪切缓存的空间字段。预览和放置使用派生副本，原队列保留到成功提交；已知方向变换、未知字段原留，不进入普通蓝图的材料、去标识或 schema 审核。登记的原始变换应保留库存、归属和未知字段，不访问真实世界；关闭句柄只卸载该次注册。

ResourceContainers.register(id, FluidCodec) 使用统一的 GTMBExtensions.Registration 生命周期。回调收到完整容器与身份/路径上下文的独立副本，不提供世界、库存或会话接口；这是受信任的进程内扩展契约。返回 null 表示不适用，非 null 结果负责完整核算该子树，空列表表示合法空库存；未知字段、类型或无法计价的数据须抛出 IOException。FluidAmount.amount 为 long，identity() 返回含流体标签的副本。

公开的 ResourceContainers.numberedFluidSlots(context.container()) 接受最多 512 个连续 #0..#N compound 槽：空槽、Forge 的 FluidName/Amount/Tag，或 AE 的 FluidName/Count=0/Cnt/Req/Craft/tag。AE 的实际物理数量来自 long Cnt，不使用占位 Count。缺号、未知字段、错误类型、负数和混合数量格式被拒绝。通用槽解码仅在流体上下文或 fluid/tank 名称下自动使用；其他完整原生容器可由已注册回调按身份和路径选择。

注册按顺序尝试，首个非 null 结果负责完整子树。注册和关闭 handle 都更新 generation()，生产材料计划把它纳入缓存键。宿主仍校验流体标签是否能由实际取料后端保真处理，并执行材料、位置、权限和施工确认；接口不会改写保留 payload 或授予放置权限。此接口只用于普通蓝图的保留资源计料，原始世界剪切继续使用独立事务。

世界剪切 是当前存档中对应玩家的持久 raw 缓存，不用于分享或蓝图库。三轴旋转和镜像按源局部镜像 → X → Y → Z 计算，完整体积含空气一起变换；已知空间字段变换，未知私有字段按 WorldEdit / MatterManipulator 的保留原则原样携带，不猜语义，也不因未适配方向拒绝整次放置。普通蓝图的材料、schema 审核、去标识与作者处理不应用于该缓存。

所选条目的完整 raw NBT 经独立剪切通道发送给已认证所有者，使用独立原生预览世界和渲染器；不走普通蓝图外观白名单。无法读取或渲染时显示占位与诊断，原始数据完整保留，不以外观失败阻塞粘贴。原队列只在世界写入和存盘成功提交后消费，预览姿态不回写原件；原位撤销始终恢复原维度、原位置、原姿态。

GTMB 将原始数据及已知方向变换交还原模组，加载和运行可按原模组规则改变状态，不承诺最终 NBT 逐字不变；私有坐标引用与外部网络不能视为已自动修复。剪切覆盖完整目标体积，源空气也会清空对应位置，不对原方块执行拆除掉落，也不通过普通施工保护事件预检。提交后的原生回调、邻居更新与自然物理可能影响选区外。

生存模式不会绕过区块、权限、控制器、方块实体或事件保护。创造模式也保留设备与权限保护。施工中现场变化会停止剩余工作，已完成结果保留。

已适配原生放置沿用原物品和 Forge 事件。事件取消会标记受保护，失败退还实际扣除材料；原生调用的其他失败按材料缺失或不支持等实际结果报告。预览能显示外观不代表材料、身份与权限检查已经通过。

蓝图复用的是经过检查的方案；原机器的最低外壳数量、仓室类型、空气位、活动状态与额外成型条件继续有效。遇到报告中的不支持项，调整对应格或配置后再预检。

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

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

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

结构来源通过 ContextualSource 提供显式结果与运行时有效性证明。Declarations.PureElement 描述独立材料、角色、接受条件、自动放置条件、朝向与世界身份匹配；只读 WorldState 不暴露可变世界或活 TileEntity。纯元素不能证明整机几何之外的隐藏玩法规则。

StructureSources.Policy 可提供纯整单准入；GTMB 不内置具体机器 policy，也不探测未知 supplier、predicate 或硬编码结构。MaterialVariants.registerExact 仅负责其精确身份的计划投影。公共注册复用现有 Core 的 ExtensionCatalog，不会因登记一个扩展就跳过来源、目标、材料、权限或世界事务检查。

扩展代码属于受信任的进程内 Java 代码；这些只读与纯声明约束是契约，不是任意第三方代码的沙箱。缺少施工证明的默认格保持保护，其余安全格可以继续；显式目标仍须取得自己的施工证明。

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

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

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

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

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

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