用户指南

本文介绍 Space Engineers Blueprint Editor 当前界面中已经可用的功能。若你准备从源码构建，请先阅读开发指南。

Caution

在编辑、覆盖或删除蓝图前，请复制整个蓝图文件夹作为备份。建议先退出《Space Engineers》，避免游戏与编辑器同时写入同一文件。

典型工作流

flowchart TD
    Start["启动应用"] --> Init{"游戏定义是否加载成功？"}
    Init -->|"否"| Settings["在设置中选择游戏根目录"]
    Settings --> Restart["重启应用"]
    Restart --> Init
    Init -->|"是"| Open["选择、拖放或从列表打开 .sbc"]
    Open --> Detail["检查详情、DLC、网格和组件"]
    Detail --> Edit{"是否需要修改？"}
    Edit -->|"否"| End["结束"]
    Edit -->|"是"| Backup["备份原蓝图目录"]
    Backup --> Change["编辑属性或执行批量修改"]
    Change --> SaveAs["保存到目标 .sbc"]
    SaveAs --> Verify["在游戏中粘贴并验证副本"]

首次启动

应用会按以下方式准备运行环境：

查找《Space Engineers》安装目录并从 Bin64 加载游戏程序集。
扫描 %APPDATA%\SpaceEngineers\Blueprints 下的蓝图。
在后台读取游戏 Content 中的方块、组件、物品、场景和本地化定义。

定义加载期间，部分详情统计和定义浏览页会等待。若出现“加载游戏定义失败”，打开“设置 → 环境 → 游戏根目录”，选择包含 Bin64 和 Content 的 SpaceEngineers 文件夹，然后重启应用。

打开蓝图

可通过三种方式打开 .sbc：

把文件拖到首页或编辑器空白页。
在首页选择“打开本地文件”。
从导航栏进入本地、云端或工坊蓝图列表，再单击蓝图卡片。

蓝图列表使用以下默认目录：

列表	目录	说明
本地	`%APPDATA%\SpaceEngineers\Blueprints\local`	游戏内创建或复制到本地的蓝图
云端	`%APPDATA%\SpaceEngineers\Blueprints\cloud`	Steam Cloud 同步的蓝图
工坊	`%APPDATA%\SpaceEngineers\Blueprints\workshop\temp\Steam`	已下载工坊内容的临时缓存

每个子目录通常包含 bp.sbc 和 thumb.png。缺少 bp.sbc 的目录仍会显示，但会带有无蓝图提示。

蓝图列表操作

搜索：输入蓝图名称的一部分，匹配不区分大小写。
刷新：重新扫描当前三类蓝图目录。
在文件夹中打开：打开蓝图所在目录。
复制：在同一级目录创建一份完整副本，可修改新目录名。
删除：递归删除整个蓝图目录。

Warning

“删除”不是移入回收站，应用目前也不提供撤销。云端和工坊内容还可能被 Steam 再次同步或刷新。

查看蓝图详情

详情页会读取第一个船舶蓝图定义，并显示：

蓝图显示名、所有者 Steam ID、文件大小和文件路径。
所有网格的可破坏、可编辑状态。
所需 DLC 列表。
网格数量、每个网格的名称和方块数量。
根据当前游戏定义计算出的组件总量。

组件统计依赖当前安装的游戏定义。游戏版本、DLC 或 Mod 定义与创建蓝图时不一致时，未知方块可能无法计入结果。

编辑蓝图

从详情页选择“在编辑器中打开”，或直接在编辑器页打开/拖入文件。编辑器支持多个标签页；每个标签页持有一份独立的内存中蓝图对象。

浏览模式

模式	用途
网格	按 CubeGrid 分组列出全部方块，并可按方块名称或自定义名称搜索
方块组	按游戏内 Block Group 聚合方块
属性	显示整个 `ShipBlueprint` 的可写字段和属性树
三维	以方块定义包围盒渲染蓝图，可选择并变换方块
钣金	编辑所选方块对应的网格 Skeleton 表面控制点

选择方块后，右侧属性树会延迟展开对象。基础值、枚举和部分标志枚举可在对应控件中修改；对象、集合和游戏专用类型主要用于继续浏览。

三维编辑

三维页通过本地 WebGL 2 视图显示全部网格。它使用游戏定义中的尺寸、蓝图方向与颜色绘制方块包围盒，不加载游戏的真实模型或纹理。

常用操作：

左键单击选择方块，左键拖动旋转视角，Shift + 拖动平移，滚轮缩放。
方向键沿 X/Z 移动，PageUp / PageDown 沿 Y 移动；工具栏也提供六个方向按钮。
R·X、R·Y、R·Z 分别绕对应轴旋转 90°。
Shift+D 复制，Delete 删除。
Ctrl+Z / Ctrl+Y 撤销或重做三维编辑操作。
F 或“适应全部”重新框选整个蓝图。
工具栏可保存当前文件或另存为新 .sbc。

移动方块时会检查目标最小坐标是否已被占用，删除和移动还会同步更新引用原坐标的方块组。由于多格方块占用范围比一个最小坐标更复杂，仍可能产生重叠；复制会把 EntityId 清零并沿 X 轴寻找空的最小坐标。请始终在游戏测试世界验证。

撤销/重做栈只记录三维页中的移动、旋转、复制和删除。属性树、钣金形变和批量转换不会进入这两个栈。

若页面提示 WebGL 2 不可用，请更新显卡驱动和 Microsoft Edge WebView2 Runtime。

钣金形变

钣金页会在左侧列出方块，并在右侧显示所选方块的简化立方体与 14 个表面控制点：8 个角点和 6 个面中心。修改会写入 CubeGrid.Skeleton 的原生 Bone 数据。

单击控制点进行选择。
选择 X、Y 或 Z 轴后拖动控制点，或用三个数值框精确输入偏移。
每个轴的偏移限制为 -1 到 1 个当前网格单元。
“重置控制点”清零当前点，“重置方块”清除该方块的 14 个表面 Bone。
右键拖动旋转预览，滚轮缩放，“重置视图”只恢复相机。

该编辑器处理方块表面的角点和面中心，不是完整的任意网格骨骼编辑器。共享 Bone 可能影响相邻装甲的最终外观，应在游戏中检查接缝。

批量修改

“编辑”菜单当前提供以下操作：

操作	当前行为
可破坏 / 不可破坏	设置所有网格的 `DestructibleBlocks`
可编辑 / 不可编辑	设置所有网格的 `Editable`
小网格 / 大网格	设置网格尺寸，并按 `BlockPairName` 尝试替换对应尺寸的方块定义
轻甲 / 重甲	根据当前游戏定义替换可识别的装甲方块

完成尺寸或装甲转换后，消息会分别给出已转换、已经是目标类型和不支持的方块数量。不支持的方块保持原样。尺寸转换不会重排方块坐标；定义尺寸变化可能导致重叠，因此对复杂蓝图使用后必须在游戏副本中验证。

保存

使用“文件 → 保存”或 Ctrl+S。从现有文件打开的蓝图会保存回原路径；三维页工具栏另提供“另存为”。核心层先在目标目录写入唯一临时文件，再通过原子替换写入 .sbc。若目标已存在，旧内容保存为同名的 sbcB5 备份；若已有备份，会被本次保存的旧版本替换。

建议采用以下保存策略：

首次编辑时先在三维页使用“另存为”，或手动复制整个蓝图目录。
不要把单个自动生成的 bp.sbcB5 当作唯一备份。
在游戏中把修改后的蓝图粘贴到测试世界。
确认方块、方向、网格尺寸和终端数据正常后，再替换正式副本。

如果保存失败，请确认目标目录可写、文件没有被游戏或同步程序锁定，并检查应用是否能找到游戏 Bin64。

浏览游戏定义

导航栏的“游戏定义”可查看：

方块（Cubes）
组件（Components）
物品（Items）
场景（Scenarios）

底部搜索框按显示名称筛选定义；右侧搜索框按字段名或字段值筛选当前定义的公开字段。图标会从游戏纹理转换后缓存在应用缓存目录中。

设置

设置页包含以下选项：

主题：浅色、深色或跟随系统。
导航布局：自动、左侧、顶部、紧凑或最小模式。
游戏根目录：打开或重新选择《Space Engineers》目录。
应用缓存：查看路径和大小，或清空已生成的定义图标等缓存。
关于：查看版本和项目链接。

更改游戏根目录后，当前进程已经加载的程序集不会被卸载，建议重启应用。

常见问题

应用找不到游戏

确认所选目录同时包含：

SpaceEngineers\
├─ Bin64\SpaceEngineers.exe
├─ Bin64\VRage.Game.dll
├─ Bin64\Sandbox.Game.dll
├─ Bin64\SpaceEngineers.Game.dll
└─ Content\

你也可以设置 SPACE_ENGINEERS_ROOT 或 SPACE_ENGINEERS_BIN，详见开发指南。

蓝图列表为空

确认蓝图位于对应默认目录。
确认每个蓝图拥有独立子目录，且其中包含 bp.sbc。
使用列表底部的“刷新”。
工坊路径是 Steam 的临时缓存，未订阅或未下载内容时可以为空。

蓝图没有缩略图

应用优先读取同目录的 thumb.png；不存在时会显示默认占位图，不影响 .sbc 读取。

详情或定义页一直加载

通常是游戏定义初始化失败。检查游戏路径、游戏文件完整性和应用错误提示；若游戏刚更新，重新构建应用并清空定义图标缓存。

修改后的蓝图不能在游戏中使用

恢复备份，并重点检查：

是否把大网格标记用于只存在小网格定义的方块，或反之。
蓝图是否引用当前游戏没有的 DLC、Mod 或旧版方块。
属性值是否超出游戏接受范围。
保存时使用的游戏版本是否与运行游戏一致。

数据安全建议

始终在副本上编辑，特别是 Steam Cloud 和工坊缓存。
不要把个人蓝图、Steam ID、缓存或游戏 DLL 提交到仓库。
不要依赖工坊 temp 目录做长期存储。
遇到异常时保留原 .sbc、sbcB5 和可复现步骤，便于排查。