# Tripo3D UE Bridge 使用说明

> 📖 官方教程: [Tripo DCC Bridge for UE](https://www.tripo3d.ai/blog/tripo-dcc-bridge-for-ue)

## 1. 选择对应版本

请根据你自己的 Unreal Engine 版本选择对应的插件版本。

- UE 5.4 项目：请选择 `UE5.4` 版本
- UE 5.5 项目：请选择 `UE5.5` 版本
- UE 5.6 项目：请选择 `UE5.6` 版本
- UE 5.7 项目：请选择 `UE5.7` 版本
- UE 5.8 项目：请选择 `UE5.8` 版本

不要混用不同 Unreal Engine 版本的插件二进制文件，否则插件可能无法加载或编译失败。如果你不确定该选择哪个包，请优先使用与你当前 Unreal Engine 小版本完全一致的插件版本。

## 2. 插件安装位置

将解压后的插件文件夹放到你自己项目的 `Plugins` 目录下。

目录结构示例：

```text
YourProject/
  Plugins/
    Tripo3DUEBridge-UE5.7-Win64/
      Tripo3DUEBridge.uplugin
      Source/
      Config/
      Content/
      ThirdParty/
      Resources/
```

如果你的项目中还没有 `Plugins` 文件夹，可以手动创建。

## 3. 如果你使用的是已编译版本

将对应版本的插件放入 `Plugins` 目录后：

1. 打开你的 `.uproject`
2. 如果 Unreal 提示需要重建模块，选择 `Yes`
3. 等待 Unreal 或 Visual Studio 完成编译

## 4. 如果你需要自己编译

请确保本机已经安装以下环境：

1. 对应版本的 Unreal Engine
2. Visual Studio 2022
3. 使用 C++ 的桌面开发组件
4. 游戏开发 C++ 组件
5. Windows SDK

### 编译步骤

源码分发时插件目录应包含：
`Tripo3DUEBridge.uplugin`
`Config`
`Content`
`ThirdParty`
`Resources`
`Source`

1. 将插件放到你自己项目的 `Plugins/Tripo3d_UE_Bridge` 目录
2. 右键你的 `.uproject`，选择 `Generate Visual Studio project files`
3. 使用 Visual Studio 打开生成的 `.sln`
4. 选择 `Development Editor` 和 `Win64`
5. 将你的 Unreal 项目设置为启动项目
6. 执行编译

你也可以直接双击 `.uproject`，让 Unreal 自动检测插件并触发编译。

## 5. 导入资产说明

通过 Tripo3D 导入的模型会保存在项目的 `Content/TripoModels/` 目录下，每个模型有独立的子文件夹：

```text
Content/
  TripoModels/
    Materials/
      M_Tripo_PBR_Master          ← PBR 父级材质（所有模型共用）
    YourModelName/
      YourModelName               ← 网格体（StaticMesh / SkeletalMesh）
      YourModelName_Mat            ← 材质实例（继承自 M_Tripo_PBR_Master）
      Textures/
        YourModelName_basecolor    ← BaseColor 贴图
        YourModelName_normal       ← Normal 贴图
        YourModelName_roughness    ← Roughness 贴图
        YourModelName_metallic     ← Metallic 贴图
      Animations/                  ← 动画资产（如有）
```

## 6. 常见问题

### 插件没有显示

请确认：

1. 插件目录已放在你自己项目的 `Plugins` 下
2. `Tripo3DUEBridge.uplugin` 位于插件根目录
3. 插件版本与你的 Unreal Engine 版本一致

### 打开项目时提示编译失败

请检查：

1. Unreal Engine 版本是否与插件包匹配
2. Visual Studio 2022 和 C++ 工具链是否完整安装
3. 是否安装了正确的 Windows SDK
4. 插件目录是否完整，尤其是 `Source` 和 `ThirdParty`
