supplemental files format specificatios

 *?set.def file specifications

To group several DTX/GDA files into single title, you can use set.def file. (DTXMania calls it as "set file".)

set.def file groups these three DTX files into single title.

To make it, please make text file named "set.def" in the folder where DTX files are. Here is a sample;

#TITLE: BRILLIANT DAY

#L1LABEL: BASIC
#L1FILE: brilliant_bas.dtx

#L2LABEL: ADVANCED
#L2FILE: brilliant_adv.dtx

#L3LABEL: EXTREME
#L3FILE: brilliant_ext.dtx

#L4LABEL: EXTREME+
#L4FILE: brilliant_exp.dtx

#L5LABEL: RAW
#L5FILE: brilliant_raw.dtx

#FONTCOLOR: #FFFFFF

As the result, five(5) DTX files are grouped into the single title (BRILLIANT DAY).

item meanings
#TITLE the title name appeared at the MUSIC SELECT screen.
#LxLABEL (x=1-5) means difficulty (label). You can use 0x20-0x7E ASCII characters for it. In case you omit specifying #LxLABEL, the default difficulties are: 1:BASIC, 2:ADVANCE, 3:EXTREME, 4:HYPER and 5:ULTIMATE.
(Note that the default #L2LABEL is NOT ADVANCED, but ADVANCE.)
#LxFILE: (x=1-5) are filenames assigned to the Lx.
#FONTCOLOR: the title color at the MUSIC SELECT screen. The color is specified as the #rrggbb format like the HTML format.

In the folder where set.def file exists, all song files are ignored except in the set.def file.

You don't have to use level number like 1, 2 and 3. For example, you can skip L1 and use only L2 and L3.

You can specify multiple titles in the single set.def file. The #TITLE: separates several definitions. Here is an example that two titles in the single set.def file.

#TITLE: BRILLIANT DAY [DTX]

#L1LABEL: BASIC
#L1FILE: brilliant_bas.dtx

#L2LABEL: ADVANCED
#L2FILE: brilliant_adv.dtx

#L3LABEL: EXTREME
#L3FILE: brilliant_ext.dtx


#TITLE: BRILLIANT DAY [GDA]

#L1LABEL: BASIC
#L1FILE: brilliant_bas.gda

#L2LABEL: ADVANCED
#L2FILE: brilliant_adv.gda

#L3LABEL: EXTREME
#L3FILE: brilliant_ext.gda
last update: June 16th, 2008

 *?box.def file specifications

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)

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:).

Additionaly, for DTXManiaGR 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. I supporse it will be used for IR (Internet Ranking) events.

BTW, the sorting order in the MUSIC SELECT screen is

  1. Alphabetical order (folder name)
  2. Japanese characters order (folder name) ... if non-alphabetical characters are used
  3. Alphabetical order (song data filename)
  4. Japanese characters order (song data filename) ... if non-alphabetical characters are used

So you can sort the music box order as you like, using box.def file. (You determine the folder name for sorting, and determine the title name in the box.def.)

last update: June 16th, 2008