Chipgen
Utilisez le script Node fourni pour générer localement de la musique 8 bits et des effets sonores déterministes. Nécessite Node.js 16 ou plus récent.
Le script se trouve dans scripts/chipgen.js relatif au dossier de cette compétence. Exécutez-le avec node et capturez la sortie standard sous forme de JSON. Les erreurs sont écrites sur stderr.
Utilisez une formulation prioritairement en anglais pour les nouvelles fonctionnalités, les manifestes générés et les résumés destinés à l'utilisateur. Conservez le support du chinois traditionnel comme locale secondaire lors de l'édition de l'interface navigateur.
Workflow
- Déterminez le répertoire de sortie. Si l'utilisateur n'en spécifie pas, utilisez
generated-audio/dans le projet courant. - Choisissez les paramètres à partir de la demande utilisateur en utilisant les règles de correspondance (brief-to-parameters) ci-dessous. Si une seed n'est pas fournie, choisissez-en une et signalez-la pour que le résultat puisse être reproduit.
- Exécutez
node <skill-dir>/scripts/chipgen.js listlorsque vous avez besoin des moods, des tonalités ou des catégories d'effets sonores valides. - Générez les ressources demandées. Utilisez
music-packlorsque l'utilisateur demande un pack de bande-son, un ensemble de scènes, ou "différentes scènes mais même style". - Lisez le manifeste JSON depuis la sortie standard et rapportez les chemins des fichiers générés, la seed, le mood/catégorie, le BPM, et toute sortie MIDI/stem/tres.
Correspondance - Résumé vers Paramètres
Déduisez les paramètres à partir de résumés audio de jeu en langage naturel. Privilégiez une première passe raisonnable plutôt que de poser des questions, sauf si la demande contient des contraintes incompatibles.
Sélection du mood musical
- Utilisez
adventurepour le monde extérieur, la quête, l'ouverture, l'exploration, l'héroïque, l'espoir, le lumineux, l'écran-titre, la carte, la découverte, la forêt, le ciel, la mer ou la BGM de jeu de plateforme générale. - Utilisez
battlepour le combat classique, la poursuite, le danger, l'action, le défi chronométré, les vagues d'ennemis, l'intensité arcade rapide, ou le gameplay tendu qui n'est pas un combat de boss. - Utilisez
bosspour le boss, le boss final, le combat rival, le moment culminant, l'oppressant, le démoniaque, les enjeux élevés, la fin de jeu, le raid, ou "rends-le plus intense qu'un combat". - Utilisez
townpour la ville, le village, la boutique, l'auberge, la base, la zone sécurisée, le cocon, le PNJ amical, l'artisanat, la ferme, la BGM de menu légère ou les scènes quotidiennes. - Utilisez
dungeonpour la grotte, les ruines, le mystère, la furtivité, le labyrinthe, la nuit, les égouts, le laboratoire, l'extraterrestre, le hanté, le sous-marin, la neige/glace quand le résumé indique solitude/froid/mystérieux plutôt que tragique. - Utilisez
sadpour la perte, le game over, le souvenir, la fin, la maison ruinée, les adieux, la mort, la solitude, la mélancolie, la scène cinématique émotionnelle, ou la neige/glace quand le résumé est explicitement douloureux.
Quand un résumé mélange les moods, choisissez d'abord la fonction de gameplay, puis l'émotion. Exemple : "combat de boss triste" doit être boss ; "niveau de neige solitaire mais pas trop lent" doit généralement être dungeon avec un BPM dans la fourchette haute, pas sad.
Tonalité, mesures et BPM
- Utilisez les demandes explicites de tonalité directement. Associez les résumés "mineur" à
A,DouEquand aucune tonalité exacte n'est spécifiée. Associez les résumés lumineux/héroïques/cocons àC,FouG. Utilisezrandomquand l'utilisateur veut la surprise ou ne donne aucune direction tonale. - Utilisez 8 mesures pour les aperçus rapides, les boucles courtes, les stingers, ou de nombreux candidats. Utilisez 16 mesures pour une BGM en boucle normale. Utilisez 32 mesures pour des demandes d'ambiance/de fond plus longues.
- Si le BPM n'est pas spécifié, laissez le générateur choisir dans la plage du mood. Si l'utilisateur demande plus rapide/plus lent, réglez le BPM près du haut/bas de la plage du mood sélectionné. Si l'utilisateur dit "pas trop lent", évitez
sadsauf si l'émotion l'exige, ou réglezsadprès de 92 BPM. - Pour une BGM finale ou prête pour la production, incluez
--midi --stems. Pour l'exploration, incluez--variants 5sauf si l'utilisateur demande un résultat unique.
Sélection du pack musical
Utilisez music-pack quand la demande concerne une petite bande-son complète, un pack de scènes, un ensemble de repères musicaux, ou de la musique pour plusieurs scènes de jeu dans un style cohérent.
music-pack génère six repères à partir d'une famille de seeds et d'une tonalité résolue :
- Thème :
adventure, 16 mesures - Ville :
town, 16 mesures - Donjon :
dungeon, 16 mesures - Combat :
battle, 8 mesures - Boss :
boss, 16 mesures - Fin :
sad, 8 mesures
Ce n'est pas la même chose que --variants. Les variants fixent une scène et ne changent que les seeds dérivées. Un pack musical change la fonction de la scène tout en conservant le centre tonal et la famille de seeds cohérents.
Sélection de la catégorie d'effets sonores
- Utilisez
coinpour ramassage, collecte, récompense, gemme, objet obtenu, score, ou confirmation positive. - Utilisez
confirmpour OK menu, acceptation, clic UI positif, petit succès, ou poursuite du dialogue. - Utilisez
cancelpour retour, refus, invalide, erreur UI, menu fermé, ou feedback négatif. - Utilisez
jumppour saut, bond, rebond, ressort, mouvement UI vers le haut, ou élévation du personnage. - Utilisez
dashpour dash, esquive, mouvement rapide, burst de vitesse, ou pas aérien. - Utilisez
landpour atterrissage, écrasement, pas lourd, contact avec le sol, ou petit impact corporel. - Utilisez
laserpour tir, projectile, zapper, rayon, sort lancé, blaster, ou attaque magique rapide. - Utilisez
slashpour épée, lame, griffe, balayage, coupe, attaque de mêlée, ou coup-rapide sifflant. - Utilisez
hitpour dégât, coup de poing, impact, blessure, ennemi touché, ou contact corporel. - Utilisez
blockpour bouclier, parade, garde, coup sur armure, déviation, ou impact métal/pierre. - Utilisez
explosionpour explosion, bris, crash, souffle, destruction, baril, bombe, ou gros impact. - Utilisez
poweruppour amélioration, montée de niveau, déverrouillage, buff, soin, objet rare, fanfare de succès, ou transformation. - Utilisez
healpour soin, restauration, potion, résurrection, étincelle magique, ou effet positif doux. - Utilisez
teleportpour téléportation, disparition, portail, réapparition, ou changement de phase. - Utilisez
doorpour porte, interrupteur, levier, portail, mécanisme, serrure, ou panneau UI lourd. - Utilisez
chestpour coffre au trésor, révélation de récompense, fanfare d'objet, ouverture de butin, ou ramassage rare. - Utilisez
blippour curseur UI, déplacement de menu, petite sélection, frappe, notification, bip discret, ou feedback d'interface neutre. - Utilisez
alertpour avertissement, alarme, détection, exclamation, faible santé, ou danger chronométré. - Utilisez
fallpour chute, échec, chute, perte, mauvaise réponse, transition descendante, ou stinger de game over. - Utilisez
defeatpour mort, joueur perdu, game over, ennemi vaincu, ou échec dramatique. - Utilisez
whooshpour mouvement d'air, préparation de swing, transition, passage rapide, ou mouvement abstrait.
Pour les effets sonores de gameplay répétés, générez --variants 5. Pour les sons UI, générez 3 à 5 candidats et gardez les durées courtes en choisissant blip, coin ou hit plutôt que random.
Commandes
Liste des valeurs supportées :
node <skill-dir>/scripts/chipgen.js list
Générer une BGM :
node <skill-dir>/scripts/chipgen.js music \
--mood battle \
--key A \
--bars 16 \
--seed 42 \
--stems \
--midi \
--out generated-audio/bgm
Générer des candidats BGM à partir d'une famille de seeds :
node <skill-dir>/scripts/chipgen.js music \
--mood boss \
--key A \
--bars 16 \
--seed 42 \
--variants 5 \
--midi \
--out generated-audio/bgm
Générer un pack musical de 6 repères :
node <skill-dir>/scripts/chipgen.js music-pack \
--key C \
--seed 42 \
--stems \
--midi \
--out generated-audio/bgm-pack
Générer un effet sonore :
node <skill-dir>/scripts/chipgen.js sfx \
--cat coin \
--seed 123 \
--out generated-audio/sfx
Générer un pool de variations d'effets sonores pour Godot :
node <skill-dir>/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
Paramètres
Les moods supportés sont adventure, battle, town, dungeon, sad et boss.
Les catégories d'effets sonores supportées sont coin, confirm, cancel, jump, dash, land, laser, slash, hit, block, explosion, powerup, heal, teleport, door, chest, blip, alert, fall, defeat, whoosh et random.
Options utiles :
--bpm N: Surcharger le BPM généré.--bars N: Longueur de la musique. Utilisez 8, 16 ou 32 sauf demande contraire de l'utilisateur.--sr N: Taux d'échantillonnage. Valeur par défaut : 44100.--midi: Exporter le MIDI pour la musique.--stems: Exporter les stems musicaux séparés.--variants N: Générer une famille de seeds. Pour la musique, gardez le mood, la tonalité résolue, les mesures et le BPM fixes tout en dérivant de nouvelles seeds. Pour les effets sonores, gardez la catégorie fixe.--no-mix: Ignorer le WAV mixé.--no-normalize: Désactiver la normalisation des effets sonores.--tres PATH: Écrire une ressourceAudioStreamRandomizerpour Godot.--res-prefix PREFIX: Préfixe de ressource utilisé à l'intérieur du fichier.tresGodot généré.
Valeurs par défaut
Pour une BGM prête pour le jeu, privilégiez --stems --midi sauf si l'utilisateur ne souhaite qu'un aperçu rapide.
Pour l'exploration musicale, générez 5 à 10 candidats à partir d'une seule seed de base. Dans la sortie CLI, variantIndex: 0 correspond à la seed de base et les éléments suivants utilisent variantSeed = (baseSeed + 0x9E3779B9 * index) >>> 0 avec un index commençant à 1. Gardez le mood, la key résolue, les bars et le bpm fixes pour que les candidats semblent liés plutôt qu'aléatoires.
Pour une bande-son compacte de jeu, privilégiez music-pack --stems --midi. Elle produit les repères Thème, Ville, Donjon, Combat, Boss et Fin à partir d'une famille de seeds.
Pour les effets sonores destinés à être joués de manière répétée dans le jeu, privilégiez --variants 5 et conservez la même catégorie avec différentes variantes ensemencées.
Pour les projets Godot, utilisez assets/audio/bgm et assets/audio/sfx lorsque ces répertoires existent. Rappelez à l'utilisateur que les imports WAV de Godot peuvent nécessiter l'activation du mode boucle pour une BGM en boucle.