Communitygithub.com

888wing/8bit-music-generator

Générateur déterministe de musique 8 bits et d'effets sonores avec seed, disponible en tant que compétence Codex locale.

Qu'est-ce que 8bit-music-generator ?

Cette compétence (skill) permet de générer de la musique 8 bits et des effets sonores (SFX) de manière déterministe à l'aide d'un script Node.js local. Elle est conçue pour les développeurs de jeux utilisant des agents IA comme Codex, Cursor ou Claude Code. Le script `scripts/chipgen.js` accepte des paramètres en ligne de commande (mood, tonalité, nombre de mesures, BPM, seed, etc.) et produit un fichier JSON listant les fichiers générés. Elle supporte la génération de thèmes musicaux (aventure, combat, boss, ville, donjon, triste), d'effets sonores (pièce, saut, laser, coup, etc.) et de packs complets de 6 pistes cohérentes. Le résultat est déterministe : une même seed produit les mêmes rendus, facilitant les itérations et le contrôle de version. La compétence inclut l'export MIDI, des stems séparés, et la création de ressources Godot (AudioStreamRandomizer) pour une intégration directe dans un projet de jeu.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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

  1. Déterminez le répertoire de sortie. Si l'utilisateur n'en spécifie pas, utilisez generated-audio/ dans le projet courant.
  2. 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.
  3. Exécutez node <skill-dir>/scripts/chipgen.js list lorsque vous avez besoin des moods, des tonalités ou des catégories d'effets sonores valides.
  4. Générez les ressources demandées. Utilisez music-pack lorsque l'utilisateur demande un pack de bande-son, un ensemble de scènes, ou "différentes scènes mais même style".
  5. 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 adventure pour 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 battle pour 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 boss pour 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 town pour 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 dungeon pour 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 sad pour 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, D ou E quand aucune tonalité exacte n'est spécifiée. Associez les résumés lumineux/héroïques/cocons à C, F ou G. Utilisez random quand 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 sad sauf si l'émotion l'exige, ou réglez sad près de 92 BPM.
  • Pour une BGM finale ou prête pour la production, incluez --midi --stems. Pour l'exploration, incluez --variants 5 sauf 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 coin pour ramassage, collecte, récompense, gemme, objet obtenu, score, ou confirmation positive.
  • Utilisez confirm pour OK menu, acceptation, clic UI positif, petit succès, ou poursuite du dialogue.
  • Utilisez cancel pour retour, refus, invalide, erreur UI, menu fermé, ou feedback négatif.
  • Utilisez jump pour saut, bond, rebond, ressort, mouvement UI vers le haut, ou élévation du personnage.
  • Utilisez dash pour dash, esquive, mouvement rapide, burst de vitesse, ou pas aérien.
  • Utilisez land pour atterrissage, écrasement, pas lourd, contact avec le sol, ou petit impact corporel.
  • Utilisez laser pour tir, projectile, zapper, rayon, sort lancé, blaster, ou attaque magique rapide.
  • Utilisez slash pour épée, lame, griffe, balayage, coupe, attaque de mêlée, ou coup-rapide sifflant.
  • Utilisez hit pour dégât, coup de poing, impact, blessure, ennemi touché, ou contact corporel.
  • Utilisez block pour bouclier, parade, garde, coup sur armure, déviation, ou impact métal/pierre.
  • Utilisez explosion pour explosion, bris, crash, souffle, destruction, baril, bombe, ou gros impact.
  • Utilisez powerup pour amélioration, montée de niveau, déverrouillage, buff, soin, objet rare, fanfare de succès, ou transformation.
  • Utilisez heal pour soin, restauration, potion, résurrection, étincelle magique, ou effet positif doux.
  • Utilisez teleport pour téléportation, disparition, portail, réapparition, ou changement de phase.
  • Utilisez door pour porte, interrupteur, levier, portail, mécanisme, serrure, ou panneau UI lourd.
  • Utilisez chest pour coffre au trésor, révélation de récompense, fanfare d'objet, ouverture de butin, ou ramassage rare.
  • Utilisez blip pour curseur UI, déplacement de menu, petite sélection, frappe, notification, bip discret, ou feedback d'interface neutre.
  • Utilisez alert pour avertissement, alarme, détection, exclamation, faible santé, ou danger chronométré.
  • Utilisez fall pour chute, échec, chute, perte, mauvaise réponse, transition descendante, ou stinger de game over.
  • Utilisez defeat pour mort, joueur perdu, game over, ennemi vaincu, ou échec dramatique.
  • Utilisez whoosh pour 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 ressource AudioStreamRandomizer pour Godot.
  • --res-prefix PREFIX : Préfixe de ressource utilisé à l'intérieur du fichier .tres Godot 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.

Skills associés