DivaScript

DivaScript (commonly referred to as DSC) is the file format used by all the Project DIVA games for storing various commands related to Music Videos/PVs and Rhythm Game Charts.

The data inside .dsc files is stored in a binary format. This means that they can not be edited with a text editor and instead require specialized programs that can decode them such as DSC Studio or ScriptEditor. Additionally, .dsc files from Project DIVA F2nd and Project DIVA X are encrypted using DIVAFILE encryption. They need to be decrypted before editing.

DSC Formats

Every Project DIVA game uses a specific DivaScript format. The exact format of a .dsc file is determined by the first 4 bytes of the file.

List of DSC Commands (Incomplete)

AGEAGE_CTRL

Controls the effect for the hair of the module "AgeAge Again".

AFT: AGEAGE_CTRL(chara, side, unk1, scale, unk2, unk3, -1, -1);

Parameter	Description	Required	Type
chara	Character slot	True	int
side	Side to control	True	enum: 0: both 1: left 2: right
unk1	Unknown	True	int
scale	Effect scale	True	int
unk2	Unknown	False	int
unk3	Unknown	True	int

BAR_TIME_SET

Sets the length of a measure.

BAR_TIME_SET(bpm, beats);

Parameter	Description	Required	Type
bpm	Beats per minute	True	int
beats	Number of quarter note beats minus 1. eg.: 3 for 4/4.	True	int

BLOOM

Sets data from bloom pv_param.

AFT, F2, X: BLOOM(id, unk);

Parameter	Description	Required	Type
id	ID matching the data in pv_param.	True	int
unk	Unknown	True	int

CHANGE_FIELD

Changes the field defined in pv_field/pv_db.

CHANGE_FIELD(id);

Parameter	Description	Required	Type
id	ID matching the field number in pv_field or pv_db.	True	int

F2, X: CHANGE_FIELD(id, unk);

CHARA_SIZE

Sets a character's scale/size.

CHARA_SIZE(chara, size);

Parameter	Description	Required	Type
chara	Character slot	True	int
size	Character scale	True	int

END

Ends reading of the script.

END();

HAND_SCALE

Set the size of a character's hand.

AFT: HAND_SCALE(chara, hand, scale);

Parameter	Description	Required	Type
chara	Character slot	True	int
hand	Which hand	True	enum: 1: left 2: right
scale	Hand scale in percentage times 10; eg.: for 105% use 1050	True	int

LYRIC

Display a lyric from pv_db.

LYRIC(id, color);

Parameter	Description	Required	Type
id	ID matching the number of a lyric in pv_db. Use -1 as "disable".	True	int
color	#AARRGGBB hex color code converted to decimal. eg.: for a red lyric the command would be LYRIC(id, 16711680); because Red: #00FF0000 → 0x00ff0000 → 16711680 Default: -1	False	int

SCENE_FADE

Plays a fade effect during PVs

SCENE_FADE(time, start, end, r, g, b)

Parameter	Description	Required	Type
time	The amount of time the fade effect should play for	True	int
start	the beginning of the fade effect	True	int
end	the end of the fade effect	True	int
r	red color code	True	int
g	green color code	True	int
b	blue color code	True	int