# Porymap Settings — porymap documentation

# 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.