# Tripo3D UE Bridge – Benutzerhandbuch

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

## 1. Die passende Version wählen

Bitte wählen Sie das Plugin-Paket, das zu Ihrer Unreal Engine-Version passt.

- Für UE 5.4-Projekte verwenden Sie die Version `UE5.4`
- Für UE 5.5-Projekte verwenden Sie die Version `UE5.5`
- Für UE 5.6-Projekte verwenden Sie die Version `UE5.6`
- Für UE 5.7-Projekte verwenden Sie die Version `UE5.7`
- Für UE 5.8-Projekte verwenden Sie die Version `UE5.8`

Mischen Sie keine Plugin-Binärdateien, die für unterschiedliche Unreal Engine-Versionen erstellt wurden. Andernfalls kann das Plugin möglicherweise nicht geladen oder kompiliert werden. Wenn Sie unsicher sind, welches Paket Sie verwenden sollen, wählen Sie die Plugin-Version, die exakt mit Ihrer Unreal Engine-Nebenversion übereinstimmt.

## 2. Installationsort des Plugins

Entpacken Sie den Plugin-Ordner in das `Plugins`-Verzeichnis Ihres eigenen Unreal-Projekts.

Beispiel für die Verzeichnisstruktur:

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

Falls Ihr Projekt noch keinen `Plugins`-Ordner besitzt, erstellen Sie diesen bitte manuell.

## 3. Wenn Sie eine vorkompilierte Version verwenden

Nachdem Sie die passende Plugin-Version in den `Plugins`-Ordner gelegt haben:

1. Öffnen Sie Ihre `.uproject`-Datei
2. Wenn Unreal Sie auffordert, Module neu zu erstellen, wählen Sie `Yes`
3. Warten Sie, bis Unreal oder Visual Studio die Kompilierung abgeschlossen hat

## 4. Wenn Sie das Plugin selbst erstellen müssen

Bitte stellen Sie sicher, dass folgende Werkzeuge installiert sind:

1. Die passende Version der Unreal Engine
2. Visual Studio 2022
3. Desktopentwicklung mit C++
4. Spieleentwicklung mit C++
5. Windows SDK

### Build-Schritte

Die Quellcode-Version des Plugins sollte Folgendes enthalten:
`Tripo3DUEBridge.uplugin`
`Config`
`Content`
`ThirdParty`
`Resources`
`Source`

1. Legen Sie das Plugin in `Plugins/Tripo3d_UE_Bridge` innerhalb Ihres Unreal-Projekts ab
2. Klicken Sie mit der rechten Maustaste auf Ihre `.uproject`-Datei und wählen Sie `Generate Visual Studio project files`
3. Öffnen Sie die generierte `.sln`-Datei in Visual Studio
4. Wählen Sie `Development Editor` und `Win64`
5. Legen Sie Ihr Unreal-Projekt als Startprojekt fest
6. Erstellen Sie die Lösung

Sie können auch einfach doppelt auf die `.uproject`-Datei klicken und Unreal das Plugin automatisch erkennen und die Kompilierung auslösen lassen.

## 5. Importierte Asset-Struktur

Über Tripo3D importierte Modelle werden unter `Content/TripoModels/` in Ihrem Projekt gespeichert, wobei jedes Modell einen eigenen Unterordner erhält:

```text
Content/
  TripoModels/
    Materials/
      M_Tripo_PBR_Master          <- Master-PBR-Material (von allen Modellen geteilt)
    YourModelName/
      YourModelName               <- Mesh (StaticMesh / SkeletalMesh)
      YourModelName_Mat            <- Materialinstanz (Parent: M_Tripo_PBR_Master)
      Textures/
        YourModelName_basecolor    <- BaseColor-Textur
        YourModelName_normal       <- Normal-Textur
        YourModelName_roughness    <- Roughness-Textur
        YourModelName_metallic     <- Metallic-Textur
      Animations/                  <- Animationsassets (falls vorhanden)
```

## 6. Häufige Probleme

### Das Plugin wird nicht angezeigt

Bitte überprüfen Sie Folgendes:

1. Der Plugin-Ordner befindet sich im `Plugins`-Verzeichnis Ihres Projekts
2. `Tripo3DUEBridge.uplugin` befindet sich im Stammverzeichnis des Plugins
3. Die Plugin-Version stimmt mit Ihrer Unreal Engine-Version überein

### Die Kompilierung des Projekts schlägt fehl

Bitte überprüfen Sie Folgendes:

1. Ihre Unreal Engine-Version stimmt mit dem Plugin-Paket überein
2. Visual Studio 2022 und die C++-Toolchain sind korrekt installiert
3. Das richtige Windows SDK ist installiert
4. Der Plugin-Ordner ist vollständig, insbesondere `Source` und `ThirdParty`
