# 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` 가 포함되어 있는지
