User:GGAB3/Sandbox

Project DIVA games store general information about the PVs in a database file called pv_db.txt, located in the rom folder. The data inside is stored in plain text, meaning the file can be opened and edited using any text editor, such as Notepad.

For the later games (Project DIVA F2nd and Project DIVA X) the pv_db file is encrypted using DIVAFILE encryption. They need to be decrypted before editing.

Multiple pv_db databases can not be loaded sequentially. Instead, only the contents of the last loaded pv_db file gets parsed by the game, overwriting the entire base game pv_db as a result.

pv_db files can have a prefix in their file name to indicate a specific use case:

• mdata_pv_db - Primarily used in Project DIVA Arcade Future Tone's MDATA system. It is also seen in games such as Project DIVA Mega Mix+, where it is used as the dlc pv_db.
• mod_pv_db - Custom prefix read by DivaModLoader for Project DIVA Mega Mix+ mods. The contents of each mod_pv_db gets loaded sequentially, in the mod load order. Entries pointing to the same PV slot get overwritten in load order.

Structure

Similarly to other plain text databases in Project DIVA, proprieties/keywords are separated by . and values are attributed to certain proprieties using =. All lines in the database need to be written in lexicographical order (a → z, 0 → 9 etc.) in order to be parsed correctly by the game.

Each entry in a pv_db begins by specifying the PV slot to which we can attach a propriety and attribute a value, like this:

pv_###.propriety=value

Example:

pv_268.date=202001001 (meaning pv_268 [Catch the Wave]'s date is 01 Jan 2020.)

Proprieties can also be chained or composed of arrays:

pv_268.songinfo.lyrics=kz pv_268.songinfo.music=kz	chained properties
pv_268.lyric.001=Catch the wave君と pv_268.lyric.002=掴む音で pv_268.lyric.003=まだまだ歌おう pv_268.lyric.004=Wave your handsもっと	array properties

List of valid pv_db keywords

All the keywords that can be used in pv_db are defined in the game's internal systems. Here is a table with all the keywords that can be used after pv_###.:

Keywords and derived keywords					Valid values	Description
bpm					any number	BPM of the song. Not directly used in the game but required for loading the PV.
chainslide_failure_name
chainslide_first_name
chainslide_sub_name
chainslide_success_name
date					any number representing a date formatted like yyyymmdd	Date of the song's addition to the game. Not directly used in game but required for loading the PV.
difficulty	attribute	original			bool
		slide			bool	Specifies if the chart has Slide notes in it. It also adds the slide icon in the Song Select Screen.
	easy normal hard extreme encore	[array index]	attribute	extra	bool
				original	bool
				slide	bool
			edition		any number	1 sets the chart as "extra". Normally only used to set an additional extreme entry as Extra Extreme.
			level		string formatted like PV_LV_XX_Y, where XX is a number from 01 to 10 (including leading 0) and Y is either 0 or 5.	Sets the chart's star rating.
			level_sort_index		any number
			script_file_name		path to the script file, relative to the folder the content is being loaded from: rom/...	Specifies where the chart's script is located.
			script_format		hex number representing the contents of the .dsc's first 4 bytes	Specifies the script format.
			version		any number
		length			number of items in array for each difficulty	Sets the length for each difficulty. Usually set to 1 and only set to 2 for extreme entries that have Extra Extreme.
disp2d	set_name				number from the corresponding aet_gam_pv###.bin Aet Set.	Links an Aet Set to be called and displayed in the PV.
	target_shadow_type
	title_2d_layer
	title_end_2d_field
	title_end_2d_low_field
	title_end_3d_field
	title_start_2d_field
	title_start_2d_low_field
	title_start_3d_field
ex_song	[array index]	chara
		file
	length
eyes_xrot_adjust
hand_item	[array index]
hidden_timing					decimal number	Controls the Hidden Modifier.
high_speed_rate					decimal number	Controls the High Speed Modifier.
is_old_pv					bool
lyric lyric_en	[lyric array index] (3 digits, including leading 0's)				String containing the lyric. Each numbered lyric can be called in the PV script in any order.
motion motion2P motion3P motion4P motion5P motion6P	[motion array index] (2 digits, including leading 0)
movie_list	[array index]			name	path to a movie file, relative to the folder the content is being loaded from: rom/...
	length				number of items is array
movie_file_name					path to a movie file, relative to the folder the content is being loaded from: rom/...
movie_pv_type					enum: ONLY ALTERNATELY PARALLEL EFFECT
movie_surface					enum: BACK FRONT
npr	chara_lightness
pack
performer	[array index]	chara
		pv_costume
		size
		type
	num
pv_expression	file_name
rank_board_id
sabi	play_time
	start_time
se_name
slide_name
slidertouch_name
song_file_name
song_name
song_name_en
song_name_reading
songinfo songinfo_en	arranger				string
	ex_info	0 1 2 3 [this is not a proper array]	key		string	Used for custom songinfo credits. ex_info isn't displayed in MM+
			val		string
	guitar_player				string
	illustrator				string	illustrator isn't displayed in MM+
	lyrics				string
	manipulator				string
	music				string
sudden_timing