box.def format - DTXMania Wiki - DTXMania

box.def file specification

You can use "box.def" text file to set the attributes on the music box. You can use it in the DTXMania Release 059 or later.

In case you use "box.def" file, you don't have to set the folder name like "DTXFiles.xxxxx". You simply make folder with any name, and put "box.def" file into the folder. The format is like this:

#TITLE: FROM DTX Collections
#ARTIST: FROM
#COMMENT: Dazzling floor-tom sequences.
#PREIMAGE: preimage.jpg  ; (or #PREMOVIE: premovie.avi)
#PREVIEW: preview.wav
#FONTCOLOR: #FFFFFF
#PERFECTRANGE: 34        ; (Release 068 (080427) or later)
#GREATRANGE: 67          ; (Release 068 (080427) or later)
#GOODRANGE: 84           ; (Release 068 (080427) or later)
#POORRANGE: 117          ; (Release 068 (080427) or later)
#SKINPATH: FROMSKIN      ; (Release 094 (120610) or later)

You have to specify at least #TITLE (mandatory), and others are options. The name of the music box becomes #TITLE. And you can also set artist name (#ARTIST:), comments (#COMMENT:), preview image (#PREIMAGE:), preview movie (#PREMOVIE:), preview sound (#PREVIEW:) and title color (#FONTCOLOR:).

For DTXMania Release 068 (080427) or later, you can specify PERFECT-POOR hit ranges limited in the box. If you want to specify hit ranges, you have to specify all four(4) values... #PERFECTRANGE, #GREATRANGE, #GOODRANGE and #POORRANGE. This features are supporse to be used for IR (Internet Ranking) events.

For DTXMania Release 094(120610) or later, you can specify #SKINPATH. You can specify relative path from box.def-existing folder to the skin folder. If you specify #SKINPATH, DTXMania switch its skin automatically if you enter the music box. You can disable the feature by System/Skin(Box) settings in CONFIGURATION (by default, it is enabled).