BOXとは

いくつかの曲データを格納したフォルダを「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 の情報を記述した box.def という名前のテキストファイルを置くことです(文字コードは 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 では対応していません。)

項目名内容
TITLEBOX 名。#TITLE: 自分の譜面
ARTISTアーティスト名。#ARTIST: FROM
COMMENTBOXへのコメント。#COMMENT: 2023年の制作です。
PREIMAGEプレビュー画像ファイルへの相対パス。#PREIMAGE: preimage.png
PREMOVIEプレビュー動画ファイルへの相対パス。#PREMOVIE: premovie.mp4
PREVIEWプレビュー音声ファイルへの相対パス。#PREVIEW: preview.ogg
FONTCOLORBOX のテキストの色。#FONTCOLOR: #FFFFFF
PERFECTRANGEBOX内の曲に適用される Perfect 判定の範囲(ミリ秒)。#PERFECTRANGE: 34
GREATRANGEBOX内の曲に適用される Great 判定の範囲(ミリ秒)。#GREATRANGE: 67
GOODRANGEBOX内の曲に適用される Good 判定の範囲(ミリ秒)。#GOODRANGE: 84
OKRANGEBOX内の曲に適用される Ok 判定の範囲(ミリ秒)。#OKRANGE: 117