---
title: "Importar um pacote pela Biblioteca"
version: snapshot-2026-10-28
engineGeneration: astra-current
language: C#
status: source-reviewed
reviewedAt: 2026-10-26
appRelease: "0.4.0-preview.20261028"
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/guia/importar/biblioteca-de-pacotes/
---

# Importar um pacote pela Biblioteca

Passo a passo para trazer uma pasta de pacote (por exemplo, um pacote Unity extraído): catalogar, revisar, preparar o perfil e pôr na cena.

> **Validado no aparelho** · APK 0.4.0 · fluxo usado no POCO F7 com pacotes de teste em 16 e 19/10

## 1. Ter a pasta no celular

Copie a pasta do pacote para o aparelho (por exemplo, `/sdcard/Astra/Pacotes/MeuPacote`). Se for um `.unitypackage`, extraia antes no computador.

## 2. Importar

Barra superior › **Importar** › **Pasta de pacote** › escolha a pasta no seletor do Android. A Astra copia e cataloga cada arquivo: "Pacote preservado e catalogado; conversões são ações explícitas por item." Nada é convertido ainda.

## 3. A Biblioteca



- O **trilho de tipos** filtra: Todos, Modelos, Clipes, Materiais, Texturas, Prefabs, Cenas, Código, Documentos, Outros, Controllers, Projeto.
- Cada cartão tem um selo: ✓ pronto, ⤓ a converter, ⚠ recusado (≈ quando é aproximado).
- O cartão **Materiais Unity** mostra **Completos**, **Aproximados** e **Sem conversão**; tocar num bloco filtra a lista.

## 4. Um modelo: revisar e preparar

Toque o modelo › **Abrir**. O importador abre com as abas Resumo, Estrutura, Malhas, Texturas, **Perfil** e Rig/Takes.



No **Perfil** (páginas com Anterior / Próxima): Escala, Textura máxima, Compressão (ASTC), Normais, Tangentes, LOD, **Gerar UV de lightmap** e, no FBX, **FBX rig/takes/morph**, **Mais de 4 influências** (Reduzir top 4 ou Recusar perda), Steps e a taxa de Bake dos takes. Depois toque **Preparar**. Mudar o perfil depois pede preparar de novo.

## 5. Publicar

Nas outras abas: **Só recurso** (fica no projeto) ou **Na cena** (põe na cena). Se a estrutura for ambígua, escolha **Pela ordem** ou **Como novos**.

## 6. Efeitos prontos (prefabs de partícula)

Toque um prefab de efeito › **Abrir**. A Astra converte em cascata o que ele usa: materiais, sons WAV, prefabs de impacto e a malha das partículas. O resultado é um prefab Astra com **Sistema de partículas** e, conforme o efeito, **Linha**, **Laser**, **Projétil**, **Instanciar ao colidir**, **Som repetido**, **Girar** ou **Seguir câmera**. Ponha **Na cena** e aperte **Play**.

- Para ouvir os sons 3D, a cena precisa de um **Ouvinte de áudio**: o projeto novo já traz um na Main Camera, e sem Ouvinte o Play ouve pela câmera do jogo.
- O que não converte aparece no detalhe do item como perda ou aproximação; o efeito abre sem a parte que faltou.
- Nenhum asset de pacote vem com a Astra: você importa os pacotes que tem.

## 7. Materiais, clipes, prefabs e controllers

`.mat`, `.anim`, `.prefab` e `.controller` convertem ao tocar **Abrir**. Para um clipe Humanoid, selecione antes o personagem na cena. Um prefab precisa das malhas e materiais já convertidos ("Converta primeiro a dependência pela Biblioteca").

## Se algo não converter

O detalhe do item mostra o motivo em chips (Conversão…, Aproximação…). As fontes ficam preservadas: dá para reimportar depois que a Astra ganhar o conversor.