> For the complete documentation index, see [llms.txt](https://as0-10.gitbook.io/as-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://as0-10.gitbook.io/as-docs/instalacao.md).

# Instalação

## Instalação dos add-ons

Os add-ons da ASTools são distribuídos em arquivos `.zip` e podem ser instalados diretamente no Blender. Não é necessário descompactar os arquivos.

### Requisitos

* Blender 5.2
* Windows, macOS ou Linux
* Um ou mais add-ons ASTools em formato `.zip`

Os add-ons não precisam de conexão com a internet para funcionar. A internet somente é utilizada quando o usuário abre voluntariamente os links de documentação, site ou termos de uso.

### Instalação

1. Faça o download do add-on desejado.
2. Abra o Blender.
3. Acesse **Edit → Preferences**.
4. Entre na seção **Add-ons**.
5. Abra o menu localizado no canto superior direito.
6. Selecione **Install from Disk**.
7. Escolha o arquivo `.zip` do add-on.
8. Confirme a instalação.
9. Pesquise por `ASTools`.
10. Ative o add-on instalado.

> Não descompacte o arquivo `.zip` antes da instalação.

### Onde encontrar as ferramentas

Após ativar o add-on:

1. Volte para a Viewport 3D.
2. Pressione `N` para abrir a barra lateral.
3. Selecione a aba **ASTools**.

Todos os add-ons instalados aparecem dentro dessa mesma aba, cada um em seu próprio painel:

* **Entrega**
* **Animação**
* **Referência**

Você pode instalar e utilizar os três add-ons ao mesmo tempo.

### Atualização

Antes de instalar uma versão mais recente:

1. Acesse **Edit → Preferences → Add-ons**.
2. Pesquise por `ASTools`.
3. Desative a versão anterior.
4. Abra as opções do add-on e selecione **Remove**.
5. Feche e abra novamente o Blender.
6. Instale o novo arquivo `.zip`.
7. Ative novamente o add-on.

Remover o add-on não apaga seus arquivos `.blend`.

> Confira sempre o número da versão exibido no topo do painel ASTools após uma atualização.

### Solução de problemas

#### O add-on não aparece na aba ASTools

Verifique se ele está ativado em **Edit → Preferences → Add-ons**. Depois, volte para a Viewport 3D e pressione `N`.

#### O Blender não aceita o arquivo

Confirme se você selecionou o arquivo `.zip` original. Não selecione a pasta extraída ou o arquivo `__init__.py`.

#### A versão anterior continua aparecendo

Remova a instalação anterior, reinicie o Blender e instale novamente o ZIP atualizado.

#### O painel lateral não está visível

Posicione o cursor sobre a Viewport 3D e pressione `N`.

#### O add-on apresenta um erro

Registre as seguintes informações:

* Nome do add-on
* Versão do add-on
* Versão do Blender
* Ação realizada antes do erro
* Captura completa da mensagem exibida

Essas informações ajudam a identificar e corrigir o problema com mais rapidez.

### Compatibilidade

As versões atuais foram desenvolvidas para o Blender 5.2. O funcionamento em versões anteriores ou futuras não é garantido.

### Suporte

Para dúvidas, consulte a seção **Perguntas frequentes** desta documentação.

© 2026 André Souza da Silva · ASTools.