Loom

Loom 的覆盖范围正是重点所在。实时链接几乎承载了整个场景，以及围绕它的创作状态，这里列出的一切都会送达你打开的任一编辑器。

• 9 种 Blender 对象类型：网格、曲线、文本、曲面、融球、骨架、灯光、摄像机、空物体
• 全部 1 至 8 个 UV 通道，外加 RGBA 顶点色，并为大网格提供 32 位索引
• 骨架与形态键，含实时姿势和 blendshape 权重
• 4 种灯光类型，带景深的透视与正交摄像机
• 世界 HDRI 与雾
• 集合、几何节点与粒子实例化，含关联副本去重
• prefab 引用放置：给对象或其网格数据打上一个键，就能在任一引擎中从注册表生成你真正的 prefab 或 Blueprint
• 灰盒 → 成品的替换，可从 Blender 驱动，也可从任一编辑器驱动
• 一份 Tracked Objects 列表，准确说明正在传输的是什么，并带有 Exclude 与 Include
• 布尔切割体与 SNAP_ / SOCKET_ 标记空物体会被自动跳过
• 一份四页的“How replacement works”说明，三个应用中是同样的页面
• 带内容去重纹理的 Principled 材质
• 将 20 多个着色器节点转译为真正的 URP 着色器，全部 19 种 Mix 混合模式
• 实时碰撞体、LOD 组，以及面向游戏的层、标签和 static 路由
• 挂接点：带共享标签的插座与插头，在 Blender 中吸附并传到两个引擎；另有生成器替你创建碰撞代理与 LOD 链
• 刚体：Blender 的 Rigid Body 设置会在任一引擎中成为真正的物理刚体，并以 Blender 自身的模拟为基准进行了测量
• 平铺测试：在套件部件周围摆放它的副本，在引擎光照下检查接缝，副本不会进入任何烘焙
• 一条命令的无头烘焙（blender -c loom_bake），无需打开任何编辑器即可把 .blend 烘焙为 prefab 或 Blueprint，面向 CI

先在 Blender 里用灰盒把关卡搭出来，再把占位物换成你真正的 prefab 或 Blueprint。可以在 Blender N 面板的 Set Prefab Key… 中指定，也可以在 Unity 或 Unreal 窗口的 REPLACE GREYBOX 中指定。每一次指定都会写入 .blend，在那里按 Ctrl+Z 即可撤销，因此周五替换了一半的关卡，在两个应用都重启之后，周一还是同一个关卡。写入由编辑器请求 Blender 完成，没有任何东西只留在会话内的映射里。

Loom 是一个 Blender 生产端，拥有两个一等的消费端。二者解析同样的字节，即线缆协议 v40，以及同样的黄金夹具，因此每项能力都会送达任一编辑器。Unreal 只是为每个 Unity 概念选用了地道的对应目标。

大多数实时桥接止步于几何体。Loom 把 Blender 着色器节点图转译为真正编译的着色器，在 Unity 中是 URP 的 .shader，在 Unreal 中是 LoomLit 材质内移植的 HLSL，而非扁平的近似。程序化节点移植自 Blender 5.1 自身的源码，因此生成的着色器是在再现 Blender 的外观，而不是凭猜测。

• 真正编译的着色器，而非预览取巧。生成的着色器支持前向与延迟渲染、阴影、深度预通道以及 SSAO。
• 忠实回退。不支持的节点图会降级为精确的 Principled 材质，离线预检会在你连接之前就点名相关节点。
• 当节点图实在够不着时，烘焙成纹理。逐材质选择启用，Cycles 会把它烘焙成贴图，再作为普通纹理传输过来。
• 固定你自己的材质。可用你自己的引擎材质覆盖任意 Blender 材质或对象，并在每次重新同步后保留。
• 风格化与卡通材质保留自己的纹理。非 Principled 的节点图没有可供转换的 PBR 参数，因此 Loom 不去伪造外观，而是把该材质具名的纹理传过来，交给你自己的卡通着色器使用。
• 正确处理纹理。按内容去重并打包进引擎贴图槽（金属度与光泽度、法线与强度、遮蔽），同时保留 HDR。

Loom 发送 GPU 可直接使用的字节，且只发送发生变化的部分。同步路径上不会序列化为文本，也不会写入磁盘。

• 直接的二进制链接。原始 float32 与 uint32 缓冲区从 Blender 的 numpy 直达引擎。没有 JSON，没有中继，也不落盘。
• 只发送变化。移动一个对象只发送 40 字节的变换数据包。雕刻与动画只流式传输位置，绝不发送整个场景。
• 非阻塞。套接字 I/O 运行在工作线程上，因此两个编辑器都不会卡顿。
• 自愈。它能挺过脚本重新编译和断线，重新连接后会重新同步整个场景。

只有结果正确，广度才有意义。Loom 的构建目标就是让外观一致，并持续一致。

• 从源码移植，而非肉眼比对。程序化纹理和全部 19 种 Mix 模式都译自 Blender 5.1 自身的着色器源码，细到精确的 Perlin 与 PCG 哈希。
• 一条线缆，三种实现，经证明逐字节一致。Python 生产端与 C#、C++ 消费端都以同一套黄金线缆字节夹具进行校验。
• 在编辑器关闭的情况下端到端测试。无头 Blender 与 Unity 测试套件在 CI 中驱动真实的序列化、套接字、重建与烘焙路径，包括从 .blend 到 .prefab 的完整构建。

实时预览并非死胡同。它会毕业成真正的项目资源。

• 范围。首次连接只传输你的当前所选，并实时统计将要同步的与被排除的数量，你绝不会一不小心就把一个复杂场景整个倒出去。Whole scene 和 Collection 都只需一次点击。
• 被追踪的那一组。在 Selected only 之下，选中一个对象就等于追踪它：取消选中后它仍继续传输，能挺过重新连接或 Blender 重启，只有当你 Untrack 时才会离开编辑器。Exclude 与 Include 在任何范围下都有效。开启 Track the whole model（默认开启）后，一次点击会带上该对象的整棵父级树，因此点击角色的头发就会发送整个角色；要留下某一部分，请用 Exclude。在还没有任何内容会同步时，Blender 会询问 What do you want to send?，并提供整个场景和集合的一键按钮。
• Tracked Objects。一份真正在传输什么的列表，可按 Streaming、Excluded、Blockouts 或 All 过滤，每一行都能选择、冻结、排除和取消追踪。数字告诉你有多少，这份列表告诉你是哪些；当数字看起来不对时，你真正想问的正是后者。
• 辅助对象留在外面。布尔切割体与 SNAP_ / SOCKET_ 标记空物体会被自动跳过，而逐对象的状态会点名那个可以取消跳过的偏好设置。
• 默认单向，带手动编辑保护。在引擎中轻推一个已同步对象，会被暂停而非覆盖，直到你释放它。
• 可选的双向编辑，但按 Blender 的规矩来。把变换和选择推回去，或从引擎按需将不支持的图材质烘焙为贴图。Accept property edits from the editor 是 Blender 的一项偏好设置，被写入的只有 Loom 自己的创作属性，几何体永远不会被改动，而且每次写入都会压入一步撤销。
• 指定它落在哪里。已同步的对象位于 Unity 的 Root object 或 Unreal 的 Root actor 之下，整棵树还可以送到另一个已打开并已保存的 Target scene 或已加载的 Target level。
• 逐对象状态一目了然。Unity 的 Hierarchy 行上有一个状态指示点，Unreal 的 actor 上有 Loom.Paused 标签。在 Unity 中右键点击那个指示点，选择 Pause Loom sync (protect from Blender) 或 Resume Loom sync，无需打开窗口；在 Unreal 中选中 actor，再按 Loom 标签页里的 Pause selected。
• 色块化。固定一个 Global Material 并打开 Override all synced materials，你看到的就是关卡本身，而不是材质。prefab 引用保留各自的材质，而烘焙始终使用真正的材质。
• 运行模式中同步。实时编辑会流入正在运行的会话并挺过域重载，并带有清晰的运行中指示。
• 替身不会在不知不觉中丢失。Loom 放置的对象是实时预览，不会随场景保存；断开连接后，两个编辑器都会用横幅说明这一点，并提供 Bake Scene…、Clear Synced Objects 和 Keep for now。
• 英语与韩语。Blender 插件、两个编辑器窗口和应用内指南都支持这两种语言，编辑器会通过连接跟随 Blender 的语言设置。
• 暂停推流。Disconnect 旁边的 Pause 会保持连接但暂存所有更改，Resume 则发送改动的部分。两个编辑器都会显示 Blender 已暂停，静止的视口不再令人困惑。
• 在 localhost 上零配置，带有 Connecting、Reconnecting 和 Waiting for the editor… 状态，并以实时 HUD 显示吞吐量、队列深度、合并帧数以及最重的对象。

• Blender 5.0 或更高版本（已在 5.0、5.1、5.2 上测试）
• Unity 2021.3 LTS 或更高版本（基于 Unity 6 开发）
• Unreal Engine 5.6（基于 5.6 开发、构建与测试，其他 5.x 未经验证），C++ 项目，Win64
• 渲染管线：Unity 中为 URP（生成的着色器需要它），Unreal 中为标准 UE 材质，并在编辑器构建里为每个材质生成 Custom HLSL 母材质
• 同一台机器上编辑器之间通过回环 TCP 连接（默认 127.0.0.1:8787）
• 线缆协议 v40，两个消费端收到的是同样的字节