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
- Bestimme das Ausgabeverzeichnis. Wenn der Benutzer keins angibt, verwende
generated-audio/im aktuellen Projekt. - 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.
- Führe
node <skill-verzeichnis>/scripts/chipgen.js listaus, wenn du gültige Stimmungen, Tonarten oder SFX-Kategorien benötigst. - Generiere die angeforderten Assets. Verwende
music-pack, wenn der Benutzer nach einem Soundtrack-Pack, einer Szenen-Sammlung oder „verschiedenen Szenen, aber gleichem Stil“ fragt. - 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
adventurefür Oberwelt, Reise, Eröffnung, Erkundung, heldenhaft, hoffnungsvoll, hell, Titelbildschirm, Karte, Entdeckung, Wald, Himmel, Meer oder allgemeine Plattformer-Hintergrundmusik (BGM). - Verwende
battlefür normale Kämpfe, Verfolgungsjagden, Gefahr, Action, zeitlich begrenzte Herausforderungen, Gegnerwellen, schnelle Arcade-Intensität oder angespanntes Gameplay, das kein Bosskampf ist. - Verwende
bossfür Boss, Endboss, Rivalenkampf, Höhepunkt, bedrückend, dämonisch, risikoreich, spätes Spiel, Raid oder „mache es intensiver als einen Kampf“. - Verwende
townfür Stadt, Dorf, Laden, Gasthaus, Heimatbasis, sichere Zone, gemütlich, freundlicher NPC, Handwerk, Bauernhof, leichte Menü-Hintergrundmusik oder Alltagsszenen. - Verwende
dungeonfü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
sadfü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,DoderEzu, wenn keine genaue Tonart angegeben ist. Ordne helle/heldenhafte/gemütliche Beschreibungen den TonartenC,FoderGzu. Verwenderandom, 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 setzesadnahe 92 BPM. - Für finalen oder produktionsreifen BGM füge
--midi --stemshinzu. Für Erkundung füge--variants 5hinzu, 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
coinfür Aufheben, Einsammeln, Belohnung, Edelstein, Gegenstand erhalten, Punktzahl oder positive Bestätigung. - Verwende
confirmfür Menü-OK, Akzeptieren, positiven UI-Klick, kleinen Erfolg oder Dialog fortsetzen. - Verwende
cancelfür Zurück, Ablehnen, Ungültig, UI-Fehler, geschlossenes Menü oder negatives Feedback. - Verwende
jumpfür Springen, Hüpfen, Abprallen, Sprungfeder, UI-Aufwärtsbewegung oder Charakter-Anhebung. - Verwende
dashfür Sprinten, Ausweichen, schnelle Bewegung, Geschwindigkeitsschub oder Luftschritt. - Verwende
landfür Landung, Stampfen, schweren Schritt, Bodenberührung oder kleinen Körperaufprall. - Verwende
laserfür Schießen, Projektil, Zappen, Strahl, Zauber wirken, Blaster oder schnellen magischen Angriff. - Verwende
slashfür Schwert, Klinge, Klaue, Hieb, Schnitt, Nahkampfangriff oder schnellen Schwung-Treffer. - Verwende
hitfür Schaden, Schlag, Aufprall, Verletzung, getroffener Gegner oder Körperkontakt. - Verwede
blockfür Schild, Parieren, Blocken, Rüstungstreffer, Ablenken oder Metall/Stein-Aufprall. - Verwende
explosionfür Explosion, Bruch, Absturz, Detonation, Zerstörung, Fass, Bombe oder großen Einschlag. - Verwende
powerupfür Verbesserung, Levelaufstieg, Freischaltung, Buff, Heilung, seltenen Gegenstand, Erfolgsfanfare oder Verwandlung. - Verwende
healfür Heilen, Wiederherstellen, Trank, Wiederbelebung, magisches Funkeln oder sanften positiven Effekt. - Verwende
teleportfür Teleportieren, Verschwinden, Portal, Wiederbelebungspunkt oder Phasenwechsel. - Verwende
doorfür Tür, Schalter, Hebel, Tor, Mechanismus, Schloss oder schweres UI-Panel. - Verwende
chestfür Schatztruhe, Belohnungsenthüllung, Gegenstandsfanfare, Öffnen von Beute oder seltenem Aufheben. - Verwende
blipfür UI-Cursor, Menübewegung, kleine Auswahl, Tippen, Benachrichtigung, dezenten Piepton oder neutrales Feedbacksignal. - Verwende
alertfür Warnung, Alarm, Erkennung, Ausruf, niedrige Gesundheit oder zeitliche Gefahr. - Verwende
fallfür Fallen, Fehlschlag, Fallenlassen, Verlieren, falsche Antwort, Abwärtsübergang oder Game-Over-Stinger. - Verwende
defeatfür Tod, Spielerverlust, Game Over, besiegter Gegner oder dramatisches Scheitern. - Verwende
whooshfü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 GodotAudioStreamRandomizer-Ressource.--res-prefix PRÄFIX: Ressourcen-Präfix, das innerhalb der generierten Godot.tresverwendet 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.