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.txt database as a result.

pv_db databases 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) 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

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

Proprieties can also be chained or composed of lists:

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もっと	list 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	Requirement level	Description
bpm				any number	Critical, omitting this keyword or leaving its value empty will cause the PV to not appear in the Song Select screen.	BPM of the song. Not directly used in MM+, 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	Critical, omitting this keyword or leaving its value empty will cause the PV to not appear in the Song Select screen.	Date of the song's addition to the game. Not directly used in MM+, but required for loading the PV.
difficulty	attribute	original		0 or 1	-
		slide		0 or 1	-	Specifies if the chart has Slide notes in it by adding the icon in the Song Select Screen.
	easy normal hard extreme encore	[list item]	edition	0 or 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/...	Critical, omitting this keyword or leaving its value empty will cause the PV to not appear in the Song Select screen.	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		-
		length		number of entries for each difficulty	Critical, omitting this keyword or leaving its value empty will cause the PV to not appear in the Song Select screen.	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 a AET Set to be called and displayed in the PV.
ex_song	[list item]	chara			-
		file			-
	length				-
eyes_xrot_adjust					-
hidden_timing				decimal number	-	Controls the Hidden Modifier.
high_speed_rate				decimal number	-	Controls the High Speed Modifier.
lyric lyric_en	[lyric number] (3 digits, including leading 0's)			String containing the lyric. Each numbered lyric can be called in the PV script.	-
					-
motion motion2P motion3P motion4P motion5P motion6P	[motion number] (2 digits, including leading 0)
pack
performer	[list item]	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
	illustrator
	lyrics
	music
sudden_timing