# Tripo3D UE Bridge – Guia do usuário

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

## 1. Escolha a versão correta

Selecione o pacote do plugin que corresponde à sua versão do Unreal Engine.

- Para projetos UE 5.4, use a versão `UE5.4`
- Para projetos UE 5.5, use a versão `UE5.5`
- Para projetos UE 5.6, use a versão `UE5.6`
- Para projetos UE 5.7, use a versão `UE5.7`
- Para projetos UE 5.8, use a versão `UE5.8`

Não misture binários do plugin compilados para diferentes versões do Unreal Engine. Caso contrário, o plugin poderá não carregar ou não compilar. Se você não tiver certeza de qual pacote usar, escolha a versão do plugin que corresponda exatamente à versão menor do seu Unreal Engine.

## 2. Onde colocar o plugin

Extraia a pasta do plugin para o diretório `Plugins` do seu próprio projeto Unreal.

Exemplo de estrutura de diretórios:

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

Se o seu projeto ainda não tiver uma pasta `Plugins`, crie uma manualmente.

## 3. Se você estiver usando uma versão pré-compilada

Após colocar a versão correta do plugin na pasta `Plugins`:

1. Abra o seu arquivo `.uproject`
2. Se o Unreal solicitar a reconstrução dos módulos, escolha `Yes`
3. Aguarde o Unreal ou o Visual Studio concluir a compilação

## 4. Se você precisar compilar por conta própria

Certifique-se de que as seguintes ferramentas estejam instaladas:

1. A versão correspondente do Unreal Engine
2. Visual Studio 2022
3. Desenvolvimento para desktop com C++
4. Desenvolvimento de jogos com C++
5. Windows SDK

### Etapas de compilação

A distribuição do código-fonte do plugin deve conter:
`Tripo3DUEBridge.uplugin`
`Config`
`Content`
`ThirdParty`
`Resources`
`Source`

1. Coloque o plugin em `Plugins/Tripo3d_UE_Bridge` dentro do seu projeto Unreal
2. Clique com o botão direito no seu `.uproject` e selecione `Generate Visual Studio project files`
3. Abra o arquivo `.sln` gerado no Visual Studio
4. Selecione `Development Editor` e `Win64`
5. Defina seu projeto Unreal como projeto de inicialização
6. Compile a solução

Você também pode clicar duas vezes no arquivo `.uproject` e deixar o Unreal detectar o plugin e iniciar a compilação automaticamente.

## 5. Estrutura dos recursos importados

Os modelos importados via Tripo3D são salvos em `Content/TripoModels/` no seu projeto, com cada modelo em sua própria subpasta:

```text
Content/
  TripoModels/
    Materials/
      M_Tripo_PBR_Master          <- Material PBR principal (compartilhado por todos os modelos)
    YourModelName/
      YourModelName               <- Malha (StaticMesh / SkeletalMesh)
      YourModelName_Mat            <- Instância de material (pai: M_Tripo_PBR_Master)
      Textures/
        YourModelName_basecolor    <- Textura BaseColor
        YourModelName_normal       <- Textura Normal
        YourModelName_roughness    <- Textura Roughness
        YourModelName_metallic     <- Textura Metallic
      Animations/                  <- Recursos de animação (se houver)
```

## 6. Problemas comuns

### O plugin não aparece

Verifique o seguinte:

1. A pasta do plugin está localizada no diretório `Plugins` do seu projeto
2. `Tripo3DUEBridge.uplugin` está localizado na pasta raiz do plugin
3. A versão do plugin corresponde à sua versão do Unreal Engine

### O projeto falha ao compilar

Verifique o seguinte:

1. Sua versão do Unreal Engine corresponde ao pacote do plugin
2. O Visual Studio 2022 e as ferramentas C++ estão instalados corretamente
3. O Windows SDK correto está instalado
4. A pasta do plugin está completa, especialmente `Source` e `ThirdParty`
