# SuperCollider

> Componha, renderize, analise e exporte música de jogo portátil com o SuperCollider 3.14.1 no seu computador: partituras como código no seu projeto, renders WAV offline, stems e loops sincronizados, importação de samples, pré-visualização e exportação para Unity, Godot ou Unreal.

- Id: `aigd.supercollider`
- Origem: Oficial (de primeira parte `aigd.*`)
- Categoria: Áudio
- Publicador: AI Game Dev (`aigd`), verificado
- Versão mais recente: 0.1.12 (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.supercollider

## Instalar

Com o CLI gamedev, na pasta do projeto:

```bash
gamedev pkg add aigd.supercollider
```

No app desktop: abra a janela Packages (o ícone de pacote na barra de status), selecione **Browse**, busque `aigd.supercollider` 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 |
|---|---|---|---|
| 0.1.12 | 2026-11-22 | `>=0.25.11` | mais recente |
| 0.1.11 | 2026-11-19 | `>=0.25.11` | - |
| 0.1.10 | 2026-11-13 | `>=0.25.11` | - |
| 0.1.9 | 2026-11-06 | `>=0.25.11` | - |
| 0.1.8 | 2026-11-06 | `>=0.25.11` | - |
| 0.1.7 | 2026-11-01 | `>=0.25.11` | - |
| 0.1.5 | 2026-10-13 | `>=0.20.0` | - |
| 0.1.4 | 2026-10-09 | `>=0.20.0` | - |
| 0.1.2 | 2026-10-05 | `>=0.20.0` | - |
| 0.1.1 | 2026-10-01 | `>=0.20.0` | - |

## Descrição

````markdown
# SuperCollider (`aigd.supercollider`)

Componha, renderize, analise e exporte música de jogo portátil com o agente do AI Game Dev e o [SuperCollider](https://supercollider.github.io). O agente escreve partituras SuperCollider (`.scd`) no seu projeto, renderiza-as offline para WAV no seu computador, deixa você pré-visualizar o resultado e exporta-o para o seu projeto Unity, Godot ou Unreal. Tudo roda localmente e não consome nada da sua cota do AI Game Dev. É indicado para desenvolvedores de jogos que querem música, loops, stems e efeitos como código-fonte editável que permanece no controle de versão, e não apenas como arquivos de áudio finalizados.

## O que você pode fazer

- Componha temas, loops e stingers como código SuperCollider que você pode ler, editar e renderizar novamente.
- Renderize stems sincronizados (por exemplo, percussão e melodia) com a mesma duração e as mesmas configurações, para música em camadas ou adaptativa.
- Use seus próprios samples: importe um WAV e toque-o a partir de uma partitura.
- Verifique um render: duração, taxa de amostragem, canais, pico, RMS e clipping.
- Pré-visualize um render no app e depois exporte o WAV para a pasta de áudio da sua engine.

## Exemplos de pedidos

- "Componha um tema de exploração suave de oito segundos, renderize-o e exporte-o para o jogo."
- "Faça um loop de percussão contínuo de 2 segundos em 48 kHz estéreo e um stem de baixo correspondente."
- "Importe `Recordings/door.wav` como sample e crie a partir dele um efeito curto de porta com eco."
- "Analise o último render: algo está com clipping?"

## Como funciona

O pacote adiciona a capacidade **Música** (faz parte do grupo Áudio do chat em Ferramentas; acompanha a opção Áudio). A tela de Modelos do projeto ("SuperCollider (music)") decide se o agente pode usá-la. O agente recebe estas ferramentas:

| Ferramenta | O que ela faz |
|---|---|
| `status`, `get_guide` | Status de runtime e o guia de autoria. |
| `init_project` | Cria a árvore de autoria `AudioSource` e copia partituras de exemplo testadas, nunca sobrescrevendo suas composições. |
| `import_sample` | Copia um WAV do projeto para os samples (PCM little-endian, mono ou estéreo, 16/24/32 bits, 8–192 kHz) e registra seu SHA-256. |
| `render`, `get_render_status`, `cancel_render` | Renderiza uma partitura offline como um job deste chat, acompanha-o e cancela-o. |
| `analyze_audio` | Duração, taxa, canais, bits, pico, RMS e clipping de um WAV. |
| `preview` | Uma cópia de pré-visualização curta e completa, aberta no app desktop (a CLI retorna o caminho dela). |
| `export_to_game` | Exporta um render finalizado para o projeto do jogo. |

O agente edita as partituras com suas ferramentas de arquivo comuns. Cada partitura `.scd` retorna um `Score`; o executor a renderiza com um `scsynth` novo em modo não em tempo real. Os renders são WAV PCM16 mono ou estéreo a 44100, 48000 ou 96000 Hz, no máximo 600 segundos, cortados na contagem exata de frames da duração solicitada, sem normalização. Uma seed torna repetível a aleatoriedade do lado da linguagem da composição; não se promete que os resultados sejam idênticos bit a bit entre plataformas. O pacote não faz síntese ao vivo nem instala Quarks ou plugins.

Quatro partituras de exemplo mostram notas de synth melódicas (`music.scd`), um instrumento com cauda de eco (`effect.scd`), um sample estéreo (`sample.scd`) e um stem de percussão alinhado (`loop-stem.scd`).

### Para onde vão as exportações

| Projeto | Exportação |
|---|---|
| Unity | `Assets/Audio`, mantendo um arquivo `.meta` existente e seu GUID. |
| Godot | `res://Audio/`; `AudioSource` recebe um `.gdignore` para que o Godot o ignore. |
| Unreal | Importado para `/Game/Audio` pelo editor conectado; se o editor não confirmar a importação, você recebe o caminho do WAV para importar por conta própria. |
| Projetos sem engine | Arquivos WAV em `AudioSource/exports`. |

Mantenha `AudioSource` (partituras, instrumentos, efeitos, samples, presets, `audio-project.json`, `dependencies.lock`) no controle de versão; os renders são descartáveis.

No app desktop, duas dicas aparecem em um chat ocioso conectado a um editor Unity, Godot ou Unreal: uma para ativar Música, depois outra oferecendo um tema de exemplo de oito segundos ou a sua própria ideia. `/supercollider [status|guide]` mostra o status e o guia.

## Runtime e requisitos

- **SuperCollider 3.14.1**, baixado da release oficial no GitHub na primeira vez que for necessário e verificado contra um SHA-256 fixado: o ZIP no Windows x64, o DMG no macOS. Ativar o pacote não baixa nada.
- **Linux:** o SuperCollider não publica build portátil para Linux. Defina `runtimePath` para uma instalação compatível do SuperCollider 3.14.1, ou `stagedArtifact` para um descritor de artefato revisado (versão, plataforma, URL, SHA-256, formato `tar`).
- Cada job roda apenas com a biblioteca de classes padrão e plugins; seus arquivos de inicialização do SuperCollider e a configuração do home não são carregados nem alterados. O código das partituras é código confiável, não um sandbox de segurança.
- AI Game Dev 0.25.11 ou mais recente.

## Licença

Este pacote: Apache-2.0. O SuperCollider é software livre distribuído por seu projeto sob a GNU GPL. O avatar do pacote é o logotipo oficial do SuperCollider; a marca pertence ao seu proprietário.
````
