porymap/docs/manual/project-files.html
Marcus Huderle 0a940940e1 Update docs
2023-01-22 12:02:00 -06:00

762 lines
No EOL
42 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html>
<html class="writer-html5" lang="en" >
<head>
<meta charset="utf-8" />
<meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Project Files &mdash; porymap documentation</title>
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
<link rel="stylesheet" href="../_static/css/custom.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../_static/js/html5shiv.min.js"></script>
<![endif]-->
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js"></script>
<script src="../_static/doctools.js"></script>
<script src="../_static/sphinx_highlight.js"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
<link rel="index" title="Index" href="../genindex.html" />
<link rel="search" title="Search" href="../search.html" />
<link rel="next" title="Shortcuts" href="shortcuts.html" />
<link rel="prev" title="Scripting Capabilities" href="scripting-capabilities.html" />
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" style="background: linear-gradient(180deg, #08ACD5 50%, #FF6262 0%);" >
<a href="../index.html" class="icon icon-home"> porymap
</a>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
<input type="text" name="q" placeholder="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div>
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
<p class="caption" role="heading"><span class="caption-text">User Manual</span></p>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="introduction.html">Introduction</a><ul>
<li class="toctree-l2"><a class="reference internal" href="introduction.html#about-porymap">About Porymap</a></li>
<li class="toctree-l2"><a class="reference internal" href="introduction.html#getting-started">Getting Started</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="navigation.html">Navigation</a><ul>
<li class="toctree-l2"><a class="reference internal" href="navigation.html#map-list">Map List</a></li>
<li class="toctree-l2"><a class="reference internal" href="navigation.html#main-window">Main Window</a></li>
<li class="toctree-l2"><a class="reference internal" href="navigation.html#tileset-editor">Tileset Editor</a></li>
<li class="toctree-l2"><a class="reference internal" href="navigation.html#region-map-editor">Region Map Editor</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="editing-map-tiles.html">Editing Map Tiles</a><ul>
<li class="toctree-l2"><a class="reference internal" href="editing-map-tiles.html#visual-options">Visual Options</a></li>
<li class="toctree-l2"><a class="reference internal" href="editing-map-tiles.html#selecting-metatiles">Selecting Metatiles</a></li>
<li class="toctree-l2"><a class="reference internal" href="editing-map-tiles.html#pencil-tool">Pencil Tool</a></li>
<li class="toctree-l2"><a class="reference internal" href="editing-map-tiles.html#pointer-tool">Pointer Tool</a></li>
<li class="toctree-l2"><a class="reference internal" href="editing-map-tiles.html#bucket-fill-tool">Bucket Fill Tool</a></li>
<li class="toctree-l2"><a class="reference internal" href="editing-map-tiles.html#map-shift-tool">Map Shift Tool</a></li>
<li class="toctree-l2"><a class="reference internal" href="editing-map-tiles.html#smart-paths">Smart Paths</a></li>
<li class="toctree-l2"><a class="reference internal" href="editing-map-tiles.html#straight-paths">Straight Paths</a></li>
<li class="toctree-l2"><a class="reference internal" href="editing-map-tiles.html#change-map-border">Change Map Border</a></li>
<li class="toctree-l2"><a class="reference internal" href="editing-map-tiles.html#change-map-tilesets">Change Map Tilesets</a></li>
<li class="toctree-l2"><a class="reference internal" href="editing-map-tiles.html#undo-redo">Undo &amp; Redo</a></li>
<li class="toctree-l2"><a class="reference internal" href="editing-map-tiles.html#prefabs">Prefabs</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="editing-map-collisions.html">Editing Map Collisions</a><ul>
<li class="toctree-l2"><a class="reference internal" href="editing-map-collisions.html#selecting-collision-types">Selecting Collision Types</a></li>
<li class="toctree-l2"><a class="reference internal" href="editing-map-collisions.html#painting-collisions">Painting Collisions</a></li>
<li class="toctree-l2"><a class="reference internal" href="editing-map-collisions.html#collision-types">Collision Types</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="editing-map-events.html">Editing Map Events</a><ul>
<li class="toctree-l2"><a class="reference internal" href="editing-map-events.html#adding-deleting-events">Adding &amp; Deleting Events</a></li>
<li class="toctree-l2"><a class="reference internal" href="editing-map-events.html#event-positions">Event Positions</a></li>
<li class="toctree-l2"><a class="reference internal" href="editing-map-events.html#object-events">Object Events</a></li>
<li class="toctree-l2"><a class="reference internal" href="editing-map-events.html#clone-object-events">Clone Object Events</a></li>
<li class="toctree-l2"><a class="reference internal" href="editing-map-events.html#warp-events">Warp Events</a></li>
<li class="toctree-l2"><a class="reference internal" href="editing-map-events.html#trigger-events">Trigger Events</a></li>
<li class="toctree-l2"><a class="reference internal" href="editing-map-events.html#weather-trigger-events">Weather Trigger Events</a></li>
<li class="toctree-l2"><a class="reference internal" href="editing-map-events.html#sign-event">Sign Event</a></li>
<li class="toctree-l2"><a class="reference internal" href="editing-map-events.html#hidden-item-event">Hidden Item Event</a></li>
<li class="toctree-l2"><a class="reference internal" href="editing-map-events.html#secret-base-event">Secret Base Event</a></li>
<li class="toctree-l2"><a class="reference internal" href="editing-map-events.html#heal-location-healspots">Heal Location / Healspots</a></li>
<li class="toctree-l2"><a class="reference internal" href="editing-map-events.html#open-map-scripts">Open Map Scripts</a></li>
<li class="toctree-l2"><a class="reference internal" href="editing-map-events.html#tool-buttons">Tool Buttons</a></li>
<li class="toctree-l2"><a class="reference internal" href="editing-map-events.html#ruler-tool">Ruler Tool</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="editing-map-header.html">Editing Map Headers</a></li>
<li class="toctree-l1"><a class="reference internal" href="editing-map-connections.html">Editing Map Connections</a><ul>
<li class="toctree-l2"><a class="reference internal" href="editing-map-connections.html#dive-emerge-warps">Dive &amp; Emerge Warps</a></li>
<li class="toctree-l2"><a class="reference internal" href="editing-map-connections.html#mirror-connections">Mirror Connections</a></li>
<li class="toctree-l2"><a class="reference internal" href="editing-map-connections.html#follow-connections">Follow Connections</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="editing-wild-encounters.html">Editing Wild Encounters</a><ul>
<li class="toctree-l2"><a class="reference internal" href="editing-wild-encounters.html#adding-new-encounter-groups">Adding New Encounter Groups</a></li>
<li class="toctree-l2"><a class="reference internal" href="editing-wild-encounters.html#configuring-the-wild-encounter-fields">Configuring the Wild Encounter Fields</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="creating-new-maps.html">Creating New Maps</a><ul>
<li class="toctree-l2"><a class="reference internal" href="creating-new-maps.html#new-map-options">New Map Options</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="region-map-editor.html">The Region Map Editor</a><ul>
<li class="toctree-l2"><a class="reference internal" href="region-map-editor.html#background-image-tab">Background Image Tab</a></li>
<li class="toctree-l2"><a class="reference internal" href="region-map-editor.html#map-layout-tab">Map Layout Tab</a></li>
<li class="toctree-l2"><a class="reference internal" href="region-map-editor.html#map-entries-tab">Map Entries Tab</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="tileset-editor.html">The Tileset Editor</a><ul>
<li class="toctree-l2"><a class="reference internal" href="tileset-editor.html#metatile-properties">Metatile Properties</a><ul>
<li class="toctree-l3"><a class="reference internal" href="tileset-editor.html#layer-type">Layer Type</a></li>
<li class="toctree-l3"><a class="reference internal" href="tileset-editor.html#metatile-behavior">Metatile Behavior</a></li>
<li class="toctree-l3"><a class="reference internal" href="tileset-editor.html#encounter-type">Encounter Type</a></li>
<li class="toctree-l3"><a class="reference internal" href="tileset-editor.html#terrain-type">Terrain Type</a></li>
<li class="toctree-l3"><a class="reference internal" href="tileset-editor.html#metatile-label">Metatile Label</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="tileset-editor.html#tools-menu">Tools Menu</a><ul>
<li class="toctree-l3"><a class="reference internal" href="tileset-editor.html#import-tiles-image">Import Tiles Image…</a></li>
<li class="toctree-l3"><a class="reference internal" href="tileset-editor.html#import-metatiles-from-advance-map-1-92">Import Metatiles from Advance Map 1.92…</a></li>
<li class="toctree-l3"><a class="reference internal" href="tileset-editor.html#change-number-of-metatiles">Change Number of Metatiles</a></li>
<li class="toctree-l3"><a class="reference internal" href="tileset-editor.html#other-tools">Other Tools</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="tileset-editor.html#palette-editor">Palette Editor</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="scripting-capabilities.html">Scripting Capabilities</a><ul>
<li class="toctree-l2"><a class="reference internal" href="scripting-capabilities.html#writing-a-custom-script">Writing a Custom Script</a></li>
<li class="toctree-l2"><a class="reference internal" href="scripting-capabilities.html#registering-script-actions">Registering Script Actions</a></li>
<li class="toctree-l2"><a class="reference internal" href="scripting-capabilities.html#scripting-api">Scripting API</a><ul>
<li class="toctree-l3"><a class="reference internal" href="scripting-capabilities.html#callbacks">Callbacks</a><ul>
<li class="toctree-l4"><a class="reference internal" href="scripting-capabilities.html#onProjectOpened"><code class="docutils literal notranslate"><span class="pre">onProjectOpened()</span></code></a></li>
<li class="toctree-l4"><a class="reference internal" href="scripting-capabilities.html#onProjectClosed"><code class="docutils literal notranslate"><span class="pre">onProjectClosed()</span></code></a></li>
<li class="toctree-l4"><a class="reference internal" href="scripting-capabilities.html#onMapOpened"><code class="docutils literal notranslate"><span class="pre">onMapOpened()</span></code></a></li>
<li class="toctree-l4"><a class="reference internal" href="scripting-capabilities.html#onBlockChanged"><code class="docutils literal notranslate"><span class="pre">onBlockChanged()</span></code></a></li>
<li class="toctree-l4"><a class="reference internal" href="scripting-capabilities.html#onBorderMetatileChanged"><code class="docutils literal notranslate"><span class="pre">onBorderMetatileChanged()</span></code></a></li>
<li class="toctree-l4"><a class="reference internal" href="scripting-capabilities.html#onBlockHoverChanged"><code class="docutils literal notranslate"><span class="pre">onBlockHoverChanged()</span></code></a></li>
<li class="toctree-l4"><a class="reference internal" href="scripting-capabilities.html#onBlockHoverCleared"><code class="docutils literal notranslate"><span class="pre">onBlockHoverCleared()</span></code></a></li>
<li class="toctree-l4"><a class="reference internal" href="scripting-capabilities.html#onMapResized"><code class="docutils literal notranslate"><span class="pre">onMapResized()</span></code></a></li>
<li class="toctree-l4"><a class="reference internal" href="scripting-capabilities.html#onBorderResized"><code class="docutils literal notranslate"><span class="pre">onBorderResized()</span></code></a></li>
<li class="toctree-l4"><a class="reference internal" href="scripting-capabilities.html#onMapShifted"><code class="docutils literal notranslate"><span class="pre">onMapShifted()</span></code></a></li>
<li class="toctree-l4"><a class="reference internal" href="scripting-capabilities.html#onTilesetUpdated"><code class="docutils literal notranslate"><span class="pre">onTilesetUpdated()</span></code></a></li>
<li class="toctree-l4"><a class="reference internal" href="scripting-capabilities.html#onMainTabChanged"><code class="docutils literal notranslate"><span class="pre">onMainTabChanged()</span></code></a></li>
<li class="toctree-l4"><a class="reference internal" href="scripting-capabilities.html#onMapViewTabChanged"><code class="docutils literal notranslate"><span class="pre">onMapViewTabChanged()</span></code></a></li>
<li class="toctree-l4"><a class="reference internal" href="scripting-capabilities.html#onBorderVisibilityToggled"><code class="docutils literal notranslate"><span class="pre">onBorderVisibilityToggled()</span></code></a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="scripting-capabilities.html#functions">Functions</a><ul>
<li class="toctree-l4"><a class="reference internal" href="scripting-capabilities.html#map-editing-functions">Map Editing Functions</a></li>
<li class="toctree-l4"><a class="reference internal" href="scripting-capabilities.html#map-header-editing-functions">Map Header Editing Functions</a></li>
<li class="toctree-l4"><a class="reference internal" href="scripting-capabilities.html#tileset-functions">Tileset Functions</a></li>
<li class="toctree-l4"><a class="reference internal" href="scripting-capabilities.html#overlay-functions">Overlay Functions</a></li>
<li class="toctree-l4"><a class="reference internal" href="scripting-capabilities.html#settings-functions">Settings Functions</a></li>
<li class="toctree-l4"><a class="reference internal" href="scripting-capabilities.html#utility-functions">Utility Functions</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="scripting-capabilities.html#constants">Constants</a><ul>
<li class="toctree-l4"><a class="reference internal" href="scripting-capabilities.html#constants.max_primary_tiles"><code class="docutils literal notranslate"><span class="pre">constants.max_primary_tiles</span></code></a></li>
<li class="toctree-l4"><a class="reference internal" href="scripting-capabilities.html#constants.max_secondary_tiles"><code class="docutils literal notranslate"><span class="pre">constants.max_secondary_tiles</span></code></a></li>
<li class="toctree-l4"><a class="reference internal" href="scripting-capabilities.html#constants.max_primary_metatiles"><code class="docutils literal notranslate"><span class="pre">constants.max_primary_metatiles</span></code></a></li>
<li class="toctree-l4"><a class="reference internal" href="scripting-capabilities.html#constants.max_secondary_metatiles"><code class="docutils literal notranslate"><span class="pre">constants.max_secondary_metatiles</span></code></a></li>
<li class="toctree-l4"><a class="reference internal" href="scripting-capabilities.html#constants.layers_per_metatile"><code class="docutils literal notranslate"><span class="pre">constants.layers_per_metatile</span></code></a></li>
<li class="toctree-l4"><a class="reference internal" href="scripting-capabilities.html#constants.tiles_per_metatile"><code class="docutils literal notranslate"><span class="pre">constants.tiles_per_metatile</span></code></a></li>
<li class="toctree-l4"><a class="reference internal" href="scripting-capabilities.html#constants.base_game_version"><code class="docutils literal notranslate"><span class="pre">constants.base_game_version</span></code></a></li>
<li class="toctree-l4"><a class="reference internal" href="scripting-capabilities.html#constants.version.major"><code class="docutils literal notranslate"><span class="pre">constants.version.major</span></code></a></li>
<li class="toctree-l4"><a class="reference internal" href="scripting-capabilities.html#constants.version.minor"><code class="docutils literal notranslate"><span class="pre">constants.version.minor</span></code></a></li>
<li class="toctree-l4"><a class="reference internal" href="scripting-capabilities.html#constants.version.patch"><code class="docutils literal notranslate"><span class="pre">constants.version.patch</span></code></a></li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">Project Files</a></li>
<li class="toctree-l1"><a class="reference internal" href="shortcuts.html">Shortcuts</a><ul>
<li class="toctree-l2"><a class="reference internal" href="shortcuts.html#main-window">Main Window</a></li>
<li class="toctree-l2"><a class="reference internal" href="shortcuts.html#tileset-editor">Tileset Editor</a></li>
<li class="toctree-l2"><a class="reference internal" href="shortcuts.html#region-map-editor">Region Map Editor</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="settings-and-options.html">Porymap Settings</a></li>
</ul>
<p class="caption" role="heading"><span class="caption-text">Reference</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../reference/changelog.html">Changelog</a><ul>
<li class="toctree-l2"><a class="reference internal" href="../reference/changelog.html#unreleased">Unreleased</a></li>
<li class="toctree-l2"><a class="reference internal" href="../reference/changelog.html#id1">5.1.0 - 2023-01-22</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#added">Added</a></li>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#changed">Changed</a></li>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#fixed">Fixed</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../reference/changelog.html#id2">5.0.0 - 2022-10-30</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#breaking-changes">Breaking Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id3">Added</a></li>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id4">Changed</a></li>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id5">Fixed</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../reference/changelog.html#id6">4.5.0 - 2021-12-26</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id7">Added</a></li>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id8">Changed</a></li>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id9">Fixed</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../reference/changelog.html#id10">4.4.0 - 2020-12-20</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id11">Added</a></li>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id12">Changed</a></li>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id13">Fixed</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../reference/changelog.html#id14">4.3.1 - 2020-07-17</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id15">Added</a></li>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id16">Changed</a></li>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id17">Fixed</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../reference/changelog.html#id18">4.3.0 - 2020-06-27</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id19">Added</a></li>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id20">Changed</a></li>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id21">Fixed</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../reference/changelog.html#id22">4.2.0 - 2020-06-06</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id23">Added</a></li>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id24">Changed</a></li>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id25">Fixed</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../reference/changelog.html#id26">4.1.0 - 2020-05-18</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id27">Added</a></li>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id28">Changed</a></li>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id29">Fixed</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../reference/changelog.html#id30">4.0.0 - 2020-04-28</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id31">Breaking Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id32">Added</a></li>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id33">Changed</a></li>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id34">Fixed</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../reference/changelog.html#id35">3.0.1 - 2020-03-04</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id36">Fixed</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../reference/changelog.html#id37">3.0.0 - 2020-03-04</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id38">Breaking Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id39">Added</a></li>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id40">Changed</a></li>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id41">Fixed</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../reference/changelog.html#id42">2.0.0 - 2019-10-16</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id43">Breaking Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id44">Added</a></li>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id45">Changed</a></li>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id46">Fixed</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../reference/changelog.html#id47">1.2.2 - 2019-05-16</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id48">Added</a></li>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id49">Changed</a></li>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id50">Fixed</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../reference/changelog.html#id51">1.2.1 - 2019-02-16</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id52">Added</a></li>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id53">Fixed</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../reference/changelog.html#id54">1.2.0 - 2019-02-04</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id55">Breaking Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id56">Added</a></li>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id57">Changed</a></li>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id58">Fixed</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../reference/changelog.html#id59">1.1.0 - 2018-12-27</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id60">Breaking Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id61">Added</a></li>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id62">Changed</a></li>
<li class="toctree-l3"><a class="reference internal" href="../reference/changelog.html#id63">Fixed</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../reference/changelog.html#id64">1.0.0 - 2018-10-26</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../reference/related-projects.html">Related Projects</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
<nav class="wy-nav-top" aria-label="top navigation">
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="../index.html">porymap</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
<li><a href="../index.html" class="icon icon-home"></a> &raquo;</li>
<li>Project Files</li>
<li class="wy-breadcrumbs-aside">
<a href="https://github.com/huderlem/porymap/blob/master/docsrc/manual/project-files.rst" class="fa fa-github"> Edit on GitHub</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<section id="project-files">
<h1>Project Files<a class="headerlink" href="#project-files" title="Permalink to this heading"></a></h1>
<p>Porymap relies on the user maintaining a certain level of integrity with their project files.
This is a list of files that porymap reads from and writes to. Generally, if porymap writes
to a file, it probably is not a good idea to edit yourself unless otherwise noted.</p>
<p>The filepath that Porymap expects for each file can be overridden with config options. The name of each config override is listed in the table, and should begin with <code class="docutils literal notranslate"><span class="pre">path/</span></code>.
For example if you wanted to rename <code class="docutils literal notranslate"><span class="pre">include/constants/items.h</span></code> to <code class="docutils literal notranslate"><span class="pre">headers/defines/stuff.h</span></code>, you would add <code class="docutils literal notranslate"><span class="pre">path/constants_items=headers/defines/stuff.h</span></code> to your projects <code class="docutils literal notranslate"><span class="pre">porymap.project.cfg</span></code> file.</p>
<table class="docutils align-default">
<colgroup>
<col style="width: 25.0%" />
<col style="width: 6.2%" />
<col style="width: 6.2%" />
<col style="width: 25.0%" />
<col style="width: 37.5%" />
</colgroup>
<thead>
<tr class="row-odd"><th class="head"><p>File Name</p></th>
<th class="head"><p>Read</p></th>
<th class="head"><p>Write</p></th>
<th class="head"><p>Override</p></th>
<th class="head"><p>Notes</p></th>
</tr>
</thead>
<tbody>
<tr class="row-even"><td><p>data/maps/*/map.json</p></td>
<td><p>yes</p></td>
<td><p>yes</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">data_map_folders</span></code></p></td>
<td></td>
</tr>
<tr class="row-odd"><td><p>data/maps/*/scripts.[inc|pory]</p></td>
<td><p>yes</p></td>
<td><p>no</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">data_map_folders</span></code></p></td>
<td><p>for finding script labels</p></td>
</tr>
<tr class="row-even"><td><p>data/scripts/*.[inc|pory]</p></td>
<td><p>yes</p></td>
<td><p>no</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">data_scripts_folders</span></code></p></td>
<td><p>for finding script labels</p></td>
</tr>
<tr class="row-odd"><td><p>data/event_scripts.s</p></td>
<td><p>no</p></td>
<td><p>yes</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">data_event_scripts</span></code></p></td>
<td><p>only appends new script files to end of file</p></td>
</tr>
<tr class="row-even"><td><p>data/maps/map_groups.json</p></td>
<td><p>yes</p></td>
<td><p>yes</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">json_map_groups</span></code></p></td>
<td></td>
</tr>
<tr class="row-odd"><td><p>data/layouts/layouts.json</p></td>
<td><p>yes</p></td>
<td><p>yes</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">json_layouts</span></code></p></td>
<td></td>
</tr>
<tr class="row-even"><td><p>data/layouts/*/[border|map].bin</p></td>
<td><p>yes</p></td>
<td><p>yes</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">data_layouts_folders</span></code></p></td>
<td></td>
</tr>
<tr class="row-odd"><td><p>src/data/tilesets/headers.h</p></td>
<td><p>yes</p></td>
<td><p>yes</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">tilesets_headers</span></code></p></td>
<td></td>
</tr>
<tr class="row-even"><td><p>src/data/tilesets/graphics.h</p></td>
<td><p>yes</p></td>
<td><p>yes</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">tilesets_graphics</span></code></p></td>
<td><p>also edits palette and tile image files listed in this file</p></td>
</tr>
<tr class="row-odd"><td><p>src/data/tilesets/metatiles.h</p></td>
<td><p>yes</p></td>
<td><p>yes</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">tilesets_metatiles</span></code></p></td>
<td><p>also edits metatile files listed in this file</p></td>
</tr>
<tr class="row-even"><td><p>data/tilesets/headers.inc</p></td>
<td><p>yes</p></td>
<td><p>yes</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">tilesets_headers_asm</span></code></p></td>
<td><p>only if <code class="docutils literal notranslate"><span class="pre">tilesets_headers</span></code> cant be found</p></td>
</tr>
<tr class="row-odd"><td><p>data/tilesets/graphics.inc</p></td>
<td><p>yes</p></td>
<td><p>yes</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">tilesets_graphics_asm</span></code></p></td>
<td><p>only if <code class="docutils literal notranslate"><span class="pre">tilesets_headers</span></code> cant be found</p></td>
</tr>
<tr class="row-even"><td><p>data/tilesets/metatiles.inc</p></td>
<td><p>yes</p></td>
<td><p>yes</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">tilesets_metatiles_asm</span></code></p></td>
<td><p>only if <code class="docutils literal notranslate"><span class="pre">tilesets_headers</span></code> cant be found</p></td>
</tr>
<tr class="row-odd"><td><p>data/tilesets/[primary|secondary]/*</p></td>
<td><p>yes</p></td>
<td><p>yes</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">data_tilesets_folders</span></code></p></td>
<td><p>default tileset data location</p></td>
</tr>
<tr class="row-even"><td><p>src/data/wild_encounters.json</p></td>
<td><p>yes</p></td>
<td><p>yes</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">json_wild_encounters</span></code></p></td>
<td></td>
</tr>
<tr class="row-odd"><td><p>src/data/object_events/object_event_graphics_info_pointers.h</p></td>
<td><p>yes</p></td>
<td><p>no</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">data_obj_event_gfx_pointers</span></code></p></td>
<td></td>
</tr>
<tr class="row-even"><td><p>src/data/object_events/object_event_graphics_info.h</p></td>
<td><p>yes</p></td>
<td><p>no</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">data_obj_event_gfx_info</span></code></p></td>
<td></td>
</tr>
<tr class="row-odd"><td><p>src/data/object_events/object_event_pic_tables.h</p></td>
<td><p>yes</p></td>
<td><p>no</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">data_obj_event_pic_tables</span></code></p></td>
<td></td>
</tr>
<tr class="row-even"><td><p>src/data/object_events/object_event_graphics.h</p></td>
<td><p>yes</p></td>
<td><p>no</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">data_obj_event_gfx</span></code></p></td>
<td></td>
</tr>
<tr class="row-odd"><td><p>src/data/graphics/pokemon.h</p></td>
<td><p>yes</p></td>
<td><p>no</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">data_pokemon_gfx</span></code></p></td>
<td><p>for pokemon sprite icons</p></td>
</tr>
<tr class="row-even"><td><p>src/data/heal_locations.h</p></td>
<td><p>yes</p></td>
<td><p>yes</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">data_heal_locations</span></code></p></td>
<td></td>
</tr>
<tr class="row-odd"><td><p>src/data/region_map/region_map_sections.json</p></td>
<td><p>yes</p></td>
<td><p>yes</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">json_region_map_entries</span></code></p></td>
<td></td>
</tr>
<tr class="row-even"><td><p>src/data/region_map/porymap_config.json</p></td>
<td><p>yes</p></td>
<td><p>yes</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">json_region_porymap_cfg</span></code></p></td>
<td></td>
</tr>
<tr class="row-odd"><td><p>include/constants/global.h</p></td>
<td><p>yes</p></td>
<td><p>no</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">constants_global</span></code></p></td>
<td><p>reads <code class="docutils literal notranslate"><span class="pre">OBJECT_EVENT_TEMPLATES_COUNT</span></code></p></td>
</tr>
<tr class="row-even"><td><p>include/constants/map_groups.h</p></td>
<td><p>no</p></td>
<td><p>yes</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">constants_map_groups</span></code></p></td>
<td></td>
</tr>
<tr class="row-odd"><td><p>include/constants/items.h</p></td>
<td><p>yes</p></td>
<td><p>no</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">constants_items</span></code></p></td>
<td></td>
</tr>
<tr class="row-even"><td><p>include/constants/opponents.h</p></td>
<td><p>yes</p></td>
<td><p>no</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">constants_opponents</span></code></p></td>
<td><p>reads max trainers constant</p></td>
</tr>
<tr class="row-odd"><td><p>include/constants/flags.h</p></td>
<td><p>yes</p></td>
<td><p>no</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">constants_flags</span></code></p></td>
<td></td>
</tr>
<tr class="row-even"><td><p>include/constants/vars.h</p></td>
<td><p>yes</p></td>
<td><p>no</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">constants_vars</span></code></p></td>
<td></td>
</tr>
<tr class="row-odd"><td><p>include/constants/weather.h</p></td>
<td><p>yes</p></td>
<td><p>no</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">constants_weather</span></code></p></td>
<td></td>
</tr>
<tr class="row-even"><td><p>include/constants/songs.h</p></td>
<td><p>yes</p></td>
<td><p>no</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">constants_songs</span></code></p></td>
<td></td>
</tr>
<tr class="row-odd"><td><p>include/constants/heal_locations.h</p></td>
<td><p>yes</p></td>
<td><p>yes</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">constants_heal_locations</span></code></p></td>
<td></td>
</tr>
<tr class="row-even"><td><p>include/constants/pokemon.h</p></td>
<td><p>yes</p></td>
<td><p>no</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">constants_pokemon</span></code></p></td>
<td><p>reads min and max level constants</p></td>
</tr>
<tr class="row-odd"><td><p>include/constants/map_types.h</p></td>
<td><p>yes</p></td>
<td><p>no</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">constants_map_types</span></code></p></td>
<td></td>
</tr>
<tr class="row-even"><td><p>include/constants/trainer_types.h</p></td>
<td><p>yes</p></td>
<td><p>no</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">constants_trainer_types</span></code></p></td>
<td></td>
</tr>
<tr class="row-odd"><td><p>include/constants/secret_bases.h</p></td>
<td><p>yes</p></td>
<td><p>no</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">constants_secret_bases</span></code></p></td>
<td><p>pokeemerald and pokeruby only</p></td>
</tr>
<tr class="row-even"><td><p>include/constants/event_object_movement.h</p></td>
<td><p>yes</p></td>
<td><p>no</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">constants_obj_event_movement</span></code></p></td>
<td></td>
</tr>
<tr class="row-odd"><td><p>include/constants/event_objects.h</p></td>
<td><p>yes</p></td>
<td><p>no</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">constants_obj_events</span></code></p></td>
<td></td>
</tr>
<tr class="row-even"><td><p>include/constants/event_bg.h</p></td>
<td><p>yes</p></td>
<td><p>no</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">constants_event_bg</span></code></p></td>
<td></td>
</tr>
<tr class="row-odd"><td><p>include/constants/region_map_sections.h</p></td>
<td><p>yes</p></td>
<td><p>no</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">constants_region_map_sections</span></code></p></td>
<td></td>
</tr>
<tr class="row-even"><td><p>include/constants/metatile_labels.h</p></td>
<td><p>yes</p></td>
<td><p>yes</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">constants_metatile_labels</span></code></p></td>
<td></td>
</tr>
<tr class="row-odd"><td><p>include/constants/metatile_behaviors.h</p></td>
<td><p>yes</p></td>
<td><p>no</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">constants_metatile_behaviors</span></code></p></td>
<td></td>
</tr>
<tr class="row-even"><td><p>include/fieldmap.h</p></td>
<td><p>yes</p></td>
<td><p>no</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">constants_fieldmap</span></code></p></td>
<td><p>reads tileset related constants</p></td>
</tr>
<tr class="row-odd"><td><p>src/event_object_movement.c</p></td>
<td><p>yes</p></td>
<td><p>no</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">initial_facing_table</span></code></p></td>
<td><p>reads <code class="docutils literal notranslate"><span class="pre">gInitialMovementTypeFacingDirections</span></code></p></td>
</tr>
<tr class="row-even"><td><p>src/pokemon_icon.c</p></td>
<td><p>yes</p></td>
<td><p>no</p></td>
<td><p><code class="docutils literal notranslate"><span class="pre">pokemon_icon_table</span></code></p></td>
<td><p>reads files in <code class="docutils literal notranslate"><span class="pre">gMonIconTable</span></code></p></td>
</tr>
</tbody>
</table>
</section>
</div>
</div>
<footer>
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
<a href="shortcuts.html" class="btn btn-neutral float-right" title="Shortcuts" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
<a href="scripting-capabilities.html" class="btn btn-neutral float-left" title="Scripting Capabilities" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
</div>
<hr/>
<div role="contentinfo">
<p>
&#169; Copyright 2023, huderlem.
</p>
</div>
Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
<a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script type="text/javascript">
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>