BOXとは
DTXMania では、任意個の曲データを格納したフォルダを「BOX」として認識させることができます。
BOX の中に BOX を設けることも可能なので、曲リストは BOX によるツリー構造を構成することができます。
以下の例では、「DTXMania Maniacs 2023」という名前の BOX が存在しています。
この BOX を選択すると、BOX の中に入ることができます。
BOXを作る
BOX を作成する方法には、手軽な方法と、詳細な方法の2通りがあります。
方法1. フォルダの名前を変える
最も手軽な方法は、フォルダを「DTXFiles.」で始まる名前に変更することです（ピリオドを忘れないこと）。
それだけで、そのフォルダが BOX だと認識されます。
「DTXFiles.」に続く文字列が、BOX の名前となります。
（例：フォルダ名「DTXFiles.DTXMania Maniacs 2023」→ BOX名「DTXMania Maniacs 2023」）
方法2. box.def ファイルを作る
もうひとつの方法は、BOXにしたいフォルダの中に box.def という名前のBOX の情報を記述したテキストファイルを置くことです（文字コードは ShiftJIS または UTF-8 です）。DTXMania は、box.def ファイルが置かれているフォルダを BOX だと認識します。
以下に、box.def の記述例を示します。
#TITLE: DTXMania Maniacs 2023
#PREIMAGE: preimage.png
「#TITLE:」行は、BOX 名を定義します。
「#PREIMAGE:」行は、BOX のプレビュー画像ファイル名を、box.def の存在するフォルダからの相対パスで指定します。
box.def に記述できる項目は以下の通りです。（塗りつぶされている行は、現状の DTXMania では対応していません。）
| 項目名 | 内容 | 例 |
|---|---|---|
| TITLE | BOX 名。 | #TITLE: 自分の譜面 |
| ARTIST | アーティスト名。 | #ARTIST: FROM |
| COMMENT | BOXへのコメント。 | #COMMENT: 2023年の制作です。 |
| PREIMAGE | プレビュー画像ファイルへの相対パス。 | #PREIMAGE: preimage.png |
| PREMOVIE | プレビュー動画ファイルへの相対パス。 | #PREMOVIE: premovie.mp4 |
| PREVIEW | プレビュー音声ファイルへの相対パス。 | #PREVIEW: preview.ogg |
| FONTCOLOR | BOX のテキストの色。 | #FONTCOLOR: #FFFFFF |
| PERFECTRANGE | BOX内の曲に適用される Perfect 判定の範囲（ミリ秒）。 | #PERFECTRANGE: 34 |
| GREATRANGE | BOX内の曲に適用される Great 判定の範囲（ミリ秒）。 | #GREATRANGE: 67 |
| GOODRANGE | BOX内の曲に適用される Good 判定の範囲（ミリ秒）。 | #GOODRANGE: 84 |
| OKRANGE | BOX内の曲に適用される Ok 判定の範囲（ミリ秒）。 | #OKRANGE: 117 |
注意
「DTXFiles.」で始まるフォルダの中に box.def を入れると、BOX の中に BOX ができます。
曲リストを更新する
BOXを追加・変更・削除したあとには、曲データのキャッシュデータベースを更新する必要があります。
はじめに「オプション設定画面」へ移動します。
「曲リストの更新」項目を選択し、決定します。
OKボタンをクリックします。
曲データの検索が始まるので、完了するまで待ちます。
- ウェイティングスピナー（画面中央でぐるぐる回るやつ）と画面左上の進捗表示文字が消えれば、検索完了です。
- 曲読み込みフォルダに登録されたすべての曲フォルダに対して検索を行なうので、時間がかかる場合があります。
検索が完了したら、ESCキーを押下して選曲画面に戻ります。
選曲画面で、BOX の追加・変更・削除が反映されていることを確認してください。