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
- Resuelve el directorio de salida. Si el usuario no especifica uno, usa
generated-audio/en el proyecto actual. - 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.
- Ejecuta
node <directorio-skill>/scripts/chipgen.js listcuando necesites moods, tonalidades o categorías de SFX válidos. - Genera los activos solicitados. Usa
music-packcuando el usuario pida un paquete de banda sonora, un conjunto de escenas o "diferentes escenas pero mismo estilo". - 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
adventurepara mundo abierto, viaje, apertura, exploración, heroico, esperanzador, brillante, pantalla de título, mapa, descubrimiento, bosque, cielo, mar o BGM general de plataformas. - Usa
battlepara 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
bosspara 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
townpara ciudad, pueblo, tienda, posada, base de operaciones, zona segura, acogedor, PNJ amistoso, artesanía, granja, BGM de menú ligero o escenas cotidianas. - Usa
dungeonpara 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
sadpara 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,DoEcuando no se especifique una tonalidad exacta. Asigna los resúmenes brillantes/heroicos/acogedores aC,FoG. Usarandomcuando 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
sada menos que la emoción lo exija, o establecesadcerca de 92 BPM. - Para BGM final o listo para producción, incluye
--midi --stems. Para exploración, incluye--variants 5a 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
coinpara recoger, recolectar, recompensa, gema, objeto adquirido, puntuación o confirmación positiva. - Usa
confirmpara OK del menú, aceptar, clic de UI positivo, pequeño éxito o continuar diálogo. - Usa
cancelpara retroceder, denegar, inválido, error de UI, menú cerrado o retroalimentación negativa. - Usa
jumppara saltar, brincar, rebotar, muelle, movimiento ascendente de UI o elevación del personaje. - Usa
dashpara correr, esquivar, movimiento rápido, explosión de velocidad o paso aéreo. - Usa
landpara aterrizar, pisotón, pisada fuerte, tocar el suelo o impacto corporal pequeño. - Usa
laserpara disparar, proyectil, rayo, hechizo, bláster o ataque mágico rápido. - Usa
slashpara espada, hoja, garra, barrido, corte, ataque cuerpo a cuerpo o silbido-golpe rápido. - Usa
hitpara daño, puñetazo, impacto, herida, enemigo golpeado o contacto corporal. - Usa
blockpara escudo, parada, guardia, impacto de armadura, desviación o impacto de metal/piedra. - Usa
explosionpara explosión, rotura, choque, estallido, destrucción, barril, bomba o gran impacto. - Usa
poweruppara mejora, subir de nivel, desbloquear, buff, curar, objeto raro, florecimiento de éxito o transformación. - Usa
healpara curación, restaurar, poción, revivir, chispa mágica o efecto positivo suave. - Usa
teleportpara teletransporte, desvanecerse, teletransportador, portal, reaparecer o cambio de fase. - Usa
doorpara puerta, interruptor, palanca, compuerta, mecanismo, cerradura o panel de UI pesado. - Usa
chestpara cofre del tesoro, revelación de recompensa, fanfarria de objeto, abrir botín o recogida rara. - Usa
blippara cursor de UI, movimiento de menú, selección pequeña, escritura, notificación, pitido discreto o retroalimentación de interfaz neutra. - Usa
alertpara advertencia, alarma, detección, exclamación, salud baja o peligro con tiempo. - Usa
fallpara caída, fallo, soltar, perder, respuesta incorrecta, transición descendente o "stinger" de fin de juego. - Usa
defeatpara muerte, jugador perdido, fin del juego, enemigo derrotado o fracaso dramático. - Usa
whooshpara 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 recursoAudioStreamRandomizerde Godot.--res-prefix PREFIJO: Prefijo de recurso utilizado dentro del.tresde 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.