プレイリストの追加

あなたのプレイリストファイルは Sound/BGM/Playlist サブフォルダーに配置されます。これらはシンプルなJSONファイルの形式です。

{
    "shuffle": true,
    "list": [
        "megalovania"
    ],
    "remove": [
        "024 PSML514",
        "023 mysterious-forest"
    ]
}

list に含まれるオーディオID（BGM IDではありません）はプレイリストに追加され、remove はプレイリストからエントリーを削除します（存在する場合）。既存のゲームオーディオIDを使用することもできます。shuffle はそのリストがランダムに並べ替えられるかどうかを設定します。

あなたは list と remove リストでワイルドカードを使用することもできます。現在、2つのモードが提供されています：

"remove": [
	"**"
]

これは、マージ前にすべてのトラックをクリアします。

"remove": [
	"<dir>/*"
]

これは、マージ前に Sound/BGM/<dir>/ フォルダーからのすべてのトラックをクリアします。

プレイリストタイプ

プレイリストのJSONファイル名は、以下のいずれかと一致する必要があります：

• "Global"
• 既存のプレイリスト名
• エリアタイプリスト
• エリアIDリスト

ここにゲーム内で既に存在するプレイリストがあります：

プレイリスト

• Battle [1]
  • 102 punipuni
• Blank [4]
  • 041 earlgrey
  • 090 hirusagari
  • 044 heya_guitar 1
  • 043 Along-the-riverside-road
• Day [1]
  • 004 hoshinokiseki
• Dungeon [4]
  • 024 PSML514
  • 022 Pyramid-naibu
  • 023 mysterious-forest
  • 048 nazoooki shinden
• Dungeon2 [6]
  • 072 Netherworld_Shanty
  • 077 dragon and toast
  • 078 legend of one
  • 079 koudou
  • 080 big mojo
  • 081 exotics
• Dungeon_Boss [1]
  • 098 Pixel Myth
• EloMap [3]
  • 006 elomap2
  • 007 elomap3
  • 059 tyris4
• Festival_Noyel [1]
  • 051 yuki
• Festival_Olvina [1]
  • 051 yuki
• Festival_Yowyn [1]
  • 093 cat life
• Field [1]
  • 015 Atlantean_Twilight256
• Hoard [1]
  • 053 hoard
• Lot [1]
  • 001 no bgm
• Night [2]
  • 005 elomap1
  • 004 hoshinokiseki
• Underground [2]
  • 046 dwarf
  • 047 nonbiri dwarf

Blank は、明示的に指定されたプレイリストがないすべてのZoneのデフォルトプレイリストです。

Zoneタイプ名とそのプレイリストを確認してください：

SourceZone

https://docs.google.com/spreadsheets/d/16-LkHtVqjuN9U0rripjBn-nYwyqqSGg_/edit?gid=2144211469#gid=2144211469

全局リスト

Global.json という特別なプレイリストを準備することで、すべてのプレイリストに統合されます。

指定プレイリスト

例えば、すべてのダンジョンエリア（Zone_RandomDungeon、Zone_RandomDungeonFactory、Zone_Mine など）は、Dungeon という名前のプレイリストを共有しています。このプレイリストに曲を追加または削除したい場合は、Sound/BGM/Playlist/ フォルダー内に Dungeon.json を準備する必要があります。

Dungeon.json 内での変更は、ゲームの Dungeon プレイリストに統合され、曲の追加や削除が行われます。これは、このプレイリストを共有するすべてのエリアに影響を与えます。

別の一般的な使用例は、大マップにいるときに曲を追加することです。大マップは Region タイプのエリアであり、EloMap というプレイリストがあります。

エリアタイプリスト

プレイリストの統合に加えて、各エリアタイプに対してエリアオーバーライドを指定することもできます。これらのプレイリストはエリアタイプ名を使用し、その内容はエリアのデフォルトプレイリストに統合されます（表に指定がない場合は Blank になります）。

例えば、Zone_Vernis.json はヴェルニスエリアタイプのオーバーライドを行い、Zone_Forest はこのタイプを使用する草原と森林に対してオーバーライドを行います。

したがって、Region.json を使用して大マッププレイリストに曲を追加することも可能です。なぜなら、これは Region タイプを使用しているからです。

エリアIDリスト

同じエリアタイプに複数の異なるエリアが存在する場合、エリアIDを使用して個別にオーバーライドすることができます。例えば、Zone_dungeon 洞窟と Zone_dungeon_ruin 遺跡はどちらも Zone_RandomDungeon エリアタイプに属し、そのIDを使用して個別に指定できます。エリアIDを使用する際は、特定の N 層を指定するために @N を追加することもできます。例えば、ダルフィ地下1層は [email protected] となります。

統合順序

複数のプレイリストが同時に存在することができ、それらは全局リスト、指定プレイリスト、エリアタイプリスト、エリアIDリストの順に統合されます。重複する曲は削除されます。プレイリストの統合順序は、Modの読み込み順序にも影響されます。remove リストでワイルドカードを使用する際は、プレイリストの統合順序が最終的な曲リストと順序に影響を与えることを忘れないでください。

ホットリロード/BGM ビュー

ゲーム内でセーブデータを読み込んだ後、CWLパネルを使用して現在のプレイリストを表示および制御できます：

ゲームが実行中のときにプレイリストのJSONを編集した後、すべてのプレイリストをホットリロードできます。CWLには新しいオーディオのホットリロード用のコンソールコマンドがありますが、インデックスの問題が発生する可能性があるため、使用は推奨されません。

最後の例

大マップ探索のすべてのデフォルト曲を削除し、新しい曲を追加したい場合は、Sound/BGM/Playlist/EloMap.json または Sound/BGM/Playlist/Region.json を使用します：

{
    "shuffle": true,
    "list": [
        "my new BGM sound id1",
        "my new BGM sound id2"
    ],
    "remove": [
        "**"
    ]
}