# Blender

> Crie e edite modelos 3D em um Blender de verdade pelo chat: encontra ou instala o Blender, instala o add-on MCP for Blender e o conecta ao agente por projeto. Faça props, blockouts e assets low-poly, exporte-os para o seu projeto Unity, Godot ou Unreal e visualize-os.

- Id: `aigd.blender`
- Origem: Oficial (de primeira parte `aigd.*`)
- Categoria: 3D
- Publicador: AI Game Dev (`aigd`), verificado
- Versão mais recente: 1.2.16 (publicado em 2026-11-22)
- Licença: Apache-2.0
- Requer o app AI Game Dev: `>=0.25.11`
- Código nativo: não
- Avaliação: ainda sem avaliações
- Página HTML: https://ai-game.dev/pt-br/packages/aigd.blender

## Instalar

Com o CLI gamedev, na pasta do projeto:

```bash
gamedev pkg add aigd.blender
```

No app desktop: abra a janela Packages (o ícone de pacote na barra de status), selecione **Browse**, busque `aigd.blender` e clique em **Add to Project**. Mais: https://ai-game.dev/docs/wiki/app/packages

## Versões

| Versão | Publicado | Requer o app | Observações |
|---|---|---|---|
| 1.2.16 | 2026-11-22 | `>=0.25.11` | mais recente |
| 1.2.15 | 2026-11-19 | `>=0.25.11` | - |
| 1.2.14 | 2026-11-13 | `>=0.25.11` | - |
| 1.2.13 | 2026-11-13 | `>=0.25.11` | - |
| 1.2.11 | 2026-11-06 | `>=0.25.11` | - |
| 1.2.10 | 2026-11-01 | `>=0.25.11` | - |
| 1.2.4 | 2026-10-15 | `>=0.18.0` | - |
| 1.2.3 | 2026-10-13 | `>=0.18.0` | - |
| 1.2.2 | 2026-09-30 | `>=0.18.0` | - |

## Descrição

````markdown
# Blender (`aigd.blender`)

Conecta um Blender de verdade ao agente do AI Game Dev, para você criar e editar modelos 3D pedindo no chat. O pacote encontra o Blender no seu computador ou instala uma cópia portátil, instala o add-on MCP for Blender e o conecta ao agente para o projeto atual. Ele é indicado para desenvolvedores de jogos que querem props, blockouts, assets low-poly e edições de cena feitos no Blender e salvos direto no seu projeto Unity, Godot ou Unreal.

## O que você pode fazer

- Peça um modelo 3D e o agente o constrói no Blender, exporta para o seu projeto e mostra na pré-visualização do app.
- Crie, altere e exclua objetos, e aplique materiais e cores, em uma cena do Blender.
- Deixe o agente inspecionar a cena atual e executar código Python dentro do Blender para fazer o que o pedido exigir.
- Abra um arquivo `.blend` existente e continue trabalhando nele com o agente.
- Feche o Blender a qualquer momento: o próximo pedido que precisar dele inicia o Blender de novo.

## Exemplos de pedidos

- "Usando o Blender, modele um baú de tesouro low-poly com corpo de madeira, faixas de metal escuro e uma pequena fechadura dourada, exporte como .glb para o projeto e mostre na pré-visualização."
- "Abra `Art/level-01.blend` e adicione seis caixotes e dois barris perto do portão."
- "Faça um blockout simples de uma casa de dois andares para o meu nível, com cerca de 8 por 6 metros."
- "Dê a cada pedra da cena um material verde musgoso."

## Como funciona

Execute `/blender` no chat uma vez por projeto; depois disso, o **Blender** pode ser ativado para um chat pelo botão Ferramentas. Configuração:

1. Encontra o Blender neste computador: `BLENDER_BIN`, os downloads do próprio app, `PATH`, bibliotecas do Steam e os locais de instalação usuais de cada sistema operacional (Program Files, o alias da Microsoft Store e o registro no Windows; `/Applications` e o Spotlight no macOS; `/usr/bin`, snap, flatpak e `/opt` no Linux). Cada candidato é verificado com `blender --version`. É necessário o Blender 4.2 LTS ou mais recente.
2. Se nenhum for utilizável, baixa um Blender portátil (5.2.2; 4.5.14 em Macs Intel, porque o Blender 5.x é distribuído para macOS apenas em Apple silicon), verificado com um SHA-256 fixado.
3. Baixa o [uv](https://github.com/astral-sh/uv) 0.12.19 (SHA-256 fixado), que traz o próprio Python, então você não precisa de Python no sistema.
4. Instala o add-on do [MCP for Blender](https://github.com/ahujasid/blender-mcp) (`mcp-for-blender` 2.0.4, MIT): o servidor MCP e o add-on vêm de uma única versão fixada.
5. Registra o servidor MCP `blender` apenas para o projeto atual (o Blender é conectado por projeto) e então abre o Blender atrás da sua janela, para que ele não roube o foco.

O add-on escuta na porta 9876 do seu computador. O MCP for Blender upstream lista comunicação bidirecional, manipulação de objetos, controle de materiais, inspeção de cena e execução de código Python, além das integrações de assets e modelos descritas na documentação dele.

### O comando `/blender`

| Comando | O que faz |
|---|---|
| `/blender` | Configura e abre o Blender (encontra ou instala o Blender, instala o add-on e o conecta). |
| `/blender setup [options]` | Configura sem abrir o Blender. `--blender <path>` usa um Blender que você escolher; `--reinstall` reinstala o add-on; `--no-download` nunca baixa o Blender; `--safe` restringe o Python do agente no Blender a um subconjunto seguro. |
| `/blender open [file.blend]` | Abre o Blender, opcionalmente com um arquivo `.blend`. |
| `/blender status` | O que está configurado e se o Blender está conectado. |
| `/blender find` | Lista todos os Blender deste computador. |
| `/blender remove [--addon] [--files] [--all]` | Desconecta o Blender do agente; `--addon` também remove o add-on do Blender, `--files` apaga o que o app baixou, `--all` faz as duas coisas. |

O app desktop também mostra duas dicas: uma para ativar o Blender pelo botão Ferramentas em um projeto 3D, e "Blender está pronto" com um prompt de exemplo já pronto (um baú de tesouro low-poly).

## Requisitos

- Blender 4.2 LTS ou mais recente, ou deixe o app baixar um Blender portátil (Windows x64 e arm64, macOS em Apple silicon e Intel, Linux x64; Linux arm64 não tem build oficial do Blender).
- Um projeto aberto: o Blender é conectado ao agente por projeto.
- AI Game Dev 0.25.11 ou mais recente.

## Licença

Este pacote: Apache-2.0. MCP for Blender (`mcp-for-blender`): MIT. O Blender é software livre da Blender Foundation sob a GNU GPL. O avatar do pacote é o ícone oficial do Blender; a marca Blender pertence à Blender Foundation. Esta é uma integração de terceiros, não feita pela Blender Foundation.
````
