Porymap Settings

Porymap uses config files to read and store user and project settings. A global settings file is stored in a platform-dependent location for app configuration files (%Appdata%\pret\porymap\porymap.cfg on Windows, ~/Library/Application\ Support/pret/porymap/porymap.cfg on macOS).

A config file is also created when opening a project in porymap for the first time. It is stored in your project root as porymap.project.cfg. There are several project-specific settings that are determined by this file.

Setting	Default	Location	Can Edit?	Description
recent_project		global	yes	The project that will be opened on launch
reopen_on_launch	1	global	yes	Whether the most recent project should be opened on launch
recent_map		global	yes	The map that will be opened on launch
pretty_cursors	1	global	yes	Whether to use custom crosshair cursors
map_sort_order	group	global	yes	The order map list is sorted in
window_geometry		global	no	For restoring window sizes
window_state		global	no	For restoring window sizes
map_splitter_state		global	no	For restoring window sizes
main_splitter_state		global	no	For restoring window sizes
collision_opacity	50	global	yes	Opacity of collision overlay
metatiles_zoom	30	global	yes	Scale of map metatiles
show_player_view	0	global	yes	Display a rectangle for the GBA screen radius
show_cursor_tile	0	global	yes	Display a rectangle around the hovered metatile(s)
monitor_files	1	global	yes	Whether porymap will monitor changes to project files
region_map_dimensions	32x20	global	yes	The dimensions of the region map tilemap
theme	default	global	yes	The color theme for porymap windows and widgets
text_editor_goto_line		global	yes	The command that will be executed when clicking the button next the Script combo-box.
text_editor_open_directory		global	yes	The command that will be executed when clicking Open Project in Text Editor.
base_game_version		project	no	The base pret repo for this project
use_encounter_json	1	project	yes	Enables wild encounter table editing
use_poryscript	0	project	yes	Whether to open .pory files for scripts
use_custom_border_size	0	project	yes	Whether to allow variable border sizes
enable_event_weather_trigger	1 if not pokefirered	project	yes	Allows adding Weather Trigger events
enable_event_secret_base	1 if not pokefirered	project	yes	Allows adding Secret Base events
enable_event_clone_object	1 if pokefirered	project	yes	Allows adding Clone Object events
enable_hidden_item_quantity	1 if pokefirered	project	yes	Adds Quantity to Hidden Item events
enable_hidden_item_requires_itemfinder	1 if pokefirered	project	yes	Adds Requires Itemfinder to Hidden Item events
enable_heal_location_respawn_data	1 if pokefirered	project	yes	Adds Respawn Map and Respawn NPC to Heal Location events
enable_floor_number	1 if pokefirered	project	yes	Adds Floor Number to map headers
create_map_text_file	1 if not pokeemerald	project	yes	A text.inc or text.pory file will be created for any new map
enable_triple_layer_metatiles	0	project	yes	Enables triple-layer metatiles (See https://github.com/pret/pokeemerald/wiki/Triple-layer-metatiles)
custom_scripts		project	yes	A list of script files to load into the scripting engine
prefabs_filepath	<project_root>/prefabs.json	project	yes	The filepath containing prefab JSON data

Some of these settings can be toggled manually in porymap via the Options menu.