跳到主要内容
AI教程

使用 blender-unreal-asset-bridge 将 Blender 资产迁移到虚幻引擎

了解如何在 Windows 上安装和使用 blender-unreal-asset-bridge，将静态网格体、骨骼网格体、动画、碰撞体、插槽、摄像机、样条线和 Alembic 缓存从 Blender 导出到符合虚幻引擎要求的文件夹树中。你还将配置错误检查器、生成的 Python 导入脚本和内置 AI 助手。

AI我搜编辑部阅读约 10 分钟
使用 blender-unreal-asset-bridge 将 Blender 资产迁移到虚幻引擎

blender-unreal-asset-bridge 的功能

blender-unreal-asset-bridge 是一个 Blender 插件，可简化完整场景向 Unreal Engine 的传输。无需逐个导出资产并手动重新构建设置，你可以在 Blender 中标记资产，执行一次批量导出，并生成专为 Unreal Engine 流程设计的文件夹结构。

该插件支持导出静态网格体、骨骼网格体、Action 动画、NLA 轨道、Alembic 缓存、样条线、摄像机、碰撞体、插槽和 Sequencer 内容。它还会生成 Python 导入脚本，在 Unreal Engine 内容浏览器中重建导出的结构。

该项目面向 Windows x64、Blender 4.2 或更高版本以及 Unreal Engine 4 或 5。生成的导入脚本要求 Unreal Engine 4.26 或更高版本。

主要功能

  • 批量场景导出：一次操作即可导出完整环境、角色集合或影视场景。
  • 网格体与动画支持：导出静态网格体、骨骼网格体、选定的 Action、NLA 轨道、变形目标和 Alembic 缓存。
  • 在 Blender 中创建碰撞体和插槽：导出前创建盒体、凸体、球体或胶囊体碰撞形状及插槽。
  • 导出前验证：错误检查器可识别命名、缩放、材质和动画问题，并可一键修复部分问题。
  • 生成 Unreal 导入脚本：通过生成的 Python 脚本重建内容浏览器结构。
  • 影视内容传输：将摄像机和 Sequencer 内容导出为 Level Sequence，并保留剪辑、宽高比、焦距和镜头偏移。
  • 剪贴板工作流：复制摄像机、样条线和插槽，以便直接粘贴到 Unreal Engine 中。
  • AI 辅助：连接兼容 OpenAI 的服务商和模型，通过对话处理日常命名、检查和导出任务。

安装 Blender 插件

1. 下载 Windows 版本

从项目发布页面下载发布 ZIP 文件。该软件包面向 Windows x64 和 Blender 4.2 或更高版本。

2. 解除 ZIP 文件阻止

Windows 可能会将下载的 ZIP 文件标记为阻止状态。打开 PowerShell 并运行以下命令；如果文件存储在其他位置，请相应调整路径：

powershell Unblock-File -Path "$HOME\Downloads\blender-unreal-asset-bridge.zip"

3. 从 Blender 首选项中安装

  1. 打开 Blender。
  2. 转到 Edit > Preferences > Get Extensions。
  3. 打开扩展菜单并选择 Install from Disk。
  4. 选择下载的 ZIP 文件。
  5. 启用 blender-unreal-asset-bridge。

启用插件后，打开 Blender 3D 视图，按 N 显示侧栏，然后选择 blender-unreal-asset-bridge 面板。

4. 配置助手连接

选择 AI 服务商，输入连接信息并选择模型。配置面板包含服务商端点和密钥。你可以在 Blender 内发送消息，也可以选择 Open Studio Window。

使用 Studio Window 或外部客户端时，请保持 Blender 运行。两种工作流都会与当前活动的 Blender 会话通信。

准备要导出的场景

将 Blender 场景整理为要发送到 Unreal Engine 的资产和集合。这些内容可能包括环境道具、角色网格体、动画 Action、碰撞对象、插槽、摄像机和影视数据。

导出前，请确定与目标项目匹配的选项：

  • 将目标引擎设为 Unreal Engine 5，或在需要时选择 Unreal Engine 4。生成的导入脚本支持 Unreal Engine 4.26 及更高版本。
  • 标准网格体工作流使用 FBX，缓存和模拟驱动的网格体则选择 Alembic。
  • 将 Unit scale 保持为 Auto，以便将 Blender 单位转换为 Unreal Engine 比例。
  • 将 Axis transform 保持为 Auto，以便根据 Unreal Engine 规范转换旋转、枢轴及其他变换。
  • 单独导出动画时选择 Actions；需要导出一条混合轨道时切换为 NLA。
  • 除非工作流有明确要求，否则启用 Error checker 和 Import script 选项。

执行基本批量导出

导出环境资源包

  1. 标记或选择包含环境道具的集合。
  2. 检查单位比例、轴变换、命名、碰撞体和插槽设置。
  3. 导出前运行错误检查器。
  4. 解决报告的问题，或使用可用的一键修复功能。
  5. 开始批量导出。
  6. 打开生成的输出文件夹，确认资产已按照适用于 Unreal 的文件夹结构排列。

导出会将场景资产写入磁盘，并采用适用于 Unreal Engine 的结构。静态网格体可以包含在 Blender 中创建的碰撞体和插槽，从而避免在引擎中再次构建碰撞体。

导出角色和动画

  1. 选择要导出的骨骼网格和动作。
  2. 对于单独选定的动画，选择 Actions；对于单条混合动画轨道，选择 NLA。
  3. 运行错误检查器，以发现动画、缩放、命名或设置问题。
  4. 开始导出，并检查生成的骨骼网格、骨架、动画和变形目标文件。
  5. 使用生成的导入脚本，重建对应的 Unreal Engine 内容结构。

导出摄像机和电影内容

在导出中包含摄像机绑定及其 Sequencer 内容。生成的 Unreal 导入脚本可以将电影内容重建为 Level Sequence，并保留剪辑、宽高比、焦距和镜头偏移。或者，将摄像机复制到剪贴板，然后直接粘贴到 Unreal Engine Sequencer 中。

将生成的文件导入 Unreal Engine

  1. 打开将接收资产的 Unreal Engine 项目。
  2. 找到插件生成的 Python 导入脚本。
  3. 打开 Unreal Engine Python 控制台。
  4. 运行生成的脚本。
  5. 在内容浏览器中检查重建的文件夹结构和已导入的资产。

生成的脚本需要 Unreal Engine 4.26 或更高版本。如果脚本看起来没有执行任何操作，请确认它是在引擎的 Python 控制台中运行的，并且引擎版本符合要求。

配置参考

  • 目标引擎：默认为 Unreal Engine 5，同时支持 Unreal Engine 4。
  • 导出格式：默认为 FBX；缓存和模拟驱动的网格可使用 Alembic。
  • 单位缩放：默认为自动，将 Blender 单位转换为 Unreal Engine 缩放比例。
  • 轴变换：默认为自动，根据 Unreal Engine 约定调整变换和枢轴。
  • 动画模式：默认为 Actions，混合轨道可使用 NLA。
  • 碰撞形状：方盒、凸体、球体和胶囊体。
  • 导入脚本：默认启用，用于生成 Unreal Engine Python 脚本。
  • 错误检查器：默认启用，用于检查命名、缩放、材质和动画设置。
  • 提供商：默认为兼容 OpenAI 的提供商，可在面板中配置端点 URL 和密钥。
  • 模型：选择用于聊天驱动操作的模型。

高级工作流提示

在排查 Unreal 导入问题前进行验证

每次重要导出前都运行错误检查器。单位、轴、枢轴、命名、材质或动画设置方面的问题，在文件进入引擎前于 Blender 中修复会更容易。可能时，使用检查器的一键修复功能，而不是在 Unreal Engine 中诊断由此产生的导入行为。

将自动变换作为基准

对于大多数项目，请将单位缩放和轴变换保持为 Auto。如果资产以错误的缩放或旋转导入，请重新运行错误检查器，并检查它所指出的对象，而不是手动修正每个导入的资产。

有意选择动画模式

如果希望选定的动画随骨骼网格一起作为独立导出内容传输，请使用 Actions。如果源场景表示一条应导出为组合动画序列的混合轨道，请使用 NLA。

保持命名和目标结构一致

插件会保留命名规范，并创建面向 Unreal 的文件夹树。为网格、碰撞体、插槽、动画和集合使用一致的名称，可让生成的导入脚本更易于检查，也让后续维护内容浏览器更加方便。

使用 AI 助手执行常规操作

配置提供商和模型后，可以在 Blender 中描述命名、检查或导出设置调整等常规任务。通过 Studio Window 或外部客户端工作时，请保持 Blender 打开，以便助手与当前插件会话通信。

故障排除

ZIP 无法安装

使用以下命令解除下载文件的阻止：

powershell Unblock-File -Path "$HOME\Downloads\blender-unreal-asset-bridge.zip"

然后返回 Blender 的扩展安装程序，再次安装 ZIP 文件。

面板缺失

确认已在 Edit > Preferences > Get Extensions 中启用插件。同时确认你在 Windows x64 上使用的是 Blender 4.2 或更高版本。

资产的缩放或旋转不正确

将单位缩放和轴变换保持为 Auto，然后再次运行错误检查器。它会识别破坏变换链的对象。

导入脚本没有任何作用

确认 Unreal Engine 版本为 4.26 或更高版本，并从引擎的 Python 控制台运行生成的脚本。

AI 助手没有响应

检查 N 面板中的提供商端点、API 密钥和模型名称。在 Studio 或外部客户端与插件通信期间，Blender 必须保持打开。

结语

blender-unreal-asset-bridge 将手动的 Blender 到 Unreal 传输过程转变为可重复的流水线。安装 Windows 插件，准备并验证场景，批量导出所需资产，然后运行生成的 Unreal Engine Python 脚本。借助自动变换、由 Blender 创建的碰撞体和插槽、动画支持、电影内容传输以及可选的 AI 辅助，该工作流减少了重复的导入和设置工作，同时将资产准备保留在 Blender 中。