猫猫蓝图全息投影仪

猫猫蓝图全息投影仪是 GTMB 的工作入口：预览多方块、框选区域、编辑和保存蓝图，再从自己的材料来源完成建造、改造与回收。它独立于 GTIT 运行。

获取与第一次操作

将 1 个 StructureLib 多方块结构全息投影仪无序合成为 1 个猫猫蓝图全息投影仪。同装兼容 GTIT 时，也可在猫猫机用 1 枚普通猫猫币兑换。

蓝图模式下，普通右键打开蓝图工作台；对真实控制器右键可导入结构；仓室预设可选，也可保留手动规划并确认构建。蓝图模式 Shift + 右键打开中央模式切换器；剪切模式先按 Esc 返回普通视角并退出剪切，再打开切换器。按住 Shift 再右键切换，松开进入；选择剪切后直接框选，成功保存后继续框选。蓝图框选再次 Shift + 右键导入区域；选择剪切模式后直接开始框选，核对范围并命名保存后才搬走真实建筑。蓝图页用于保存、选择、导入和导出，浏览已保存方案时点绿色放置所选蓝图进入世界位置预览。

作者处理按实际内容完成必要阶段，也可手动完整六步核对；保存生成同名 JSON 与 640 × 640 原生 3D PNG。世界绿色预览右键锁定为青色，再右键立即进入校验进度，完成后核对材料并确认。核对当前报价后明确确认一次；缺料时确认仅放已有，只施工材料足够的方块。材料和设备配置仍遵循来源权限、适配范围及机器自己的成型规则。

从完整新手指南开始 · 框选与编辑 · 放置蓝图 · AE2 蓝图标记

独立世界剪切

方块、metadata 与完整方块实体 NBT 进入服务端持久剪切队列。剪切框选存在完整框时 普通视角 Shift + 右键、等距视角松开 Ctrl 后按 Shift + 左键确认选区；非框选或尚无完整框时打开暂存列表并保留部分角点，选中条目可在独立 3D 视口拖转缩放；点放置所选才进入世界定位。Alt + 右键原位撤销，Shift + 右键打开暂存列表，Z / Alt + Z 切换加选或减选，Alt + A / D 切换条目。剪切模式 Ctrl + Shift + 右键直接打开暂存列表；Esc 完整退出剪切模式并保留全部缓存。剪切前可命名并保存；放置预览右键锁定，再右键确认。两项不再提示偏好分别按存档与玩家私有保存；跳过放置确认后仍须锁定，再一次右键才提交。成功粘贴或撤销后消费条目。剪切预览 R 绕 Y 轴转 90°、Ctrl + R 绕 X 轴转 90°；Alt + R 打开三轴旋转、镜像与六朝向面板。剪切不进入蓝图材料、作者处理和预检流程。世界剪切完整说明

保存、下载、上传、处理和施工任务可关闭界面后台继续；再次右键投影仪恢复原业务界面并在原界面查看进度。主动取消才请求停止，断开连接会终止任务；真实成功才通知并播放提示音。

材料窗口默认保留中性按钮材质；只有当前有相应操作状态时才强调。红色为警告、青色为建议、蓝色为其他信息、绿色为下一步操作；先读文字和当前材料状态，再选择操作。没有可调整的 NBT、身份信息、阻塞物或可下单的物品缺料时，对应入口禁用，可悬停查看原因；禁用按钮不显示引导色。高亮不代替规划、权限或服务器确认。

大蓝图在整理格子之后仍需核对材料库存。进度会分别显示常规/抵用券需求、库存核对、材料分配、资源核对和完成清单。两份清单按实际需求共用已核对的库存，库存查询不扣料；准备完成前不能开始施工。阶段或计数停住、准备失败时查看提示并返回重试，不把接近 100% 当作清单已经完成。

进入服务器编辑或准备实际施工时，首次完整快照尚未准备成功的视图属于临时切换。这次准备失败会恢复原视图与原选择，并释放对应界面请求，可重新打开或重试。回退只对应仍有效的本次切换；已经开始的施工、保存或 AE 订单继续按各自任务状态处理。

悬停投影仪可按状态、描述、按键与来源分区阅读提示；按住 Shift 查看全部蓝图、剪切和选区操作。抵用券的 Shift 提示分别说明抵扣范围、成功后消耗、失败保留、创造模式与服务器配置。

普通视角中，手持投影仪且没有打开界面时，屏幕顶部显示当前模式和本地已知状态对应的操作。蓝图模式可查看工作区、模式选择和上次蓝图快捷预览提示；剪切模式显示暂存与框选操作。草稿、可撤销规划及后台任务按当前状态提示；尚未确认有上次蓝图时，先在工作区选择。提示不会替玩家发起导入、施工或材料检查。

蓝图站入口通常显示橙色边框和文字；有效选中已保存的蓝图时显示连续渐变边框和文字。颜色只引导浏览与分享，不表示已经上传。保存说明中的分享按钮也有明确高亮。保存或下载成功后，聊天保留实际路径并提供可点击的蓝图站链接。浏览器入口仍按客户端链接确认设置打开，网站投稿与游戏内公库分别处理。

材料窗口按当前报价明确确认一次。蓝图缺料时按钮说明确认仅放已有，确认后只施工已准备就绪的格子；缓存无法支付时明确确认空缓存方案。服务器会核对当前计划与报价凭据并复核库存；材料减少、缓存方案或现场计划变化时，更新清单并要求重新核对确认。Enter 不代替确认，权限、占位和逐格付款检查仍有效。

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

自用与分享倾向都默认轻度自动提示；需要更多说明时可主动选择完整提示，也可不添加，手写提示继续保留。

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

添加图片从 .minecraft/MiaoBlueprintPicture 读取图片，默认短边 64 像素，可保持比例或独立调整宽高。默认以羊毛粘土为主、陶瓦与羊毛补色的固定组合支持滤镜、颜色抖动和边缘同色抠图；图片在蓝图内整体编辑、旋转、移动、删除及撤销，并保存有界采样供分享后再次编辑。图片厚度以 1/16 格为单位，可设为 1–64；同材质体积合并，完整实心格使用普通方块。

新建文字默认使用 Chisel 的 16 色羊毛粘土；颜色与材料可直接选择羊毛粘土、陶瓦、羊毛或背包方块。新建图片默认采用羊毛粘土为主 + 陶瓦 + 羊毛固定配色：颜色接近时优先使用羊毛粘土，较大的色差由染色陶瓦和羊毛补充。旧的羊毛与染色黏土、仅羊毛、仅混凝土配色仍可选择，已有蓝图和处理预设保留原材质。新默认配色需要 Chisel；混凝土组合需要 Et Futurum Requiem，图片不能自定义材料。

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

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

木匠方块的来源所有者不会阻塞等级 0 蓝图；新放置方块按原生放置规则归当前放置者，无须为此去标识。形状、饰面、染色、设计与其他配置保留，原方块不变；现场权限、实际材料和内部物品仍独立核验。

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

安装前提

客户端与服务端都需要安装 Miaokatze Core（至少 0.2.0，不设版本上限），以及 GregTech、StructureLib、AE2 和 MUI2。其他 Mod 依赖不限制版本，保留必需关系与加载顺序。支持 GTNH 2.9.0 正式版，GTMB 无需安装 GTIT 或 Outpost。

等距观察与定位

普通视角优先选中真实方块，没有命中时沿视线取浮空位置；Alt 强制浮空，Alt + 滚轮调整 0–64 格距离，0 取脚下，普通滚轮仍切换快捷栏。等距视角按当前画面的真实命中面取点；按住 Alt 时，滚轮调整沿视线的取点深度，可为负值：正值朝相机浮出，负值沿视线进入命中格后方，0 使用直接命中格。没有有效命中时先调整视角或高度切片，不把切片平面当作真实方块。等距视角中的普通滚轮用于缩放。

手持投影仪进行蓝图、剪切或拆除框选，或处于蓝图、剪切世界放置预览时，可按 V 切换等距视角；按键可在游戏控制设置中改绑。再次按 V 或按 Esc 返回普通视角；多边形轮廓已闭合时，可按 B 以当前厚度确认本地选区。Esc 先退出等距视角，原选区或蓝图仍保留。蓝图框选的等距观察使用中键平移、右键旋转；剪切与世界放置的等距观察使用左键旋转、右键平移。选点与世界放置按当前阶段配合 Ctrl，普通滚轮缩放。等距镜头不移动玩家，也不授权导入或施工。切出游戏时暂停操作输入，保留原有框选和等距模式；单人游戏仍按原版规则暂停。返回后可继续原有操作；主动按 E 或 Esc、换世界或换工具仍按当前流程退出。等距放置进入后即显示位置预览，无须先按 Ctrl；锁定和确认仍须 Ctrl + 左键。等距蓝图放置时按住 Ctrl，用左键锁定位置，再 Ctrl + 左键进入原有核对与确认流程，Ctrl + Shift + 左键解锁；普通视角继续使用右键。等距剪切放置同样按住 Ctrl，用左键锁定、再 Ctrl + 左键确认，Ctrl + Shift + 左键打开暂存列表；Alt 只控制浮空取点，不触发原位撤销。R 调整模型朝向的操作在普通视角使用；剪切等距中仍以左拖旋转镜头。X 开关高度切片：开启后左侧竖直高度条同时显示隐藏上方、隐藏下方按钮与当前 Y 值。X 光显示后即可按该画面选点，无需等待边界网格重建；切片只影响观察和取点，提交前仍须核对实际选区。等距框选提示随当前角点、加减选模式、多边形与确认阶段更新；Ctrl 用于选点，放开 Ctrl 后可旋转和平移镜头。世界投影外轮廓去掉相邻共面方块的内部块缝，仍保留凹角、洞口和真实形状边界。

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

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

蓝图设置标题右侧的旋转图标用于调整整份蓝图的默认放置朝向：每次水平旋转 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 退出教程并返回原工作区。教程保留正常工作区比例，四个导航按钮浮动显示，不占用底部说明栏；焦点随当前控件、弹窗与布局实时更新，焦点外柔化灰显。

顶栏教程打开课程列表，前三项依次为蓝图文字附加图片附加，再按需要选择投影、结构操作、框选或剪切课程。文字与图片附加浮窗也有对应课程入口，首次使用时可按提示进入教学。

蓝图处理面板使用同一个入口：开始蓝图处理流程或重新核对蓝图处理。进入牛皮纸流程窗口后，可在显眼位置选择倾向自用或倾向分享，再核对各阶段设置。处理经服务器校验成功后，可在完成页输入蓝图名称，选择保存蓝图另存为新蓝图或保存流程。保存蓝图记录当前内容，另存保留原图并创建新文件；保存流程只复用处理策略，不复制设备内容。处理成功与文件保存成功分别确认，仍须等待相应结果。

世界等距镜头使用与 GTSWN 相同的缩放范围，每世界方块 0.4–128 像素，默认 12；工作台预览使用相对于适配模型大小的 0.025–8 倍缩放，默认 1 倍，两者的数值含义不同。

首次载入大蓝图时，编辑画布分批准备：先显示保留凹角与洞口的轮廓，再补齐材质和设备模型；内容修改后仍按需分批准备。换图等待期间暂停上一稿件的模型绘制和画布选点，已有轻量轮廓可继续显示；新稿件的轮廓显示后可先旋转、平移和缩放镜头。场景完整显示后，仅调整镜头时会完整绘制当前视角；选格与编辑须等待当前视角的画布准备完成，期间可继续调整镜头。轮廓出现不表示材料、设备配置或施工条件已经核对完成。