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
another_song	name
	name_en
	song_file_name
	vocal_chara_num				enum: [MIK, RIN, LEN, LUK, KAI, MEI, NER, HAK, SAK, TET] (?)
	vocal_disp_name
	vocal_disp_name_en
auth_replace_by_module
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
chrcam	[array index]	chara			enum: [MIK, RIN, LEN, LUK, KAI, MEI, NER, HAK, SAK, TET, EXT]
		id
		name
		org_name
	length
chreff	[array index]	data	[array index]	name
				type	enum: [AUTH3D, AUTH3D_OBJ]
			length
		id
		name			enum: [MIK, RIN, LEN, LUK, KAI, MEI, NER, HAK, SAK, TET, EXT]
	num
chrmot	[array index]	chara			enum: [MIK, RIN, LEN, LUK, KAI, MEI, NER, HAK, SAK, TET, EXT]
		id
		name
		org_name
	length				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.
date
difficulty	attribute	extra			bool
		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	Specifies if the chart has Slide notes in it. It also adds the slide icon in the Song Select Screen.
			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.
disable_calc_motfrm_limit					bool
disp2d	set_name				string 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
edit
edit_chara_scale	bool
edit_effect
edit_effect_low_field
effect_se_file_name
effect_se_name_list
ex_song	[array index]	chara
		file
	length
eyes_base_adjust_type
eyes_xrot_adjust
eyes_rot_rate
frame_texture
frame_texture_a
frame_texture_b
frame_texture_c
frame_texture_d
frame_texture_e
frame_texture_type
frame_texture_a_type
frame_texture_b_type
frame_texture_c_type
frame_texture_d_type
frame_texture_e_type
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.
mdata	dir
	flag
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
osage_init
pack
performer	[array index]	chara			enum: [MIK, RIN, LEN, LUK, KAI, MEI, NER, HAK, SAK, TET, EXT]
		costume
		exclude
		fixed
		item_back
		item_face
		item_neck
		item_zujo
		pv_costume
		pseudo_same_id
		size			enum: [NORMAL, PLAY_CHARA, PV_CHARA, SHORT, TALL]
		type			enum: [VOCAL, PSEUDO_DEFAULT, PSEUDO_SAME, PSEUDO_SWIM, PSEUDO_SWIM_S, PSEUDO_MY_CHARA, GUEST]
	num
pre_play_script					bool
pv_expression	file_name
pv_item
pvbranch_success_se_name
rank_board_id
remix_parent
resolution_scale
resolution_scale_neo
sabi	play_time
	start_time
se_name
slide_name
slidertouch_name
song_file_name
song_name
song_name_en
song_name_reading
song_name_reading_en
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+ by default
			val		string
	guitar_player				string
	illustrator				string	illustrator isn't displayed in MM+ by default
	lyrics				string
	manipulator				string
	music				string
	pv_editor				string
sudden_timing
stage_param
title_image	aet_name				string
	end_time				number
	time				number
use_osage_play_data					bool