Communitygithub.com

888wing/8bit-music-generator

Generador local de música y efectos de sonido de 8 bits con semilla, optimizado para Codex.

¿Qué es 8bit-music-generator?

Este skill para Codex permite generar música y efectos de sonido (SFX) de estilo 8-bit de manera determinista y reproducible, utilizando un script local de Node.js (requiere Node 16 o superior). Está diseñado para desarrolladores de juegos, especialmente aquellos que usan Godot, ya que puede exportar directamente recursos `AudioStreamRandomizer` (.tres) para variaciones de sonido. El skill traduce descripciones en lenguaje natural a parámetros concretos: selecciona automáticamente el mood (aventura, batalla, jefe, pueblo, mazmorra, triste), la tonalidad, el número de compases y el BPM. Soporta la generación de paquetes de música completos (`music-pack`) que incluyen seis pistas coherentes (tema, pueblo, mazmorra, batalla, jefe, final) a partir de una semilla base, y variantes de SFX para evitar la repetición en el juego. El flujo de trabajo es simple: el usuario describe el audio deseado, el skill infiere los parámetros, ejecuta el script de Node, y devuelve un manifiesto JSON con las rutas de los archivos generados y metadatos como semilla, BPM y salidas MIDI/stems.

Compatible con~Claude Code✓Codex CLI✓Cursor
npx skills add 888wing/8bit-music-generator

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Chipgen

Usa el script Node empaquetado para generar música y SFX de 8 bits deterministas localmente. Requiere Node.js 16 o superior.

El script está en scripts/chipgen.js relativo a la carpeta de este skill. Ejecútalo con node y captura la salida estándar como JSON. Los errores se escriben en la salida de error estándar.

Usa redacción priorizando el inglés para nuevas funcionalidades, manifiestos generados y resúmenes orientados al usuario. Mantén el soporte para chino tradicional como idioma secundario al editar la interfaz de usuario del navegador.

Flujo de trabajo

  1. Resuelve el directorio de salida. Si el usuario no especifica uno, usa generated-audio/ en el proyecto actual.
  2. Elige los parámetros a partir de la solicitud del usuario usando las reglas de resumen-a-parámetros a continuación. Si no se proporciona una semilla, elige una e infórmala para que el resultado se pueda reproducir.
  3. Ejecuta node <directorio-skill>/scripts/chipgen.js list cuando necesites moods, tonalidades o categorías de SFX válidos.
  4. Genera los activos solicitados. Usa music-pack cuando el usuario pida un paquete de banda sonora, un conjunto de escenas o "diferentes escenas pero mismo estilo".
  5. Lee el manifiesto JSON de la salida estándar e informa las rutas de los archivos generados, la semilla, el mood/categoría, el BPM y cualquier salida MIDI/stems/tres.

Resumen a Parámetros

Infiere los parámetros a partir de resúmenes de audio de juegos en lenguaje natural. Prefiere una primera aproximación razonable en lugar de hacer preguntas, a menos que la solicitud tenga restricciones incompatibles.

Selección de mood musical

  • Usa adventure para mundo abierto, viaje, apertura, exploración, heroico, esperanzador, brillante, pantalla de título, mapa, descubrimiento, bosque, cielo, mar o BGM general de plataformas.
  • Usa battle para combate regular, persecución, peligro, acción, desafío contrarreloj, oleadas de enemigos, intensidad arcade rápida o jugabilidad tensa que no sea una pelea contra jefe.
  • Usa boss para jefe, jefe final, batalla contra rival, culminante, opresivo, demoníaco, de alto riesgo, final del juego, incursión o "hazlo más intenso que la batalla".
  • Usa town para ciudad, pueblo, tienda, posada, base de operaciones, zona segura, acogedor, PNJ amistoso, artesanía, granja, BGM de menú ligero o escenas cotidianas.
  • Usa dungeon para cueva, ruinas, misterio, sigilo, laberinto, noche, alcantarilla, laboratorio, alienígena, embrujado, bajo el agua, nieve/hielo cuando el resumen diga solitario/frío/misterioso en lugar de trágico.
  • Usa sad para pérdida, fin del juego, recuerdo, final, hogar arruinado, despedida, muerte, soledad, melancolía, escena emotiva o nieve/hielo cuando el resumen sea explícitamente triste.

Cuando un resumen mezcle moods, elige primero la función de juego, luego la emoción. Ejemplo: "batalla triste contra jefe" debería ser boss; "nivel solitario de nieve pero no demasiado lento" debería ser generalmente dungeon con un BPM en el rango superior, no sad.

Tonalidad, compases y BPM de la música

  • Usa las solicitudes de tonalidad explícitas directamente. Asigna los resúmenes "menor" a A, D o E cuando no se especifique una tonalidad exacta. Asigna los resúmenes brillantes/heroicos/acogedores a C, F o G. Usa random cuando el usuario quiera sorpresa o no dé ninguna dirección tonal.
  • Usa 8 compases para vistas previas rápidas, loops cortos, "stingers" o muchos candidatos. Usa 16 compases para BGM normal en bucle. Usa 32 compases para solicitudes de ambiente/fondo más largas.
  • Si el BPM no está especificado, deja que el generador elija dentro del rango del mood. Si el usuario pide más rápido/más lento, establece el BPM cerca del límite superior/inferior del rango del mood seleccionado. Si el usuario dice "no demasiado lento", evita sad a menos que la emoción lo exija, o establece sad cerca de 92 BPM.
  • Para BGM final o listo para producción, incluye --midi --stems. Para exploración, incluye --variants 5 a menos que el usuario pida un solo resultado.

Selección de paquete de música

Usa music-pack cuando la solicitud pida una banda sonora pequeña completa, un conjunto de escenas, un conjunto de señales o música para múltiples escenas de juego en un estilo coherente.

music-pack genera seis pistas a partir de una familia de semillas y una tonalidad resuelta:

  • Tema: adventure, 16 compases
  • Pueblo: town, 16 compases
  • Mazmorra: dungeon, 16 compases
  • Batalla: battle, 8 compases
  • Jefe: boss, 16 compases
  • Final: sad, 8 compases

Esto no es lo mismo que --variants. Las variantes mantienen una escena fija y solo cambian las semillas derivadas. Un paquete de música cambia la función de la escena mientras mantiene coherentes el centro tonal y la familia de semillas.

Selección de categoría de SFX

  • Usa coin para recoger, recolectar, recompensa, gema, objeto adquirido, puntuación o confirmación positiva.
  • Usa confirm para OK del menú, aceptar, clic de UI positivo, pequeño éxito o continuar diálogo.
  • Usa cancel para retroceder, denegar, inválido, error de UI, menú cerrado o retroalimentación negativa.
  • Usa jump para saltar, brincar, rebotar, muelle, movimiento ascendente de UI o elevación del personaje.
  • Usa dash para correr, esquivar, movimiento rápido, explosión de velocidad o paso aéreo.
  • Usa land para aterrizar, pisotón, pisada fuerte, tocar el suelo o impacto corporal pequeño.
  • Usa laser para disparar, proyectil, rayo, hechizo, bláster o ataque mágico rápido.
  • Usa slash para espada, hoja, garra, barrido, corte, ataque cuerpo a cuerpo o silbido-golpe rápido.
  • Usa hit para daño, puñetazo, impacto, herida, enemigo golpeado o contacto corporal.
  • Usa block para escudo, parada, guardia, impacto de armadura, desviación o impacto de metal/piedra.
  • Usa explosion para explosión, rotura, choque, estallido, destrucción, barril, bomba o gran impacto.
  • Usa powerup para mejora, subir de nivel, desbloquear, buff, curar, objeto raro, florecimiento de éxito o transformación.
  • Usa heal para curación, restaurar, poción, revivir, chispa mágica o efecto positivo suave.
  • Usa teleport para teletransporte, desvanecerse, teletransportador, portal, reaparecer o cambio de fase.
  • Usa door para puerta, interruptor, palanca, compuerta, mecanismo, cerradura o panel de UI pesado.
  • Usa chest para cofre del tesoro, revelación de recompensa, fanfarria de objeto, abrir botín o recogida rara.
  • Usa blip para cursor de UI, movimiento de menú, selección pequeña, escritura, notificación, pitido discreto o retroalimentación de interfaz neutra.
  • Usa alert para advertencia, alarma, detección, exclamación, salud baja o peligro con tiempo.
  • Usa fall para caída, fallo, soltar, perder, respuesta incorrecta, transición descendente o "stinger" de fin de juego.
  • Usa defeat para muerte, jugador perdido, fin del juego, enemigo derrotado o fracaso dramático.
  • Usa whoosh para movimiento de aire, preparación de balanceo, transición, paso rápido o movimiento abstracto.

Para SFX de juego repetitivos, genera --variants 5. Para sonidos de UI, genera 3-5 candidatos y mantén las duraciones cortas eligiendo blip, coin o hit en lugar de random.

Comandos

Listar valores admitidos:

node <directorio-skill>/scripts/chipgen.js list

Generar BGM:

node <directorio-skill>/scripts/chipgen.js music \
  --mood battle \
  --key A \
  --bars 16 \
  --seed 42 \
  --stems \
  --midi \
  --out generated-audio/bgm

Generar candidatos de BGM a partir de una familia de semillas:

node <directorio-skill>/scripts/chipgen.js music \
  --mood boss \
  --key A \
  --bars 16 \
  --seed 42 \
  --variants 5 \
  --midi \
  --out generated-audio/bgm

Generar un paquete de música de seis pistas:

node <directorio-skill>/scripts/chipgen.js music-pack \
  --key C \
  --seed 42 \
  --stems \
  --midi \
  --out generated-audio/bgm-pack

Generar un SFX:

node <directorio-skill>/scripts/chipgen.js sfx \
  --cat coin \
  --seed 123 \
  --out generated-audio/sfx

Generar un grupo de variaciones de SFX para Godot:

node <directorio-skill>/scripts/chipgen.js sfx \
  --cat hit \
  --seed 88 \
  --variants 5 \
  --tres generated-audio/sfx/hit_pool.tres \
  --res-prefix res://assets/audio/sfx/ \
  --out generated-audio/sfx

Parámetros

Los moods admitidos son adventure, battle, town, dungeon, sad y boss.

Las categorías de SFX admitidas son coin, confirm, cancel, jump, dash, land, laser, slash, hit, block, explosion, powerup, heal, teleport, door, chest, blip, alert, fall, defeat, whoosh y random.

Opciones útiles:

  • --bpm N: Sobrescribe el BPM generado.
  • --bars N: Duración de la música. Usa 8, 16 o 32 a menos que el usuario pida otra cosa.
  • --sr N: Frecuencia de muestreo. El valor predeterminado es 44100.
  • --midi: Exporta MIDI para la música.
  • --stems: Exporta pistas de música separadas.
  • --variants N: Genera una familia de semillas. Para música, mantiene fijos el mood, la tonalidad resuelta, los compases y el BPM mientras deriva nuevas semillas. Para SFX, mantiene fija la categoría.
  • --no-mix: Omite el WAV mezclado.
  • --no-normalize: Desactiva la normalización de SFX.
  • --tres RUTA: Escribe un recurso AudioStreamRandomizer de Godot.
  • --res-prefix PREFIJO: Prefijo de recurso utilizado dentro del .tres de Godot generado.

Valores predeterminados

Para BGM listo para el juego, prefiere --stems --midi a menos que el usuario solo quiera una vista previa rápida.

Para exploración de música, genera de 5 a 10 candidatos a partir de una semilla base. En la salida de la CLI, variantIndex: 0 es la semilla base y los elementos posteriores usan variantSeed = (baseSeed + 0x9E3779B9 * index) >>> 0 con el índice comenzando en 1. Mantén fijos mood, la key resuelta, bars y bpm para que los candidatos se sientan relacionados en lugar de aleatorios.

Para una banda sonora de juego compacta, prefiere music-pack --stems --midi. Produce pistas de Tema, Pueblo, Mazmorra, Batalla, Jefe y Final a partir de una familia de semillas.

Para SFX destinados a reproducción repetida en el juego, prefiere --variants 5 y mantén la misma categoría con diferentes variantes con semilla.

Para proyectos Godot, usa assets/audio/bgm y assets/audio/sfx cuando esos directorios existan. Recuerda al usuario que las importaciones WAV de Godot pueden necesitar el modo de bucle activado para BGM en bucle.

Skills relacionados