3,365 apps tracked 0 new today 17 updated today Synced 2m ago

Porymap

A map editor for the Pokémon generation 3 decompilation projects

huderlem

io.github.huderlem.porymap
View on Flathub ↗

Porymap is a cross-platform map editor for the Gen 3 pret decompilation projects. Its primary functions are to allow editing map tiles, collision, events, connections, and properties. Porymap provides additional functionality, such as tileset editing and region map editing.

Those familiar with traditional Gen 3 binary ROM hacking can think of it as the Advance Map equivalent for the decompilation projects. Porymap supports the same features as Advance Map, so Advance Map users shouldn’t have much difficulty learning how to use Porymap. There are many usability improvements in Porymap. The most notable is undo/redo when painting map tiles.

Porymap reads and writes files in the decompilation projects. It does not read or write ROM files. Therefore, it is highly recommended to use Git for version control when working with Porymap.

Screenshots

The main window of Porymap
The main window of Porymap

Observed history

App ChangeVersionWhen ↓

No observed changes yet.

The initial import establishes a baseline. Future version changes will appear here.

Browse the app catalogue →

Upstream releases

Release notes supplied by the developer. These dates are not Flathub package publication times.

6.3.112 Apr 2026

Added

  • Add support for INCGFX.
  • The regular expression for parsing INCBIN / INCGFX is now available under Project Settings.

Fixed

  • Fix degraded image quality in exported timelapse gifs.
  • Fix custom top-level data in the encounters object of wild_encounters.json being discarded if no fields data is present.
  • Fix event sprites sometimes rendering with incorrect transparency temporarily after a sprite change.
  • Fix event sprite names that appear in symbol_obj_event_gfx_pointers by value and not by name not rendering with the correct sprite.
6.3.026 Dec 2025

Added

  • Add option to sort Locations and Layouts lists by value, rather than alphabetically.
  • Add color space settings for exported images.
  • Add setting to disable the project loading screen.

Changed

  • Separate File > Duplicate Current Map/Layout into two options to allow duplicating the current layout when a map is open.
  • The name field now receives focus immediately for the new map/layout dialogs.
  • The middle mouse button can now be used to pan around the map views, rather than needing to select the Map Tool. This is a very convenient shortcut that matches popular image-editing programs.

Fixed

  • Fix crash when a painted tile selection goes out of bounds of the metatile layer view in the Tileset Editor.
  • Fix crash on older versions of Qt when reopening a project with certain windows open.
  • Fix potential crash when painting and the cursor leaves the map area.
  • Fix potential crash when changing maps with the Tileset Editor open.
  • Fix rare crash while quitting Porymap.
  • Fix Edit > Clear Map Entries in the Region Map Editor not saving the applied changes.
  • Fix Edit > Undo/Redo appearing enabled even when they don't do anything.
  • Fix Help > Open Manual being disabled when no project is open.
  • Fix new tilesets potentially overwriting data in an existing directory.
  • Fix exported images on macOS using a different color space than in Porymap.
  • Fix some INCBIN statements not being parsed correctly.
  • Fix excessive logging if Porymap fails to monitor all map files.
  • Fix map connections getting cut off in exported map images if they're on the same side as another short map connection.
  • Fix the project version check failing for some versions of git.
  • Fix some error highlights persisting after the error is resolved.
  • Fix the Layout/Tileset labels on the Metatiles panel disappearing if the panel is too narrow.
6.2.08 Aug 2025

Added

  • Add View > Show Unused Colors to the Palette Editor.
  • Add Tools > Find Color Usage to the Palette Editor. This opens a dialog showing which metatiles use a particular color.
  • Add Edit > Swap Metatiles to the Tileset Editor. While in this mode, selecting two metatiles in the selector will swap their positions. When changes to the tilesets are saved these relocations will be applied to all layouts that use the relevant tileset(s).
  • Add View > Layer Arrangement to the Tileset Editor, which changes whether the metatile layer view is oriented vertically (default) or horizontally.
  • Add an Export Metatiles Image option to the Tileset Editor that provides many more options for customizing metatile images.
  • Add an Export Porytiles Layer Images option to the Tileset Editor, which is a shortcut for individually exporting layer images that Porytiles can use.
  • Add an option under Preferences to include common scripts in the autocomplete for Script labels.
  • Add a setting under Project Settings to change the width of the metatile selectors.
  • Add versions of the API functions [get|set]MetatileLayerOrder and [get|set]MetatileLayerOpacity that work globally, rather than on individual layouts.
  • A link to Porymap's manual is now available under Help.

Changed

  • The Player View Rectangle is now visible on the Events tab, as is the Cursor Tile Outline for certain tools.
  • When hovering over tiles in the Tileset Editor their palette and x/yflip are now listed alongside the tile ID.
  • The scroll position of the map view now remains the same between the Connections tab and the Map/Events tabs.
  • The Move tool now behaves more like a traditional pan tool (with no momentum).
  • The map image exporter now uses a checkered background to indicate transparency.
  • Invalid tile IDs are now rendered as magenta (like invalid metatiles), instead of rendering the same as a transparent tile.
  • While holding down Ctrl (Cmd on macOS) painting on the metatile layer view will now only change the tile's palette.
  • Full menu paths are now listed for shortcuts in the Shortcuts Editor.
  • Adding new event data to a map that has a shared_events_map will now remove the shared_events_map, rather than discard the event data.

Fixed

  • Fix crash when rendering tiles with invalid palette numbers.
  • Fix crash when opening the Tileset Editor for tilesets with no metatiles.
  • Fix crash when changing the map/border size in certain API callbacks.
  • Fix metatile images exporting at 2x scale.
  • Fix display errors when a project's metatile limits are not divisible by 8.
  • Fix incorrect dividing line position for primary tiles images that are smaller than the maximum size.
  • Fix the checkered background of the Change Dimensions popup shifting while scrolling around.
  • Fix pasting Wild Pokémon data then changing maps resetting the pasted data.
  • Fix click-drag map selections behaving unexpectedly when the cursor is outside the map grid.
  • Fix events being dragged in negative coordinates lagging behind the cursor.
  • Fix the shortcut for duplicating events working while on the Connections tab.
  • Fix the Shortcuts Editor displaying the duplicate shortcut prompt repeatedly.
  • Fix the clear text button on the left in each row of the Shortcuts Editor also clearing the shortcut on the right.
  • Fix Undo/Redo ignoring the automatic resizing that occurs if a layout/border was an unexpected size.
  • Fix Undo/Redo in the Tileset and Palette Editors and Paste in the Tileset Editor appearing enabled even when they don't do anything.
  • Fix Ctrl+Shift+Z not being set as a default shortcut for Redo in the Palette Editor like it is for other windows.
  • Fix the Tileset Editor's status bar not updating while selecting tiles in the metatile layer view, or when pasting metatiles.
  • Fix the main window's status bar not immediately reflecting changes made while painting metatiles / movement permissions.
  • Fix cleared metatile labels not updating until the project is reloaded.
  • Fix some changes in the Tileset Editor being discarded if the window is closed too quickly.
  • Fix the Region Map Editor incorrectly displaying whether a MAPSEC has region map data.
  • Fix the Primary/Secondary Tileset selectors allowing invalid text, and considering a map unsaved if changed to invalid text then back again.
  • Fix broken error message for the primary tileset on the new map/layout dialogs.
  • Fix the dialog for duplicating/importing a map layout not allowing the tilesets to be changed.
  • Fix warning not appearing when the log file exceeds maximum size.
  • Fix possible lag while using the Tileset Editor's tile selector.
  • Fix unnecessary resources being used to watch files.
  • Fix possible crash on Linux if too many inotify instances are requested.
6.1.09 Jun 2025

Added

  • Add settings to change the application font and the map list font.

Changed

  • The scale of the map can now be changed while resizing the map.

Fixed

  • Fix duplicated maps writing the wrong name.
  • Fix small maps being difficult to see while resizing.
  • Fix the map border sometimes not updating to reflect changes.
  • Fix expressions using the prefix '0X' as opposed to '0x' not being recognized has hex numbers.
  • Fix certain characters not writing correctly to JSON files.
  • Fix all map.json files being added to the file watcher at launch.
  • Fix files sometimes being removed from the file watcher if they're deleted as part of a write.
  • Fix porymap.cfg and porymap.shortcuts.cfg writing outside the pret/porymap folder.