Communitygithub.com

888wing/8bit-music-generator

シード値ベースの8ビット音楽と効果音をローカルで生成するCodexスキル

8bit-music-generator とは?

このスキルは、ローカルのNode.jsスクリプトを使用して、シード値に基づいた決定論的な8ビット音楽(BGM)と効果音(SFX)を生成します。開発者は自然言語の指示から、ゲームシーンに適したムード(adventure/battle/boss/town/dungeon/sadなど)、キー、小節数、BPMを自動で推論し、CLI経由で一貫性のあるオーディオアセットを生成できます。特に、複数のシーンを同じスタイルでつなぐ「music-pack」機能や、Godotエンジン向けのAudioStreamRandomizerリソース(.tres)の出力に対応しており、ゲーム開発ワークフローへの統合が容易です。出力されたJSONマニフェストから生成パスやシード、バリアント情報を読み取れるため、後続の処理や再生成にも利用できます。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Chipgen

バンドルされたNodeスクリプトを使用して、決定論的な8ビット音楽とSFXをローカルで生成します。Node.js 16以降が必要です。

スクリプトはこのスキルフォルダからの相対パス scripts/chipgen.js にあります。node で実行し、stdoutをJSONとして取得します。エラーはstderrに出力されます。

新機能の作業、生成されたマニフェスト、ユーザー向けサマリーには、英語優先の表現を使用してください。ブラウザUIを編集する際は、繁体字中国語のサポートを第2言語として維持してください。

ワークフロー

  1. 出力ディレクトリを解決します。ユーザーが指定しない場合は、カレントプロジェクトの generated-audio/ を使用します。
  2. 以下の「ブリーフ→パラメータ変換ルール」を使用して、ユーザーリクエストからパラメータを選択します。シードが提供されない場合は、いずれかを選択し、結果を再現可能にするために報告します。
  3. 有効なムード、キー、またはSFXカテゴリが必要な場合は、node <skill-dir>/scripts/chipgen.js list を実行します。
  4. リクエストされたアセットを生成します。ユーザーがサウンドトラックパック、シーンセット、または「異なるシーンだが同じスタイル」を要求した場合は music-pack を使用します。
  5. stdoutからJSONマニフェストを読み取り、生成されたファイルパス、シード、ムード/カテゴリ、BPM、およびMIDI/ステム/tres出力を報告します。

ブリーフ→パラメータ変換

自然言語のゲームオーディオブリーフからパラメータを推論します。質問をするよりも、適切な最初のパスを優先します。ただし、リクエストに互換性のない制約がある場合は除きます。

音楽ムードの選択

  • オーバーワールド、旅、オープニング、探検、英雄的、希望的、明るい、タイトル画面、マップ、発見、森、空、海、または一般的なプラットフォーマーBGMには adventure を使用します。
  • 通常の戦闘、追跡、危険、アクション、タイムチャレンジ、敵の波、高速アーケードの強度、またはボス戦ではない緊迫したゲームプレイには battle を使用します。
  • ボス、最終ボス、ライバル戦、クライマックス、抑圧的、悪魔的、ハイステークス、終盤、レイド、または「battleよりも強烈にする」には boss を使用します。
  • 町、村、ショップ、宿屋、拠点、安全地帯、居心地の良い、友好的なNPC、クラフト、農場、軽いメニューBGM、または日常的なシーンには town を使用します。
  • 洞窟、遺跡、ミステリー、ステルス、迷路、夜、下水道、研究所、エイリアン、幽霊、水中、雪/氷(ブリーフが悲劇的ではなく寂しい/寒い/神秘的な場合)には dungeon を使用します。
  • 喪失、ゲームオーバー、記憶、エンディング、荒廃した家、別れ、死、孤独、メランコリー、感情的なカットシーン、または雪/氷(ブリーフが明らかに悲しみを含む場合)には sad を使用します。

ブリーフにムードが混在している場合は、最初にゲームプレイ機能を選択し、次に感情を選択します。例:「悲しいボス戦」は boss にします。「寂しい雪のレベル、ただし遅すぎない」は、通常 sad ではなく、上限寄りのBPMを持つ dungeon にします。

音楽キー、小節数、BPM

  • 明示的なキーリクエストは直接使用します。正確なキーが指定されていない場合、「minor」のブリーフは A、D、または E にマッピングします。明るい/英雄的/居心地の良いブリーフは C、F、または G にマッピングします。ユーザーが驚きを求めているか、音の方向性を指定していない場合は random を使用します。
  • クイックプレビュー、短いループ、スティンガー、または多くの候補が必要な場合は8小節を使用します。通常のループBGMには16小節を使用します。長めのアンビエント/バックグラウンドリクエストには32小節を使用します。
  • BPMが指定されていない場合は、ジェネレーターにムード範囲内で選択させます。ユーザーがより速く/遅くを要求した場合は、選択したムード範囲の上限/下限付近にBPMを設定します。ユーザーが「遅すぎない」と言った場合、感情がそれを要求しない限り sad を避けるか、sad を92 BPM付近に設定します。
  • 最終版またはプロダクション対応のBGMの場合は、--midi --stems を含めます。探索用の場合は、ユーザーが単一の結果を要求しない限り、--variants 5 を含めます。

音楽パックの選択

リクエストが完全な小さなサウンドトラック、シーンパック、一連のキュー、または複数のゲームシーン向けの1つの一貫したスタイルの音楽を要求する場合は、music-pack を使用します。

music-pack は、1つのシードファミリーと1つの解決されたキーから6つのキューを生成します。

  • テーマ: adventure、16小節
  • 町: town、16小節
  • ダンジョン: dungeon、16小節
  • 戦闘: battle、8小節
  • ボス: boss、16小節
  • エンディング: sad、8小節

これは --variants とは異なります。バリアントは1つのシーンを固定し、派生シードのみを変更します。音楽パックは、トーナルセンターとシードファミリーの一貫性を保ちながら、シーン機能を変更します。

SFXカテゴリの選択

  • ピックアップ、収集、報酬、宝石、アイテム入手、スコア、または肯定的な確認には coin を使用します。
  • メニューOK、受け入れ、肯定的なUIクリック、小さな成功、またはダイアログの続行には confirm を使用します。
  • 戻る、拒否、無効、UIエラー、メニューを閉じる、または否定的なフィードバックには cancel を使用します。
  • ジャンプ、ホップ、バウンド、スプリング、UI上方向の動き、またはキャラクターの浮上には jump を使用します。
  • ダッシュ、回避、素早い移動、スピードバースト、または空中ステップには dash を使用します。
  • 着地、踏みつけ、重い足音、地面接触、または小さな身体の衝撃には land を使用します。
  • 射撃、発射物、ザップ、光線、呪文発動、ブラスター、または素早い魔法攻撃には laser を使用します。
  • 剣、刃、爪、スワイプ、切断、近接攻撃、または高速なウィッシュヒットには slash を使用します。
  • ダメージ、パンチ、衝撃、被弾、敵が打たれた、または身体接触には hit を使用します。
  • 盾、パリィ、ガード、アーマーヒット、デフレクト、または金属/石の衝撃には block を使用します。
  • 爆発、破壊、クラッシュ、ブラスト、破壊、ドラム缶、爆弾、または大きな衝撃には explosion を使用します。
  • アップグレード、レベルアップ、アンロック、バフ、回復、レアアイテム、成功の飾り、または変身には powerup を使用します。
  • 回復、リストア、ポーション、蘇生、マジックスパークル、または優しいポジティブ効果には heal を使用します。
  • テレポート、消失、ワープ、ポータル、リスポーン、またはフェーズシフトには teleport を使用します。
  • ドア、スイッチ、レバー、ゲート、メカニズム、ロック、または重いUIパネルには door を使用します。
  • 宝箱、報酬公開、アイテムファンファーレ、戦利品オープン、またはレアピックアップには chest を使用します。
  • UIカーソル、メニュー移動、小さな選択、タイピング、通知、控えめなビープ音、または中立的なインターフェースフィードバックには blip を使用します。
  • 警告、警報、探知、感嘆符、低ヘルス、または時間制限のある危険には alert を使用します。
  • 落下、失敗、ドロップ、喪失、不正解、下降トランジション、またはゲームオーバースティンガーには fall を使用します。
  • 死亡、プレイヤー敗北、ゲームオーバー、敵撃破、または劇的な失敗には defeat を使用します。
  • 空気の動き、スイング準備、トランジション、高速通過、または抽象的な動きには whoosh を使用します。

繰り返し使用するゲームプレイSFXの場合は、--variants 5 を生成します。UIサウンドの場合は、3~5個の候補を生成し、blip、coin、または hit を選択して random を避け、持続時間を短く保ちます。

コマンド

サポートされている値の一覧表示:

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

BGMの生成:

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

1つのシードファミリーからBGM候補を生成:

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

6キューのミュージックパックを生成:

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

1つのSFXを生成:

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

Godot用のSFXバリエーションプールを生成:

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

パラメータ

サポートされているムードは、adventure、battle、town、dungeon、sad、boss です。

サポートされているSFXカテゴリは、coin、confirm、cancel、jump、dash、land、laser、slash、hit、block、explosion、powerup、heal、teleport、door、chest、blip、alert、fall、defeat、whoosh、random です。

便利なオプション:

  • --bpm N: 生成されるBPMを上書きします。
  • --bars N: 音楽の長さ。ユーザーが別途要求しない限り、8、16、または32を使用します。
  • --sr N: サンプルレート。デフォルトは44100です。
  • --midi: 音楽用のMIDIをエクスポートします。
  • --stems: 個別の音楽ステムをエクスポートします。
  • --variants N: シードファミリーを生成します。音楽の場合、ムード、解決されたキー、小節数、BPMを固定し、新しいシードを派生させます。SFXの場合、カテゴリを固定します。
  • --no-mix: 混合WAVをスキップします。
  • --no-normalize: SFXのノーマライズを無効にします。
  • --tres PATH: Godotの AudioStreamRandomizer リソースを書き込みます。
  • --res-prefix PREFIX: 生成されたGodot .tres 内で使用されるリソースプレフィックス。

デフォルト

ゲーム対応BGMの場合、ユーザーがクイックプレビューのみを望まない限り、--stems --midi を優先します。

音楽探索の場合、1つのベースシードから5~10個の候補を生成します。CLI出力では、variantIndex: 0 がベースシードであり、後続のアイテムは variantSeed = (baseSeed + 0x9E3779B9 * index) >>> 0 を使用し、indexは1から始まります。候補がランダムではなく関連性があるように感じられるよう、mood、解決された key、bars、bpm を固定します。

コンパクトなゲームサウンドトラックの場合、music-pack --stems --midi を優先します。これにより、1つのシードファミリーからテーマ、町、ダンジョン、戦闘、ボス、エンディングのキューが生成されます。

ゲーム内で繰り返し再生するためのSFXの場合、--variants 5 を優先し、異なるシードバリアントで同じカテゴリを維持します。

Godotプロジェクトの場合、これらのディレクトリが存在するときは assets/audio/bgm と assets/audio/sfx を使用します。ループBGMの場合、GodotのWAVインポートでループモードを有効にする必要がある場合があることをユーザーに通知します。

関連スキル