(<codeclass="docutils literal notranslate"><spanclass="pre">%Appdata%\pret\porymap\porymap.cfg</span></code> on Windows, <codeclass="docutils literal notranslate"><spanclass="pre">~/Library/Application\</span><spanclass="pre">Support/pret/porymap/porymap.cfg</span></code> on macOS).</p>
<p>A selection of the settings in this file can be edited under <codeclass="docutils literal notranslate"><spanclass="pre">Preferences...</span></code>, and the rest are updated automatically while using Porymap.</p>
</div>
<divclass="section"id="project-settings">
<h2>Project settings<aclass="headerlink"href="#project-settings"title="Permalink to this headline">¶</a></h2>
<li><aclass="reference internal"href="#files-identifiers"><spanclass="std std-ref">Files & Identifiers</span></a></li>
</ul>
</div></blockquote>
<p>A config file for project-specific settings is also created when opening a project in porymap for the first time. It is stored in your project root as <codeclass="docutils literal notranslate"><spanclass="pre">porymap.project.cfg</span></code>. You may want to force commit this file so that other users will automatically have access to your project settings.</p>
<p>A second config file is created for user-specific settings. It is stored in your project root as <codeclass="docutils literal notranslate"><spanclass="pre">porymap.user.cfg</span></code>. You should add this file to your gitignore.</p>
<p>The settings in <codeclass="docutils literal notranslate"><spanclass="pre">porymap.project.cfg</span></code> and <codeclass="docutils literal notranslate"><spanclass="pre">porymap.user.cfg</span></code> can be edited under <codeclass="docutils literal notranslate"><spanclass="pre">Options</span><spanclass="pre">-></span><spanclass="pre">Project</span><spanclass="pre">Settings...</span></code>. Any changes made in this window will not take effect unless confirmed by selecting <codeclass="docutils literal notranslate"><spanclass="pre">OK</span></code> and then reloading the project.</p>
<divclass="section"id="general">
<spanid="id1"></span><h3>General<aclass="headerlink"href="#general"title="Permalink to this headline">¶</a></h3>
<dd><pclass="first">If this is checked, a <codeclass="docutils literal notranslate"><spanclass="pre">scripts.pory</span></code> (and <codeclass="docutils literal notranslate"><spanclass="pre">text.pory</span></code>, if applicable) file will be created alongside new maps, instead of a <codeclass="docutils literal notranslate"><spanclass="pre">scripts.inc</span></code> file. Additionally, <codeclass="docutils literal notranslate"><spanclass="pre">.pory</span></code> files will be considered when searching for scripts labels and when opening scripts files (in addition to the regular <codeclass="docutils literal notranslate"><spanclass="pre">.inc</span></code> files).</p>
<pclass="last">Defaults to <codeclass="docutils literal notranslate"><spanclass="pre">unchecked</span></code>.</p>
</dd>
<dt>Show Wild Encounter Tables</dt>
<dd><pclass="first">If this is checked, the <codeclass="docutils literal notranslate"><spanclass="pre">Wild</span><spanclass="pre">Pokemon</span></code> tab will be enabled and wild encounter data will be read from the project’s encounters JSON file.</p>
<pclass="last">Defaults to <codeclass="docutils literal notranslate"><spanclass="pre">checked</span></code>. If no encounters JSON file is found this will be automatically unchecked.</p>
</dd>
<dt>Prefabs</dt>
<dd><pclass="first"><codeclass="docutils literal notranslate"><spanclass="pre">Prefabs</span><spanclass="pre">Path</span></code> is the file path to a <codeclass="docutils literal notranslate"><spanclass="pre">.json</span></code> file that contains definitions of prefabs. This will be used to populate the <codeclass="docutils literal notranslate"><spanclass="pre">Prefabs</span></code> panel on the <codeclass="docutils literal notranslate"><spanclass="pre">Map</span></code> tab. If no path is specified prefabs will be saved to a new <codeclass="docutils literal notranslate"><spanclass="pre">prefabs.json</span></code> file in the root project folder. A new file can be selected with the <aclass="reference internal"href="../_images/folder.png"><imgalt="button-folder"src="../_images/folder.png"style="width: 24px; height: 24px;"/></a> button or by editing the file path.</p>
<pclass="last">The <aclass="reference internal"href="../_images/import-defaults.png"><imgalt="button-import-defaults"src="../_images/import-defaults.png"style="height: 24px;"/></a> button will populate the specified file with version-specific prefabs constructed using the vanilla tilesets. This will overwrite any existing prefabs.</p>
</dd>
<dt>Collision Graphics</dt>
<dd><pclass="first"><codeclass="docutils literal notranslate"><spanclass="pre">Image</span><spanclass="pre">Path</span></code> is a path to any image file you’d like to use to represent collision and elevation values on the <codeclass="docutils literal notranslate"><spanclass="pre">Collision</span></code> tab. A new file can be selected with the <aclass="reference internal"href="../_images/folder.png"><imgalt="button-folder"src="../_images/folder.png"style="width: 24px; height: 24px;"/></a> button or by editing the file path. The image will be evenly divided into segments, with each row representing an elevation value (starting with <codeclass="docutils literal notranslate"><spanclass="pre">0</span></code> at the top) and each column representing a collision value (starting with <codeclass="docutils literal notranslate"><spanclass="pre">0</span></code> on the left).</p>
<p>Your image does not need to have a row/column for every valid elevation/collision value (for instance, the default collision values range from <codeclass="docutils literal notranslate"><spanclass="pre">0-3</span></code>, but because <codeclass="docutils literal notranslate"><spanclass="pre">2-3</span></code> are semantically the same as <codeclass="docutils literal notranslate"><spanclass="pre">1</span></code> they are not displayed). You can specify the highest elevation and collision value represented on your image with <codeclass="docutils literal notranslate"><spanclass="pre">Max</span><spanclass="pre">Elevation</span></code> and <codeclass="docutils literal notranslate"><spanclass="pre">Max</span><spanclass="pre">Collision</span></code>.</p>
<p>Note: Images with transparency may not function correctly when displayed on the map.</p>
<pclass="last">The filepath defaults empty, which will use <aclass="reference external"href="https://github.com/huderlem/porymap/blob/master/resources/images/collisions.png">Porymap’s original image</a>. <codeclass="docutils literal notranslate"><spanclass="pre">Max</span><spanclass="pre">Elevation</span></code> and <codeclass="docutils literal notranslate"><spanclass="pre">Max</span><spanclass="pre">Collision</span></code> default to <codeclass="docutils literal notranslate"><spanclass="pre">15</span></code> and <codeclass="docutils literal notranslate"><spanclass="pre">1</span></code> respectively.</p>
</dd>
<dt>Pokémon Icons</dt>
<dd><pclass="first">Porymap can display Pokémon species icons that it reads from your project on the <codeclass="docutils literal notranslate"><spanclass="pre">Wild</span><spanclass="pre">Pokemon</span></code> tab. If Porymap fails to load your icon image, or if you’d like to display your own icon in Porymap for any reason, you can select a new image with the <aclass="reference internal"href="../_images/folder.png"><imgalt="button-folder"src="../_images/folder.png"style="width: 24px; height: 24px;"/></a> button or by editing the file path. You can select a species with the dropdown to edit the path for a different icon.</p>
<p>If your custom icon or the default icon fails to load a <aclass="reference internal"href="../_images/pokemon-icon-placeholder.png"><imgalt="pokemon-icon-placeholder"src="../_images/pokemon-icon-placeholder.png"style="width: 24px; height: 24px;"/></a> icon will be displayed.</p>
<pclass="last">Defaults to empty (the path in your project where Porymap expects to find each icon).</p>
</dd>
<dt>Base Game Version</dt>
<dd><pclass="first">This is the name of the base pret repository for this project. Changing this setting will prompt you to restore the default project settings for any of the three versions. You can also do this for the currently-selected base game version by selecting <aclass="reference internal"href="../_images/restore-defaults.png"><imgalt="button-restore-defaults"src="../_images/restore-defaults.png"style="height: 24px;"/></a> at the bottom of the window. Aside from determining the default settings in this window, the base game version also determines the default settings when initializing the region map and when importing default prefabs.</p>
<pclass="last">Defaults to <codeclass="docutils literal notranslate"><spanclass="pre">pokeruby</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">pokefirered</span></code>, or <codeclass="docutils literal notranslate"><spanclass="pre">pokeemerald</span></code> depending on the project folder name. If the folder name doesn’t match you will be prompted to select a version on first launch.</p>
</dd>
</dl>
</div>
<divclass="section"id="maps">
<spanid="id2"></span><h3>Maps<aclass="headerlink"href="#maps"title="Permalink to this headline">¶</a></h3>
<divclass="figure">
<imgalt="Maps tab"src="../_images/tab-maps.png"/>
</div>
<dlclass="docutils">
<dt>Map Data Defaults</dt>
<dd><dlclass="first last docutils">
<dt>Border Metatiles</dt>
<dd><pclass="first">This is list of metatile ID values that will be used to fill the border on new maps. The spin boxes correspond to the top-left, top-right, bottom-left, and bottom-right border metatiles respectively.</p>
<p>If <codeclass="docutils literal notranslate"><spanclass="pre">Enable</span><spanclass="pre">Custom</span><spanclass="pre">Border</span><spanclass="pre">Size</span></code> is checked, this will instead be a comma-separated list of metatile ID values that will be used to fill the border on new maps. Values in the list will be read sequentially to fill the new border left-to-right top-to-bottom. If the number of metatiles in the border for a new map is not the same as the number of values in the list then the border will be filled with metatile ID <codeclass="docutils literal notranslate"><spanclass="pre">0x000</span></code> instead.</p>
<pclass="last">Defaults to <codeclass="docutils literal notranslate"><spanclass="pre">0x014</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">0x015</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">0x01C</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">0x01D</span></code> for <codeclass="docutils literal notranslate"><spanclass="pre">pokefirered</span></code>, and <codeclass="docutils literal notranslate"><spanclass="pre">0x1D4</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">0x1D5</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">0x1DC</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">0x1DD</span></code> for other versions.</p>
</dd>
<dt>Metatile ID</dt>
<dd><pclass="first">This is the metatile ID value that will be used to fill new maps.</p>
<pclass="last">Defaults to <codeclass="docutils literal notranslate"><spanclass="pre">0x1</span></code>.</p>
</dd>
<dt>Collision</dt>
<dd><pclass="first">This is the collision value that will be used to fill new maps. It will also be used to set the default selection on the Collision tab when the project is first opened.</p>
<pclass="last">Defaults to <codeclass="docutils literal notranslate"><spanclass="pre">0</span></code>.</p>
</dd>
<dt>Elevation</dt>
<dd><pclass="first">This is the elevation value that will be used to fill new maps. It will also be used to set the default selection on the Collision tab when the project is first opened.</p>
<pclass="last">Defaults to <codeclass="docutils literal notranslate"><spanclass="pre">3</span></code>.</p>
</dd>
<dt>Create separate text file</dt>
<dd><pclass="first">If this is checked, a <codeclass="docutils literal notranslate"><spanclass="pre">text.inc</span></code> (or <codeclass="docutils literal notranslate"><spanclass="pre">text.pory</span></code>) file will be created alongside new maps.</p>
<pclass="last">Defaults to <codeclass="docutils literal notranslate"><spanclass="pre">unchecked</span></code> for <codeclass="docutils literal notranslate"><spanclass="pre">pokeemerald</span></code> and <codeclass="docutils literal notranslate"><spanclass="pre">checked</span></code> for other versions.</p>
</dd>
</dl>
</dd>
<dt>Map Data Layout</dt>
<dd><pclass="first">Each of these three settings are bit masks that will be used to read and write an attribute of the data that makes up each map space (metatile ID, collision, and elevation). A warning will be displayed if any of the masks overlap. Their values may be read from <codeclass="docutils literal notranslate"><spanclass="pre">#define</span></code> s in your project, in which case editing will be disabled and you can change their values by modifying them in your project.</p>
<pclass="last">Default to being read from <codeclass="docutils literal notranslate"><spanclass="pre">MAPGRID_METATILE_ID_MASK</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">MAPGRID_COLLISION_MASK</span></code>, and <codeclass="docutils literal notranslate"><spanclass="pre">MAPGRID_ELEVATION_MASK</span></code>. If they can’t be read, they default to <codeclass="docutils literal notranslate"><spanclass="pre">0x3FF</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">0xC00</span></code>, and <codeclass="docutils literal notranslate"><spanclass="pre">0xF000</span></code> respectively.</p>
</dd>
<dt>Enable ‘Floor Number’</dt>
<dd><pclass="first">If this is checked, a <codeclass="docutils literal notranslate"><spanclass="pre">Floor</span><spanclass="pre">Number</span></code> option will become available on the <codeclass="docutils literal notranslate"><spanclass="pre">Header</span></code> tab and on the new map prompt. For more information see <aclass="reference external"href="https://huderlem.github.io/porymap/manual/editing-map-header.html">Editing Map Headers</a>.</p>
<pclass="last">Defaults to <codeclass="docutils literal notranslate"><spanclass="pre">checked</span></code> for <codeclass="docutils literal notranslate"><spanclass="pre">pokefirered</span></code> and <codeclass="docutils literal notranslate"><spanclass="pre">unchecked</span></code> for other versions.</p>
</dd>
<dt>Enable ‘Allow Running/Biking/Escaping’</dt>
<dd><pclass="first">If this is checked, <codeclass="docutils literal notranslate"><spanclass="pre">Allow</span><spanclass="pre">Running</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">Allow</span><spanclass="pre">Biking</span></code>, and <codeclass="docutils literal notranslate"><spanclass="pre">Allow</span><spanclass="pre">Dig</span><spanclass="pre">&</span><spanclass="pre">Escape</span><spanclass="pre">Rope</span></code> options will become available on the <codeclass="docutils literal notranslate"><spanclass="pre">Header</span></code> tab and on the new map prompt. For more information see <aclass="reference external"href="https://huderlem.github.io/porymap/manual/editing-map-header.html">Editing Map Headers</a>.</p>
<pclass="last">Defaults to <codeclass="docutils literal notranslate"><spanclass="pre">unchecked</span></code> for <codeclass="docutils literal notranslate"><spanclass="pre">pokeruby</span></code> and <codeclass="docutils literal notranslate"><spanclass="pre">checked</span></code> for other versions.</p>
</dd>
<dt>Enable Custom Border Size</dt>
<dd><pclass="first">If this is checked, <codeclass="docutils literal notranslate"><spanclass="pre">Border</span><spanclass="pre">Width</span></code> and <codeclass="docutils literal notranslate"><spanclass="pre">Border</span><spanclass="pre">Height</span></code> options will become available under the <codeclass="docutils literal notranslate"><spanclass="pre">Change</span><spanclass="pre">Dimensions</span></code> button and on the new map prompt. If it is unchecked all maps will use the default 2x2 dimensions.</p>
<pclass="last">Defaults to <codeclass="docutils literal notranslate"><spanclass="pre">checked</span></code> for <codeclass="docutils literal notranslate"><spanclass="pre">pokefirered</span></code> and <codeclass="docutils literal notranslate"><spanclass="pre">unchecked</span></code> for other versions.</p>
</dd>
</dl>
</div>
<divclass="section"id="tilesets">
<spanid="id4"></span><h3>Tilesets<aclass="headerlink"href="#tilesets"title="Permalink to this headline">¶</a></h3>
<dd><pclass="first">These will be the initially-selected tilesets when creating a new map, and will be used if a layout’s tileset fails to load. If a default tileset is not found then the first tileset in the respective list will be used instead.</p>
<p>The default primary tileset is <codeclass="docutils literal notranslate"><spanclass="pre">gTileset_General</span></code>.</p>
<pclass="last">The default secondary tileset is <codeclass="docutils literal notranslate"><spanclass="pre">gTileset_PalletTown</span></code> for <codeclass="docutils literal notranslate"><spanclass="pre">pokefirered</span></code>, and <codeclass="docutils literal notranslate"><spanclass="pre">gTileset_Petalburg</span></code> for other versions.</p>
</dd>
<dt>Enable Triple Layer Metatiles</dt>
<dd><pclass="first">Metatile data normally consists of 2 layers with 4 tiles each. If this is checked, they should instead consist of 3 layers with 4 tiles each. Additionally, the <codeclass="docutils literal notranslate"><spanclass="pre">Layer</span><spanclass="pre">Type</span></code> option in the <codeclass="docutils literal notranslate"><spanclass="pre">Tileset</span><spanclass="pre">Editor</span></code> will be removed. Note that layer type data will still be read and written according to your <codeclass="docutils literal notranslate"><spanclass="pre">Layer</span><spanclass="pre">Type</span><spanclass="pre">mask</span></code> setting.</p>
<p>For details on supporting this setting in your project, see <aclass="reference external"href="https://github.com/pret/pokeemerald/wiki/Triple-layer-metatiles">https://github.com/pret/pokeemerald/wiki/Triple-layer-metatiles</a>.</p>
<pclass="last">Defaults to <codeclass="docutils literal notranslate"><spanclass="pre">unchecked</span></code></p>
</dd>
<dt>Attributes size</dt>
<dd><pclass="first">The number of bytes used per metatile for metatile attributes. The data in each of your project’s <codeclass="docutils literal notranslate"><spanclass="pre">metatile_attributes.bin</span></code> files will be expected to be <codeclass="docutils literal notranslate"><spanclass="pre">s</span><spanclass="pre">*</span><spanclass="pre">n</span></code>, where <codeclass="docutils literal notranslate"><spanclass="pre">s</span></code> is this size and <codeclass="docutils literal notranslate"><spanclass="pre">n</span></code> is the number of metatiles in the tileset. Additionally, new <codeclass="docutils literal notranslate"><spanclass="pre">metatile_attributes.bin</span></code> will be included in the project with a corresponding <codeclass="docutils literal notranslate"><spanclass="pre">INCBIN_U8</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">INCBIN_U16</span></code>, or <codeclass="docutils literal notranslate"><spanclass="pre">INCBIN_U32</span></code> directive.</p>
<p>Changing this setting will automatically enforce the new limit on the metatile attribute mask settings.</p>
<pclass="last">Defaults to <codeclass="docutils literal notranslate"><spanclass="pre">4</span></code> for <codeclass="docutils literal notranslate"><spanclass="pre">pokefirered</span></code> and <codeclass="docutils literal notranslate"><spanclass="pre">2</span></code> for other versions.</p>
</dd>
<dt>Attribute masks</dt>
<dd><pclass="first">Each of these four settings are bit masks that will be used to read and write a specific metatile attribute from the metatile attributes data. If you are instead importing metatile attribute data from AdvanceMap, a default mask value will be used to read the data, and the mask value specified here will be used to write the new file.</p>
<p>If any of the mask values are set to <codeclass="docutils literal notranslate"><spanclass="pre">0x0</span></code>, the corresponding option in the Tileset Editor will be removed. The maximum for all the attribute masks is determined by the Attributes size setting. A warning will be displayed if any of the masks overlap.</p>
<ulclass="last">
<li><dlclass="first docutils">
<dt>Metatile Behavior mask</dt>
<dd><pclass="first">This is the mask value for the <codeclass="docutils literal notranslate"><spanclass="pre">Metatile</span><spanclass="pre">Behavior</span></code> metatile attribute.</p>
<pclass="last">Defaults to being read from <codeclass="docutils literal notranslate"><spanclass="pre">sMetatileAttrMasks</span></code> or <codeclass="docutils literal notranslate"><spanclass="pre">METATILE_ATTR_BEHAVIOR_MASK</span></code>. If these can’t be read, defaults to <codeclass="docutils literal notranslate"><spanclass="pre">0x1FF</span></code> for <codeclass="docutils literal notranslate"><spanclass="pre">pokefirered</span></code>, and <codeclass="docutils literal notranslate"><spanclass="pre">0xFF</span></code> for other versions.</p>
</dd>
</dl>
</li>
<li><dlclass="first docutils">
<dt>Layer Type mask</dt>
<dd><pclass="first">This is the mask value for the <codeclass="docutils literal notranslate"><spanclass="pre">Layer</span><spanclass="pre">Type</span></code> metatile attribute. If the value is set to <codeclass="docutils literal notranslate"><spanclass="pre">0x0</span></code> the <codeclass="docutils literal notranslate"><spanclass="pre">Layer</span><spanclass="pre">Type</span></code> option will be disabled in the Tileset Editor, and all metatiles will be treated in the editor as if they had the <codeclass="docutils literal notranslate"><spanclass="pre">Normal</span></code> layer type.</p>
<pclass="last">Defaults to being read from <codeclass="docutils literal notranslate"><spanclass="pre">sMetatileAttrMasks</span></code> or <codeclass="docutils literal notranslate"><spanclass="pre">METATILE_ATTR_LAYER_MASK</span></code>. If these can’t be read, defaults to <codeclass="docutils literal notranslate"><spanclass="pre">0x60000000</span></code> for <codeclass="docutils literal notranslate"><spanclass="pre">pokefirered</span></code>, and <codeclass="docutils literal notranslate"><spanclass="pre">0xF000</span></code> for other versions.</p>
</dd>
</dl>
</li>
<li><dlclass="first docutils">
<dt>Encounter Type mask</dt>
<dd><pclass="first">This is the mask value for the <codeclass="docutils literal notranslate"><spanclass="pre">Encounter</span><spanclass="pre">Type</span></code> metatile attribute.</p>
<pclass="last">Defaults to being read from <codeclass="docutils literal notranslate"><spanclass="pre">sMetatileAttrMasks</span></code>. If this can’t be read, defaults to <codeclass="docutils literal notranslate"><spanclass="pre">0x7000000</span></code> for <codeclass="docutils literal notranslate"><spanclass="pre">pokefirered</span></code>, and <codeclass="docutils literal notranslate"><spanclass="pre">0x0</span></code> for other versions.</p>
</dd>
</dl>
</li>
<li><dlclass="first docutils">
<dt>Terrain Type mask</dt>
<dd><pclass="first">This is the mask value for the <codeclass="docutils literal notranslate"><spanclass="pre">Terrain</span><spanclass="pre">Type</span></code> metatile attribute.</p>
<pclass="last">Defaults to being read from <codeclass="docutils literal notranslate"><spanclass="pre">sMetatileAttrMasks</span></code>. If this can’t be read, defaults to <codeclass="docutils literal notranslate"><spanclass="pre">0x3E00</span></code> for <codeclass="docutils literal notranslate"><spanclass="pre">pokefirered</span></code>, and <codeclass="docutils literal notranslate"><spanclass="pre">0x0</span></code> for other versions.</p>
</dd>
</dl>
</li>
</ul>
</dd>
<dt>Output ‘callback’ and ‘isCompressed’ fields</dt>
<dd><pclass="first">If these are checked, then <codeclass="docutils literal notranslate"><spanclass="pre">callback</span></code> and <codeclass="docutils literal notranslate"><spanclass="pre">isCompressed</span></code> fields will be output in the C data for new tilesets. Their default values will be <codeclass="docutils literal notranslate"><spanclass="pre">NULL</span></code> and <codeclass="docutils literal notranslate"><spanclass="pre">TRUE</span></code>, respectively.</p>
<pclass="last">Defaults to <codeclass="docutils literal notranslate"><spanclass="pre">checked</span></code> for both.</p>
</dd>
</dl>
</div>
<divclass="section"id="events">
<spanid="id5"></span><h3>Events<aclass="headerlink"href="#events"title="Permalink to this headline">¶</a></h3>
<dd><pclass="first">Each event group is represented by a unique icon on the <codeclass="docutils literal notranslate"><spanclass="pre">Events</span></code> tab of the main editor. Here you can provide filepaths to your own image files to replace these icons, either by selecting the <aclass="reference internal"href="../_images/folder.png"><imgalt="button-folder"src="../_images/folder.png"style="width: 24px; height: 24px;"/></a> button or by editing the file path directly.</p>
<p>Events in the <codeclass="docutils literal notranslate"><spanclass="pre">Objects</span></code> group will only use this icon if there are no graphics associated with their <codeclass="docutils literal notranslate"><spanclass="pre">Sprite</span></code> field.</p>
<pclass="last">The filepaths default to empty, which will use <aclass="reference external"href="https://github.com/huderlem/porymap/blob/master/resources/images/Entities_16x16.png">Porymap’s original icons</a>.</p>
</dd>
<dt>Warp Behaviors</dt>
<dd><pclass="first">By default, Warp Events only function as exits if they’re positioned on a metatile whose Metatile Behavior is treated specially in your project’s code. If any Warp Events are positioned on a metatile that doesn’t have one of these behaviors they will display a warning. Here you can disable that warning, or edit the list of behavior names that will silence the warning.</p>
<pclass="last">Defaults to <codeclass="docutils literal notranslate"><spanclass="pre">unchecked</span></code>, i.e. the warning is enabled. The list of behaviors is initially populated with all the vanilla warp behavior names across pokeemerald, pokefirered, and pokeruby.</p>
</dd>
<dt>Enable Clone Objects</dt>
<dd><pclass="first">If this is checked Clone Object Events will be available on the <codeclass="docutils literal notranslate"><spanclass="pre">Events</span></code> tab. For more information see <aclass="reference external"href="https://huderlem.github.io/porymap/manual/editing-map-events.html#clone-object-events">Clone Object Events</a>.</p>
<pclass="last">Defaults to <codeclass="docutils literal notranslate"><spanclass="pre">checked</span></code> for <codeclass="docutils literal notranslate"><spanclass="pre">pokefirered</span></code> and <codeclass="docutils literal notranslate"><spanclass="pre">unchecked</span></code> for other versions.</p>
</dd>
<dt>Enable Secret Bases</dt>
<dd><pclass="first">If this is checked Secret Base Events will be available on the <codeclass="docutils literal notranslate"><spanclass="pre">Events</span></code> tab. For more information see <aclass="reference external"href="https://huderlem.github.io/porymap/manual/editing-map-events.html#secret-base-event">Secret Base Events</a>.</p>
<pclass="last">Defaults to <codeclass="docutils literal notranslate"><spanclass="pre">unchecked</span></code> for <codeclass="docutils literal notranslate"><spanclass="pre">pokefirered</span></code> and <codeclass="docutils literal notranslate"><spanclass="pre">checked</span></code> for other versions.</p>
</dd>
<dt>Enable Weather Triggers</dt>
<dd><pclass="first">If this is checked Weather Trigger Events will be available on the <codeclass="docutils literal notranslate"><spanclass="pre">Events</span></code> tab. For more information see <aclass="reference external"href="https://huderlem.github.io/porymap/manual/editing-map-events.html#weather-trigger-events">Weather Trigger Events</a>.</p>
<pclass="last">Defaults to <codeclass="docutils literal notranslate"><spanclass="pre">unchecked</span></code> for <codeclass="docutils literal notranslate"><spanclass="pre">pokefirered</span></code> and <codeclass="docutils literal notranslate"><spanclass="pre">checked</span></code> for other versions.</p>
</dd>
<dt>Enable ‘Quantity’ for Hidden Items</dt>
<dd><pclass="first">If this is checked the <codeclass="docutils literal notranslate"><spanclass="pre">Quantity</span></code> property will be available for Hidden Item Events. For more information see <aclass="reference external"href="https://huderlem.github.io/porymap/manual/editing-map-events.html#hidden-item-event">Hidden Item Events</a>.</p>
<pclass="last">Defaults to <codeclass="docutils literal notranslate"><spanclass="pre">checked</span></code> for <codeclass="docutils literal notranslate"><spanclass="pre">pokefirered</span></code> and <codeclass="docutils literal notranslate"><spanclass="pre">unchecked</span></code> for other versions.</p>
</dd>
<dt>Enable ‘Requires Itemfinder’ for Hidden Items</dt>
<dd><pclass="first">If this is checked the <codeclass="docutils literal notranslate"><spanclass="pre">Requires</span><spanclass="pre">Itemfinder</span></code> property will be available for Hidden Item Events. For more information see <aclass="reference external"href="https://huderlem.github.io/porymap/manual/editing-map-events.html#hidden-item-event">Hidden Item Events</a>.</p>
<pclass="last">Defaults to <codeclass="docutils literal notranslate"><spanclass="pre">checked</span></code> for <codeclass="docutils literal notranslate"><spanclass="pre">pokefirered</span></code> and <codeclass="docutils literal notranslate"><spanclass="pre">unchecked</span></code> for other versions.</p>
</dd>
<dt>Enable ‘Repsawn Map/NPC’ for Heal Locations</dt>
<dd><pclass="first">If this is checked the <codeclass="docutils literal notranslate"><spanclass="pre">Respawn</span><spanclass="pre">Map</span></code> and <codeclass="docutils literal notranslate"><spanclass="pre">Respawn</span><spanclass="pre">NPC</span></code> properties will be available for Heal Location events. For more information see <aclass="reference external"href="https://huderlem.github.io/porymap/manual/editing-map-events.html#heal-location-healspots">Heal Locations</a>.</p>
<pclass="last">Defaults to <codeclass="docutils literal notranslate"><spanclass="pre">checked</span></code> for <codeclass="docutils literal notranslate"><spanclass="pre">pokefirered</span></code> and <codeclass="docutils literal notranslate"><spanclass="pre">unchecked</span></code> for other versions.</p>
</dd>
</dl>
</div>
<divclass="section"id="files-identifiers">
<spanid="id7"></span><h3>Files & Identifiers<aclass="headerlink"href="#files-identifiers"title="Permalink to this headline">¶</a></h3>
<p>These two tabs provide a way to override the filepaths and symbol/macro names Porymap expects to find in your project.</p>
<p>For <codeclass="docutils literal notranslate"><spanclass="pre">Files</span></code>, each can be overridden by typing a new path or selecting a file/folder with the <aclass="reference internal"href="../_images/folder.png"><imgalt="button-folder"src="../_images/folder.png"style="width: 24px; height: 24px;"/></a> button. Paths are expected to be relative to the root project folder. If no path is specified, or if the file/folder specified does not exist, then the default path will be used instead.</p>
<p>For <codeclass="docutils literal notranslate"><spanclass="pre">Identifiers</span></code>, each can be overridden by typing a new name in the line edit. Overrides with <codeclass="docutils literal notranslate"><spanclass="pre">regex</span></code> in the name support the <aclass="reference external"href="https://perldoc.perl.org/perlre">regular expression syntax</a> used by Qt.</p>
<p>For more information on what each of these overrides does, see <aclass="reference external"href="https://huderlem.github.io/porymap/manual/project-files.html">Project Files</a>.</p>
Built with <ahref="http://sphinx-doc.org/">Sphinx</a> using a <ahref="https://github.com/rtfd/sphinx_rtd_theme">theme</a> provided by <ahref="https://readthedocs.org">Read the Docs</a>.
