# Tripo3D UE Bridge – Guía del usuario

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

## 1. Elija la versión correcta

Seleccione el paquete del plugin que coincida con su versión de Unreal Engine.

- Para proyectos UE 5.4, use la versión `UE5.4`
- Para proyectos UE 5.5, use la versión `UE5.5`
- Para proyectos UE 5.6, use la versión `UE5.6`
- Para proyectos UE 5.7, use la versión `UE5.7`
- Para proyectos UE 5.8, use la versión `UE5.8`

No mezcle binarios del plugin compilados para diferentes versiones de Unreal Engine. De lo contrario, el plugin podría no cargarse o compilarse correctamente. Si no está seguro de qué paquete usar, elija la versión del plugin que coincida exactamente con la versión menor de su Unreal Engine.

## 2. Dónde colocar el plugin

Extraiga la carpeta del plugin en el directorio `Plugins` de su propio proyecto de Unreal.

Ejemplo de estructura de directorios:

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

Si su proyecto aún no tiene una carpeta `Plugins`, créela manualmente.

## 3. Si utiliza una versión precompilada

Después de colocar la versión correcta del plugin en la carpeta `Plugins`:

1. Abra su archivo `.uproject`
2. Si Unreal le solicita reconstruir los módulos, elija `Yes`
3. Espere a que Unreal o Visual Studio terminen de compilar

## 4. Si necesita compilarlo usted mismo

Asegúrese de que las siguientes herramientas estén instaladas:

1. La versión correspondiente de Unreal Engine
2. Visual Studio 2022
3. Desarrollo de escritorio con C++
4. Desarrollo de juegos con C++
5. Windows SDK

### Pasos de compilación

La distribución del código fuente del plugin debe contener:
`Tripo3DUEBridge.uplugin`
`Config`
`Content`
`ThirdParty`
`Resources`
`Source`

1. Coloque el plugin en `Plugins/Tripo3d_UE_Bridge` dentro de su proyecto de Unreal
2. Haga clic derecho en su `.uproject` y seleccione `Generate Visual Studio project files`
3. Abra el archivo `.sln` generado en Visual Studio
4. Seleccione `Development Editor` y `Win64`
5. Establezca su proyecto de Unreal como proyecto de inicio
6. Compile la solución

También puede hacer doble clic en el archivo `.uproject` y dejar que Unreal detecte el plugin e inicie la compilación automáticamente.

## 5. Estructura de los recursos importados

Los modelos importados a través de Tripo3D se guardan en `Content/TripoModels/` de su proyecto, con cada modelo en su propia subcarpeta:

```text
Content/
  TripoModels/
    Materials/
      M_Tripo_PBR_Master          <- Material PBR maestro (compartido por todos los modelos)
    YourModelName/
      YourModelName               <- Malla (StaticMesh / SkeletalMesh)
      YourModelName_Mat            <- Instancia de material (padre: M_Tripo_PBR_Master)
      Textures/
        YourModelName_basecolor    <- Textura BaseColor
        YourModelName_normal       <- Textura Normal
        YourModelName_roughness    <- Textura Roughness
        YourModelName_metallic     <- Textura Metallic
      Animations/                  <- Recursos de animación (si los hay)
```

## 6. Problemas comunes

### El plugin no aparece

Verifique lo siguiente:

1. La carpeta del plugin está ubicada en el directorio `Plugins` de su proyecto
2. `Tripo3DUEBridge.uplugin` se encuentra en la carpeta raíz del plugin
3. La versión del plugin coincide con su versión de Unreal Engine

### El proyecto no compila

Verifique lo siguiente:

1. Su versión de Unreal Engine coincide con el paquete del plugin
2. Visual Studio 2022 y las herramientas de C++ están instaladas correctamente
3. El Windows SDK correcto está instalado
4. La carpeta del plugin está completa, especialmente `Source` y `ThirdParty`
