# 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` вашего собственного проекта Unreal.

Пример структуры каталогов:

```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` внутри вашего проекта Unreal
2. Щёлкните правой кнопкой мыши по вашему `.uproject` и выберите `Generate Visual Studio project files`
3. Откройте сгенерированный файл `.sln` в Visual Studio
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`
