# 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. プラグインの配置場所

解凍したプラグインフォルダを、あなたの Unreal プロジェクト内の `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. Desktop development with C++
4. Game development with C++
5. Windows SDK

### ビルド手順

ソース配布時にプラグインディレクトリには以下が含まれている必要があります：
`Tripo3DUEBridge.uplugin`
`Config`
`Content`
`ThirdParty`
`Resources`
`Source`

1. プラグインを Unreal プロジェクト内の `Plugins/Tripo3d_UE_Bridge` に配置します
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` が含まれていること
