# SuperCollider

> Compón, renderiza, analiza y exporta música portable para juegos con SuperCollider 3.14.1 en tu equipo: partituras como código en tu proyecto, renders WAV sin conexión, stems y bucles sincronizados, importación de samples, vista previa y exportación a Unity, Godot o Unreal.

- Id: `aigd.supercollider`
- Origen: Oficial (propio `aigd.*`)
- Categoría: Audio
- Editor: AI Game Dev (`aigd`), verificado
- Última versión: 0.1.12 (publicado el 2026-11-22)
- Licencia: Apache-2.0
- Requiere la app AI Game Dev: `>=0.25.11`
- Código nativo: no
- Valoración: aún sin valoraciones
- Página HTML: https://ai-game.dev/es/packages/aigd.supercollider

## Instalar

Con la CLI gamedev, en la carpeta del proyecto:

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

En la app de escritorio: abre la ventana Packages (el icono de paquete en la barra de estado), selecciona **Browse**, busca `aigd.supercollider` y haz clic en **Add to Project**. Más: https://ai-game.dev/docs/wiki/app/packages

## Versiones

| Versión | Publicado | Requiere app | Notas |
|---|---|---|---|
| 0.1.12 | 2026-11-22 | `>=0.25.11` | la más reciente |
| 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` | - |

## Descripción

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

Compón, renderiza, analiza y exporta música portable para juegos con el agente de AI Game Dev y [SuperCollider](https://supercollider.github.io). El agente escribe partituras de SuperCollider (`.scd`) en tu proyecto, las renderiza a WAV sin conexión en tu equipo, te deja previsualizar el resultado y lo exporta a tu proyecto de Unity, Godot o Unreal. Todo se ejecuta en local y no consume nada de tu cuota de AI Game Dev. Está pensado para desarrolladores de juegos que quieren música, bucles, stems y efectos como código fuente editable que se queda en el control de versiones, no solo como archivos de audio terminados.

## Qué puedes hacer

- Compón temas, bucles y stingers como código de SuperCollider que puedes leer, editar y volver a renderizar.
- Renderiza stems sincronizados (por ejemplo, percusión y melodía) con la misma duración y los mismos ajustes, para música por capas o adaptativa.
- Usa tus propios samples: importa un WAV y reprodúcelo desde una partitura.
- Revisa un render: duración, frecuencia de muestreo, canales, pico, RMS y clipping.
- Previsualiza un render en la app y luego exporta el WAV a la carpeta de audio de tu motor.

## Ejemplos de peticiones

- "Compón un tema de exploración tranquilo de ocho segundos, renderízalo y expórtalo al juego."
- "Crea un bucle de percusión continuo de 2 segundos a 48 kHz en estéreo y un stem de bajo a juego."
- "Importa `Recordings/door.wav` como sample y crea a partir de él un efecto de puerta corto con eco."
- "Analiza el último render: ¿hay algo que haga clipping?"

## Cómo funciona

El paquete añade la capacidad **Music** (forma parte del grupo Audio del chat en Herramientas; cambia junto con Audio). La pantalla de modelos del proyecto ("SuperCollider (music)") decide si el agente puede usarla. El agente dispone de estas herramientas:

| Herramienta | Qué hace |
|---|---|
| `status`, `get_guide` | Estado del entorno de ejecución y la guía de autoría. |
| `init_project` | Crea el árbol de autoría `AudioSource` y copia partituras de ejemplo probadas, sin sobrescribir nunca tus composiciones. |
| `import_sample` | Copia un WAV del proyecto a los samples (PCM little-endian, mono o estéreo, 16/24/32 bits, 8–192 kHz) y registra su SHA-256. |
| `render`, `get_render_status`, `cancel_render` | Renderiza una partitura sin conexión como un trabajo de este chat, síguelo y cancélalo. |
| `analyze_audio` | Duración, frecuencia, canales, bits, pico, RMS y clipping de un WAV. |
| `preview` | Una copia de vista previa corta y completa, abierta en la app de escritorio (la CLI devuelve su ruta). |
| `export_to_game` | Exporta un render terminado al proyecto del juego. |

El agente edita las partituras con sus herramientas de archivos habituales. Cada partitura `.scd` devuelve un `Score`; el runner la renderiza con un `scsynth` nuevo en modo no en tiempo real. Los renders son WAV PCM16 mono o estéreo a 44100, 48000 o 96000 Hz, de 600 segundos como máximo, recortados al número exacto de frames de la duración solicitada y sin normalización. Una semilla hace repetible la aleatoriedad del lado del lenguaje de la composición; no se promete que los resultados sean idénticos bit a bit entre plataformas. El paquete no hace síntesis en vivo ni instala Quarks ni plugins.

Cuatro partituras de ejemplo muestran notas de sintetizador melódicas (`music.scd`), un instrumento con cola de eco (`effect.scd`), un sample estéreo (`sample.scd`) y un stem de percusión alineado (`loop-stem.scd`).

### Adónde van las exportaciones

| Proyecto | Exportación |
|---|---|
| Unity | `Assets/Audio`, conservando el archivo `.meta` existente y su GUID. |
| Godot | `res://Audio/`; `AudioSource` recibe un `.gdignore` para que Godot lo omita. |
| Unreal | Se importa a `/Game/Audio` a través del editor conectado; si el editor no confirma la importación, obtienes la ruta del WAV para importarlo tú. |
| Proyectos sin motor | Archivos WAV en `AudioSource/exports`. |

Mantén `AudioSource` (partituras, instrumentos, efectos, samples, presets, `audio-project.json`, `dependencies.lock`) en el control de versiones; los renders son desechables.

En la app de escritorio aparecen dos consejos en un chat inactivo conectado a un editor de Unity, Godot o Unreal: uno para activar Music y luego otro que ofrece un tema de ejemplo de ocho segundos o tu propia idea. `/supercollider [status|guide]` muestra el estado y la guía.

## Entorno de ejecución y requisitos

- **SuperCollider 3.14.1**, descargado de la release oficial de GitHub la primera vez que se necesita y verificado contra un SHA-256 fijado: el ZIP en Windows x64 y el DMG en macOS. Activar el paquete no descarga nada.
- **Linux:** SuperCollider no publica ninguna compilación portátil para Linux. Define `runtimePath` como una instalación compatible de SuperCollider 3.14.1, o `stagedArtifact` como un descriptor de artefacto revisado (versión, plataforma, URL, SHA-256, formato `tar`).
- Cada trabajo se ejecuta solo con la biblioteca de clases estándar y los plugins; tus archivos de inicio de SuperCollider y la configuración de tu directorio home no se cargan ni se modifican. El código de las partituras es código de confianza, no un sandbox de seguridad.
- AI Game Dev 0.25.11 o posterior.

## Licencia

Este paquete: Apache-2.0. SuperCollider es software libre publicado por su proyecto bajo la GNU GPL. El avatar del paquete es el logotipo oficial de SuperCollider; la marca registrada pertenece a su titular.
````
