Chipgen
バンドルされたNodeスクリプトを使用して、決定論的な8ビット音楽とSFXをローカルで生成します。Node.js 16以降が必要です。
スクリプトはこのスキルフォルダからの相対パス scripts/chipgen.js にあります。node で実行し、stdoutをJSONとして取得します。エラーはstderrに出力されます。
新機能の作業、生成されたマニフェスト、ユーザー向けサマリーには、英語優先の表現を使用してください。ブラウザUIを編集する際は、繁体字中国語のサポートを第2言語として維持してください。
ワークフロー
- 出力ディレクトリを解決します。ユーザーが指定しない場合は、カレントプロジェクトの
generated-audio/を使用します。 - 以下の「ブリーフ→パラメータ変換ルール」を使用して、ユーザーリクエストからパラメータを選択します。シードが提供されない場合は、いずれかを選択し、結果を再現可能にするために報告します。
- 有効なムード、キー、またはSFXカテゴリが必要な場合は、
node <skill-dir>/scripts/chipgen.js listを実行します。 - リクエストされたアセットを生成します。ユーザーがサウンドトラックパック、シーンセット、または「異なるシーンだが同じスタイル」を要求した場合は
music-packを使用します。 - 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インポートでループモードを有効にする必要がある場合があることをユーザーに通知します。