# Tripo3D UE Bridge – Guide d'utilisation

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

## 1. Choisir la bonne version

Veuillez sélectionner le paquet du plugin correspondant à votre version d'Unreal Engine.

- Pour les projets UE 5.4, utilisez la version `UE5.4`
- Pour les projets UE 5.5, utilisez la version `UE5.5`
- Pour les projets UE 5.6, utilisez la version `UE5.6`
- Pour les projets UE 5.7, utilisez la version `UE5.7`
- Pour les projets UE 5.8, utilisez la version `UE5.8`

Ne mélangez pas les binaires du plugin compilés pour différentes versions d'Unreal Engine. Sinon, le plugin pourrait ne pas se charger ou ne pas compiler. Si vous n'êtes pas sûr du paquet à utiliser, choisissez la version du plugin qui correspond exactement à la version mineure de votre Unreal Engine.

## 2. Où placer le plugin

Extrayez le dossier du plugin dans le répertoire `Plugins` de votre propre projet Unreal.

Exemple de structure de répertoire :

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

Si votre projet n'a pas encore de dossier `Plugins`, créez-en un manuellement.

## 3. Si vous utilisez une version précompilée

Après avoir placé la version correcte du plugin dans le dossier `Plugins` :

1. Ouvrez votre fichier `.uproject`
2. Si Unreal vous demande de reconstruire les modules, choisissez `Yes`
3. Attendez qu'Unreal ou Visual Studio termine la compilation

## 4. Si vous devez le compiler vous-même

Veuillez vous assurer que les outils suivants sont installés :

1. La version correspondante d'Unreal Engine
2. Visual Studio 2022
3. Développement de bureau avec C++
4. Développement de jeux avec C++
5. Windows SDK

### Étapes de compilation

La distribution du code source du plugin doit contenir :
`Tripo3DUEBridge.uplugin`
`Config`
`Content`
`ThirdParty`
`Resources`
`Source`

1. Placez le plugin dans `Plugins/Tripo3d_UE_Bridge` à l'intérieur de votre projet Unreal
2. Faites un clic droit sur votre `.uproject` et sélectionnez `Generate Visual Studio project files`
3. Ouvrez le fichier `.sln` généré dans Visual Studio
4. Sélectionnez `Development Editor` et `Win64`
5. Définissez votre projet Unreal comme projet de démarrage
6. Compilez la solution

Vous pouvez également double-cliquer sur le fichier `.uproject` et laisser Unreal détecter le plugin et déclencher automatiquement la compilation.

## 5. Structure des ressources importées

Les modèles importés via Tripo3D sont enregistrés sous `Content/TripoModels/` dans votre projet, chaque modèle ayant son propre sous-dossier :

```text
Content/
  TripoModels/
    Materials/
      M_Tripo_PBR_Master          <- Matériau PBR principal (partagé par tous les modèles)
    YourModelName/
      YourModelName               <- Maillage (StaticMesh / SkeletalMesh)
      YourModelName_Mat            <- Instance de matériau (parent : M_Tripo_PBR_Master)
      Textures/
        YourModelName_basecolor    <- Texture BaseColor
        YourModelName_normal       <- Texture Normal
        YourModelName_roughness    <- Texture Roughness
        YourModelName_metallic     <- Texture Metallic
      Animations/                  <- Ressources d'animation (le cas échéant)
```

## 6. Problèmes courants

### Le plugin n'apparaît pas

Veuillez vérifier les points suivants :

1. Le dossier du plugin se trouve dans le répertoire `Plugins` de votre projet
2. `Tripo3DUEBridge.uplugin` se trouve dans le dossier racine du plugin
3. La version du plugin correspond à votre version d'Unreal Engine

### La compilation du projet échoue

Veuillez vérifier les points suivants :

1. Votre version d'Unreal Engine correspond au paquet du plugin
2. Visual Studio 2022 et la chaîne d'outils C++ sont correctement installés
3. Le bon Windows SDK est installé
4. Le dossier du plugin est complet, en particulier `Source` et `ThirdParty`
