SuperCollider
gamedev pkg add aigd.supercolliderVisão geral
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.
Componha, renderize, analise e exporte música de jogo portátil com o agente do AI Game Dev e o SuperCollider. 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.wavcomo 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
runtimePathpara uma instalação compatível do SuperCollider 3.14.1, oustagedArtifactpara um descritor de artefato revisado (versão, plataforma, URL, SHA-256, formatotar). - 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.
Versões
| Versão | Lançamento | Requer o app |
|---|---|---|
| 0.1.12Mais recente | 0.25.11 ou mais recente | |
| 0.1.11 | 0.25.11 ou mais recente | |
| 0.1.10 | 0.25.11 ou mais recente | |
| 0.1.9 | 0.25.11 ou mais recente | |
| 0.1.8 | 0.25.11 ou mais recente | |
| 0.1.7 | 0.25.11 ou mais recente | |
| 0.1.5 | 0.20.0 ou mais recente | |
| 0.1.4 | 0.20.0 ou mais recente | |
| 0.1.2 | 0.20.0 ou mais recente | |
| 0.1.1 | 0.20.0 ou mais recente |
Instalar
No app para desktop
Abra a janela Pacotes (o ícone de pacote na barra de status), selecione Explorar, pesquise aigd.supercollider e clique em Adicionar ao projeto.
Ainda sem o app? Baixe o AI Game Dev grátis para Windows, macOS ou Linux.
Pelo terminal
Com a CLI gamedev, na pasta do seu projeto:
gamedev pkg add aigd.supercolliderRequisitos
- AI Game Dev 0.25.11 ou mais recente
gamedev pkg add aigd.supercollider