DivaScript

2025-09-24T01:14:13Z

2400:CB00:1046:1000:3A73:B9C3:392C:60C8:

''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 <code>.dsc</code> 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, <code>.dsc</code> 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 <code>.dsc</code> file is determined by the first 4 bytes of the file.
{| class="wikitable"
|}

== List of DSC Commands ''(Incomplete)'' ==

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

AFT: <code>AGEAGE_CTRL(chara, side, unk1, scale, unk2, unk3, -1, -1);</code>
{| class="wikitable mw-collapsible mw-collapsed"
!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.

<code>BAR_TIME_SET(bpm, beats);</code>
{| class="wikitable mw-collapsible mw-collapsed"
!Parameter
!Description
!Required
!Type
|-
|bpm
|Beats per minute
|True
|int
|-
|beats
|Number of quarter note beats minus 1. eg.: <code>3</code> for 4/4.
|True
|int
|}

=== BLOOM ===
Sets data from <code>bloom</code> pv_param.

AFT, F2, X: <code>BLOOM(id, unk);</code>
{| class="wikitable mw-collapsible mw-collapsed"
!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 <code>pv_field</code>/<code>pv_db</code>.

<code>CHANGE_FIELD(id);</code>
{| class="wikitable mw-collapsible mw-collapsed"
!Parameter
!Description
!Required
!Type
|-
|id
|ID matching the field number in <code>pv_field</code> or <code>pv_db</code>.
|True
|int
|}
F2, X: <code>CHANGE_FIELD(id, unk);</code>

=== CHARA_SIZE ===
Sets a character's scale/size.

<code>CHARA_SIZE(chara, size);</code>
{| class="wikitable mw-collapsible mw-collapsed"
!Parameter
!Description
!Required
!Type
|-
|chara
|Character slot
|True
|int
|-
|size
|Character scale
|True
|int
|}

=== END ===
Ends reading of the script.

<code>END();</code>

=== HAND_SCALE ===
Set the size of a character's hand.

AFT: <code>HAND_SCALE(chara, hand, scale);</code>
{| class="wikitable mw-collapsible mw-collapsed"
!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 <code>105%</code> use <code>1050</code>
|True
|int
|}

=== LYRIC ===
Display a lyric from <code>pv_db</code>.

<code>LYRIC(id, color);</code>
{| class="wikitable mw-collapsible mw-collapsed"
!Parameter
!Description
!Required
!Type
|-
|id
|ID matching the number of a lyric in <code>pv_db</code>.
Use <code>-1</code> as "disable".
|True
|int
|-
|color
|<code>#AARRGGBB</code> hex color code converted to decimal.
eg.: for a red lyric the command would be <code>LYRIC(id, 16711680);</code> because
Red: <code>#00FF0000</code> → <code>0x00ff0000</code> → <code>16711680</code>

Default: <code>-1</code>
|False
|int
|}

=== SCENE_FADE ===
Plays a screen fade effect during PVs

<code>SCENE_FADE(speed, start, end, r, g, b)</code>
{| class="wikitable mw-collapsible mw-collapsed"
!Parameter
!Description
!Required
!Type
|-
|speed
|How fast the effect should play, e.g: for <code>100%</code> use <code>1000</code>
|True
|int
|-
|start
|the beginning of the fade effect
from 0 to 1000
|True
|int
|-
|end
|the end of the fade effect
From 0 to 1000
|True
|int
|-
|r
|red color code
|True
|int
|-
|g
|green color code
|True
|int
|-
|b
|blue color code
|True
|int
|}

=== MUSIC_PLAY ===
Start playing the PV music

<code>MUSIC_PLAY();</code>

DivaDocs - User contributions [en]

DivaScript