40 lines
2.3 KiB
ReStructuredText
40 lines
2.3 KiB
ReStructuredText
.. _settings-and-options:
|
|
|
|
****************
|
|
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.
|
|
|
|
.. csv-table::
|
|
:header: Setting,Default,Location,Can Edit?,Description
|
|
:widths: 10, 3, 5, 5, 20
|
|
|
|
``recent_project``, , global, yes, The project that will 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
|
|
``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
|
|
``custom_scripts``, , project, yes, A list of script files to load into the scripting engine
|
|
|
|
Some of these settings can be toggled manually in porymap via the *Options* menu.
|