SuperCollider
gamedev pkg add aigd.supercolliderResumen
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.
Compón, renderiza, analiza y exporta música portable para juegos con el agente de AI Game Dev y SuperCollider. 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.wavcomo 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
runtimePathcomo una instalación compatible de SuperCollider 3.14.1, ostagedArtifactcomo un descriptor de artefacto revisado (versión, plataforma, URL, SHA-256, formatotar). - 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.
Versiones
| Versión | Publicada | Requiere la aplicación |
|---|---|---|
| 0.1.12Última | 0.25.11 o posterior | |
| 0.1.11 | 0.25.11 o posterior | |
| 0.1.10 | 0.25.11 o posterior | |
| 0.1.9 | 0.25.11 o posterior | |
| 0.1.8 | 0.25.11 o posterior | |
| 0.1.7 | 0.25.11 o posterior | |
| 0.1.5 | 0.20.0 o posterior | |
| 0.1.4 | 0.20.0 o posterior | |
| 0.1.2 | 0.20.0 o posterior | |
| 0.1.1 | 0.20.0 o posterior |
Instalar
En la app de escritorio
Abre la ventana Paquetes (el icono de paquete en la barra de estado), selecciona Explorar, busca aigd.supercollider y haz clic en Añadir al proyecto.
¿Aún no tienes la app? Descarga AI Game Dev gratis para Windows, macOS o Linux.
Desde el terminal
Con la CLI gamedev, en la carpeta de tu proyecto:
gamedev pkg add aigd.supercolliderRequisitos
- AI Game Dev 0.25.11 o posterior
gamedev pkg add aigd.supercollider