Communitygithub.com

888wing/8bit-music-generator

Deterministischer 8-Bit-Musik- und Soundeffektgenerator mit einem lokalen Codex-Skill.

Was ist 8bit-music-generator?

Dieser Skill dient als lokaler Generator für deterministische 8-Bit-Musik und Soundeffekte (SFX), optimiert für die Verwendung mit KI-Agenten wie Codex, Cursor oder Claude Code. Er ermöglicht es Entwicklern, aus natürlichen Sprachbeschreibungen heraus passende Game-Audio-Assets zu erstellen – von Hintergrundmusik für verschiedene Spielszenen bis hin zu spezifischen Soundeffekten wie Münzen, Sprüngen oder Lasern. Der Skill läuft über ein Node.js-Skript und gibt strukturierte JSON-Ergebnisse aus, die von der KI weiterverarbeitet werden können. Besondere Stärken sind die Unterstützung von Musikpaketen („music-pack“) für zusammenhängende Soundtracks, die parametrisierte Steuerung von Stimmung, Tonart, Taktzahl und BPM sowie die Generierung von Varianten für abwechslungsreiche Spielsounds. Zudem exportiert er MIDI- und Stem-Dateien und kann Godot-Ressourcen (.tres) für nahtlose Integration in die Godot-Engine erzeugen. Die Logik zur Parameterableitung aus Benutzeranfragen ist detailliert in der Skill-Dokumentation beschrieben und erlaubt eine effiziente, kontextbewusste Generierung ohne Rückfragen.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Chipgen

Nutze das gebündelte Node-Skript, um deterministische 8-Bit-Musik und Soundeffekte (SFX) lokal zu generieren. Erfordert Node.js 16 oder neuer.

Das Skript befindet sich unter scripts/chipgen.js relativ zu diesem Skill-Ordner. Führe es mit node aus und erfasse die Standardausgabe (stdout) als JSON. Fehler werden nach stderr geschrieben.

Verwende für neue Features, generierte Manifests und zusammenfassende Texte für Benutzer bevorzugt englische Formulierungen. Bewahre die Unterstützung für traditionelles Chinesisch als sekundäre Sprache bei der Bearbeitung der Browser-Oberfläche.

Arbeitsablauf

  1. Bestimme das Ausgabeverzeichnis. Wenn der Benutzer keins angibt, verwende generated-audio/ im aktuellen Projekt.
  2. Wähle Parameter aus der Benutzeranfrage anhand der nachfolgenden Regeln für die Parameterableitung. Wenn kein Seed angegeben wird, wähle einen aus und berichte ihn, damit das Ergebnis reproduziert werden kann.
  3. Führe node <skill-verzeichnis>/scripts/chipgen.js list aus, wenn du gültige Stimmungen, Tonarten oder SFX-Kategorien benötigst.
  4. Generiere die angeforderten Assets. Verwende music-pack, wenn der Benutzer nach einem Soundtrack-Pack, einer Szenen-Sammlung oder „verschiedenen Szenen, aber gleichem Stil“ fragt.
  5. Lies das JSON-Manifest aus der Standardausgabe und berichte die generierten Dateipfade, den Seed, die Stimmung/Kategorie, das BPM sowie etwaige MIDI/Stem/tres-Ausgaben.

Parameterableitung aus Kurzbeschreibungen

Leite Parameter aus natürlichsprachlichen Game-Audio-Kurzbeschreibungen ab. Bevorzuge einen sinnvollen ersten Ansatz gegenüber Rückfragen, es sei denn, die Anfrage enthält widersprüchliche Einschränkungen.

Auswahl der Musikstimmung

  • Verwende adventure für Oberwelt, Reise, Eröffnung, Erkundung, heldenhaft, hoffnungsvoll, hell, Titelbildschirm, Karte, Entdeckung, Wald, Himmel, Meer oder allgemeine Plattformer-Hintergrundmusik (BGM).
  • Verwende battle für normale Kämpfe, Verfolgungsjagden, Gefahr, Action, zeitlich begrenzte Herausforderungen, Gegnerwellen, schnelle Arcade-Intensität oder angespanntes Gameplay, das kein Bosskampf ist.
  • Verwende boss für Boss, Endboss, Rivalenkampf, Höhepunkt, bedrückend, dämonisch, risikoreich, spätes Spiel, Raid oder „mache es intensiver als einen Kampf“.
  • Verwende town für Stadt, Dorf, Laden, Gasthaus, Heimatbasis, sichere Zone, gemütlich, freundlicher NPC, Handwerk, Bauernhof, leichte Menü-Hintergrundmusik oder Alltagsszenen.
  • Verwende dungeon für Höhle, Ruinen, Mysterium, Schleichpassagen, Labyrinth, Nacht, Kanalisation, Labor, außerirdisch, Geisterhaus, Unterwasser, Schnee/Eis, wenn die Beschreibung einsam/kalt/mysteriös und nicht tragisch ist.
  • Verwende sad für Verlust, Game Over, Erinnerung, Ende, zerstörtes Zuhause, Abschied, Tod, Einsamkeit, Melancholie, emotionale Zwischensequenz oder Schnee/Eis, wenn die Beschreibung ausdrücklich traurig ist.

Wenn eine Beschreibung Stimmungen mischt, wähle zuerst die Gameplay-Funktion, dann die Emotion. Beispiel: „trauriger Bosskampf“ sollte boss sein; „einsames Schnee-Level, aber nicht zu langsam“ sollte normalerweise dungeon mit einem oberen BPM-Bereich sein, nicht sad.

Tonart, Takte und BPM

  • Verwende explizite Tonartenwünsche direkt. Ordne „Moll“-Beschreibungen den Tonarten A, D oder E zu, wenn keine genaue Tonart angegeben ist. Ordne helle/heldenhafte/gemütliche Beschreibungen den Tonarten C, F oder G zu. Verwende random, wenn der Benutzer Überraschung wünscht oder keine tonale Richtung vorgibt.
  • Verwende 8 Takte für schnelle Vorschauen, kurze Loops, Stinger oder viele Kandidaten. Verwende 16 Takte für normalen Looping-BGM. Verwende 32 Takte für längere Ambient-/Hintergrundanfragen.
  • Wenn das BPM nicht angegeben ist, lasse den Generator innerhalb des Stimmungsbereichs wählen. Wenn der Benutzer nach schneller/langsamer fragt, setze das BPM nahe der Ober-/Untergrenze des gewählten Stimmungsbereichs. Wenn der Benutzer „nicht zu langsam“ sagt, vermeide sad, es sei denn, die Emotion erfordert es, oder setze sad nahe 92 BPM.
  • Für finalen oder produktionsreifen BGM füge --midi --stems hinzu. Für Erkundung füge --variants 5 hinzu, es sei denn, der Benutzer wünscht ein einzelnes Ergebnis.

Auswahl des Musikpakets

Verwende music-pack, wenn die Anfrage einen kompletten kleinen Soundtrack, ein Szenenpaket, eine Sammlung von Stichworten oder Musik für mehrere Spielszenen in einem kohärenten Stil verlangt.

music-pack generiert sechs Stichworte aus einer Seed-Familie und einer festgelegten Tonart:

  • Thema: adventure, 16 Takte
  • Stadt: town, 16 Takte
  • Verlies: dungeon, 16 Takte
  • Kampf: battle, 8 Takte
  • Boss: boss, 16 Takte
  • Ende: sad, 8 Takte

Dies ist nicht dasselbe wie --variants. Varianten behalten eine Szene bei und ändern nur abgeleitete Seeds. Ein Musikpaket ändert die Szenenfunktion, während der tonale Mittelpunkt und die Seed-Familie kohärent bleiben.

Auswahl der SFX-Kategorie

  • Verwende coin für Aufheben, Einsammeln, Belohnung, Edelstein, Gegenstand erhalten, Punktzahl oder positive Bestätigung.
  • Verwende confirm für Menü-OK, Akzeptieren, positiven UI-Klick, kleinen Erfolg oder Dialog fortsetzen.
  • Verwende cancel für Zurück, Ablehnen, Ungültig, UI-Fehler, geschlossenes Menü oder negatives Feedback.
  • Verwende jump für Springen, Hüpfen, Abprallen, Sprungfeder, UI-Aufwärtsbewegung oder Charakter-Anhebung.
  • Verwende dash für Sprinten, Ausweichen, schnelle Bewegung, Geschwindigkeitsschub oder Luftschritt.
  • Verwende land für Landung, Stampfen, schweren Schritt, Bodenberührung oder kleinen Körperaufprall.
  • Verwende laser für Schießen, Projektil, Zappen, Strahl, Zauber wirken, Blaster oder schnellen magischen Angriff.
  • Verwende slash für Schwert, Klinge, Klaue, Hieb, Schnitt, Nahkampfangriff oder schnellen Schwung-Treffer.
  • Verwende hit für Schaden, Schlag, Aufprall, Verletzung, getroffener Gegner oder Körperkontakt.
  • Verwede block für Schild, Parieren, Blocken, Rüstungstreffer, Ablenken oder Metall/Stein-Aufprall.
  • Verwende explosion für Explosion, Bruch, Absturz, Detonation, Zerstörung, Fass, Bombe oder großen Einschlag.
  • Verwende powerup für Verbesserung, Levelaufstieg, Freischaltung, Buff, Heilung, seltenen Gegenstand, Erfolgsfanfare oder Verwandlung.
  • Verwende heal für Heilen, Wiederherstellen, Trank, Wiederbelebung, magisches Funkeln oder sanften positiven Effekt.
  • Verwende teleport für Teleportieren, Verschwinden, Portal, Wiederbelebungspunkt oder Phasenwechsel.
  • Verwende door für Tür, Schalter, Hebel, Tor, Mechanismus, Schloss oder schweres UI-Panel.
  • Verwende chest für Schatztruhe, Belohnungsenthüllung, Gegenstandsfanfare, Öffnen von Beute oder seltenem Aufheben.
  • Verwende blip für UI-Cursor, Menübewegung, kleine Auswahl, Tippen, Benachrichtigung, dezenten Piepton oder neutrales Feedbacksignal.
  • Verwende alert für Warnung, Alarm, Erkennung, Ausruf, niedrige Gesundheit oder zeitliche Gefahr.
  • Verwende fall für Fallen, Fehlschlag, Fallenlassen, Verlieren, falsche Antwort, Abwärtsübergang oder Game-Over-Stinger.
  • Verwende defeat für Tod, Spielerverlust, Game Over, besiegter Gegner oder dramatisches Scheitern.
  • Verwende whoosh für Luftbewegung, Schwungvorbereitung, Übergang, schnelles Vorbeifliegen oder abstrakte Bewegung.

Für wiederholte Gameplay-SFX generiere --variants 5. Für UI-Sounds generiere 3–5 Kandidaten und halte die Dauer kurz, indem du blip, coin oder hit anstelle von random wählst.

Befehle

Liste der unterstützten Werte:

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

BGM generieren:

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

BGM-Kandidaten aus einer Seed-Familie generieren:

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

Ein Musikpaket mit sechs Stichworten generieren:

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

Ein SFX generieren:

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

Einen SFX-Varianten-Pool für Godot generieren:

node <skill-verzeichnis>/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

Parameter

Unterstützte Stimmungen sind adventure, battle, town, dungeon, sad und boss.

Unterstützte SFX-Kategorien sind coin, confirm, cancel, jump, dash, land, laser, slash, hit, block, explosion, powerup, heal, teleport, door, chest, blip, alert, fall, defeat, whoosh und random.

Nützliche Optionen:

  • --bpm N: Überschreibt das generierte BPM.
  • --bars N: Musiklänge. Verwende 8, 16 oder 32, sofern der Benutzer nichts anderes wünscht.
  • --sr N: Abtastrate. Standard ist 44100.
  • --midi: Exportiert MIDI für Musik.
  • --stems: Exportiert separate Musik-Stems.
  • --variants N: Generiert eine Seed-Familie. Für Musik bleiben Stimmung, aufgelöste Tonart, Takte und BPM fest, während neue Seeds abgeleitet werden. Für SFX bleibt die Kategorie fest.
  • --no-mix: Überspringt das gemischte WAV.
  • --no-normalize: Deaktiviert die SFX-Normalisierung.
  • --tres PFAD: Schreibt eine Godot AudioStreamRandomizer-Ressource.
  • --res-prefix PRÄFIX: Ressourcen-Präfix, das innerhalb der generierten Godot .tres verwendet wird.

Standardeinstellungen

Für spielfertigen BGM bevorzuge --stems --midi, es sei denn, der Benutzer wünscht nur eine schnelle Vorschau.

Für die Musikexploration generiere 5–10 Kandidaten aus einem Basisseed. In der CLI-Ausgabe ist variantIndex: 0 der Basisseed und spätere Einträge verwenden variantSeed = (baseSeed + 0x9E3779B9 * index) >>> 0 mit Index beginnend bei 1. Behalte mood, aufgelöste key, bars und bpm bei, damit die Kandidaten zusammenhängend und nicht zufällig wirken.

Für einen kompakten Spiel-Soundtrack bevorzuge music-pack --stems --midi. Es produziert Theme, Town, Dungeon, Battle, Boss und Ending-Stichworte aus einer Seed-Familie.

Für SFX, die wiederholt im Spiel abgespielt werden sollen, bevorzuge --variants 5 und behalte die gleiche Kategorie bei, mit verschiedenen gesäten Varianten.

Für Godot-Projekte verwende assets/audio/bgm und assets/audio/sfx, wenn diese Verzeichnisse existieren. Erinnere den Benutzer daran, dass Godot-WAV-Importe möglicherweise den Loop-Modus aktivieren müssen, damit BGM loopt.

Verwandte Skills