Update manual

Separate duplicate map/layout, fix window disabling

.github/workflows/main.yml

@@ -6,66 +6,63 @@ on:
   push:
     branches:
     - master
+    - dev
     tags:
     - '*'
   pull_request:
-    branches:
-    - master
 
   # Allows you to run this workflow manually from the Actions tab
   workflow_dispatch:
 
 jobs:
-  build-qt5-linux:
+  build-linux:
+    strategy:
+     matrix:
+       qtversion: [5.14.2, 6.8.*]
     runs-on: ubuntu-latest
     steps:
       # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
-      - uses: actions/checkout@v2
-
-      - name: Cache Qt
-        id: cache-qt
-        uses: actions/cache@v1
-        with:
-          path: ../Qt
-          key: ${{ runner.os }}-QtCache
+      - uses: actions/checkout@v4
 
       - name: Install Qt
-        uses: jurplel/install-qt-action@v2
+        uses: jurplel/install-qt-action@v4
         with:
-          version: '5.14.2'
-          modules: 'qtwidgets qtqml'
-          cached: ${{ steps.cache-qt.outputs.cache-hit }}
+          version: ${{ matrix.qtversion }}
+          modules: 'qtcharts'
+          cache: 'true'
 
       - name: Configure
         run: qmake porymap.pro
 
       - name: Compile
-        run: make
+        run: make -j8
 
   build-macos:
-    runs-on: macos-latest
+    strategy:
+     matrix:
+       os: [macos-latest, macos-15-intel]
+    runs-on: ${{ matrix.os }}
     steps:
       # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
 
-      - name: Cache Qt
-        id: cache-qt
-        uses: actions/cache@v1
-        with:
-          path: ../Qt
-          key: ${{ runner.os }}-QtCache
+      # We need a separate step to expand matrix.os
+      - name: Set Build Name
+        run: echo "BUILD_NAME=porymap-${{ matrix.os }}" >> $GITHUB_ENV
 
       - name: Install Qt
-        uses: jurplel/install-qt-action@v3
+        uses: jurplel/install-qt-action@v4
         with:
-          version: '6.2.*'
-          cached: ${{ steps.cache-qt.outputs.cache-hit }}
+          # 6.10 is the first Qt version (by release date) to support macOS 26
+          version: '6.10.*'
+          modules: 'qtcharts'
+          cache: 'true'
 
       - name: Configure
         run: qmake -config release porymap.pro
 
       - name: Compile
-        run: make
+        run: make -j8
 
       - name: Create Disk Image
         if: startsWith(github.ref, 'refs/tags/')
@@ -74,52 +71,55 @@ jobs:
       - name: Prep Release Directory
         if: startsWith(github.ref, 'refs/tags/')
         run: |
-          mkdir porymap-macOS-${{ github.ref_name }}
-          cp porymap.dmg porymap-macOS-${{ github.ref_name }}/porymap.dmg
-          cp RELEASE-README.txt porymap-macOS-${{ github.ref_name }}/README.txt
+          mkdir ${{ env.BUILD_NAME }}
+          cp porymap.dmg ${{ env.BUILD_NAME }}/porymap.dmg
+          cp RELEASE-README.txt ${{ env.BUILD_NAME }}/README.txt
 
       - name: Bundle Release Directory
         if: startsWith(github.ref, 'refs/tags/')
-        run: zip -r porymap-macOS-${{ github.ref_name }}.zip porymap-macOS-${{ github.ref_name }}
+        run: zip -r ${{ env.BUILD_NAME }}.zip ${{ env.BUILD_NAME }}
 
       - name: Release
-        uses: softprops/action-gh-release@v1
+        uses: softprops/action-gh-release@v2
         if: startsWith(github.ref, 'refs/tags/')
         with:
-          files: porymap-macOS-${{ github.ref_name }}.zip
+          files: ${{ env.BUILD_NAME }}.zip
         env:
             GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
   build-static-windows:
+    if: false  # Windows job is currently disabled; it's failing to find required modules in the Qt build
     runs-on: windows-latest
+    env:
+      BUILD_NAME: porymap-windows
     steps:
       # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
       
       - uses: dsaltares/fetch-gh-release-asset@master
         if: steps.cache-static-qt.outputs.cache-hit != 'true'
         with:
           repo: 'huderlem/porymap'
-          version: 'tags/qt-static-6.0.1-windows'
-          file: 'Qt-Static-Windows-mingw-6.0.1.zip'
+          version: 'tags/qt-static-6.9.0-windows'
+          file: 'Qt-Static-Windows-mingw-6.9.0.zip'
           token: ${{ secrets.GITHUB_TOKEN }}
       
       - name: Unzip Static Qt
         if: steps.cache-static-qt.outputs.cache-hit != 'true'
-        run: powershell.exe -Command "Expand-Archive -Path Qt-Static-Windows-mingw-6.0.1.zip -DestinationPath ../Qt"
+        run: powershell.exe -Command "Expand-Archive -Path Qt-Static-Windows-mingw-6.9.0.zip -DestinationPath ../Qt"
       
       - uses: dsaltares/fetch-gh-release-asset@master
         with:
           repo: 'huderlem/porymap'
-          version: 'tags/qt-static-6.0.1-windows'
-          file: 'mingw810_64.zip'
+          version: 'tags/qt-static-6.9.0-windows'
+          file: 'mingw1310_64.zip'
           token: ${{ secrets.GITHUB_TOKEN }}
       
       - name: Unzip mingw
-        run: powershell.exe -Command "Expand-Archive -Path mingw810_64.zip -DestinationPath ../mingw810_64"
+        run: powershell.exe -Command "Expand-Archive -Path mingw1310_64.zip -DestinationPath ../mingw1310_64"
       
       - name: Add Qt Static to PATH
-        run: echo "$env:GITHUB_WORKSPACE/../Qt/6.0.1/bin" | Out-File -Append -FilePath $env:GITHUB_PATH -Encoding utf8
+        run: echo "$env:GITHUB_WORKSPACE/../Qt/6.9.0/bin" | Out-File -Append -FilePath $env:GITHUB_PATH -Encoding utf8
 
       - name: Add static config to .pro file
         run: echo "CONFIG += qt static" >> porymap.pro
@@ -129,32 +129,35 @@ jobs:
 
       - name: Run Qmake
         env:
-          QTDIR: ../Qt/6.0.1
-        run: qmake.exe -o Makefile porymap.pro -spec win32-g++ "CONFIG+=qtquickcompiler"
+          QTDIR: ../Qt/6.9.0
+          QMAKESPEC: ${{ github.workspace }}/../Qt/6.9.0/mkspecs/win32-g++
+        run: |
+          dir $env:GITHUB_WORKSPACE/../Qt/6.9.0/mkspecs
+          qmake.exe -o Makefile porymap.pro "CONFIG+=qtquickcompiler"
 
       - name: Add mingw to PATH
-        run: echo "$env:GITHUB_WORKSPACE/../mingw810_64/bin" | Out-File -Append -FilePath $env:GITHUB_PATH -Encoding utf8
+        run: echo "$env:GITHUB_WORKSPACE/../mingw1310_64/bin" | Out-File -Append -FilePath $env:GITHUB_PATH -Encoding utf8
 
       - name: Compile
         env:
-          QTDIR: ../Qt/6.0.1
+          QTDIR: ../Qt/6.9.0
         run: mingw32-make.exe -j8
       
       - name: Prep Release Directory
         if: startsWith(github.ref, 'refs/tags/')
         run: |
-          mkdir porymap-windows-${{ github.ref_name }}
-          cp release/porymap.exe porymap-windows-${{ github.ref_name }}/porymap.exe
-          cp RELEASE-README.txt porymap-windows-${{ github.ref_name }}/README.txt
+          mkdir $BUILD_NAME
+          cp release/porymap.exe $BUILD_NAME/porymap.exe
+          cp RELEASE-README.txt $BUILD_NAME/README.txt
       
       - name: Bundle Release Directory
         if: startsWith(github.ref, 'refs/tags/')
-        run: powershell.exe -Command "Compress-Archive -Path porymap-windows-${{ github.ref_name }} -DestinationPath porymap-windows-${{ github.ref_name }}.zip"
+        run: powershell.exe -Command "Compress-Archive -Path $BUILD_NAME -DestinationPath $BUILD_NAME.zip"
       
       - name: Create Release
-        uses: softprops/action-gh-release@v1
+        uses: softprops/action-gh-release@v2
         if: startsWith(github.ref, 'refs/tags/')
         with:
-          files: porymap-windows-${{ github.ref_name }}.zip
+          files: $BUILD_NAME.zip
         env:
             GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -8,9 +8,12 @@ porymap.app*
 porymap
 porymap.cfg
 porymap.log
+build/
+venv/
 
 # Qt generated files
 ui_*.h
 moc_*.h
 moc_*.cpp
 qrc_*.cpp
+.qtc_clangd

CHANGELOG.md

@@ -2,13 +2,284 @@
 All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project somewhat adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).  The MAJOR version number is bumped when there are breaking changes in the pret projects.
-
-The **"Breaking Changes"** listed below are changes that have been made in the decompilation projects (e.g. pokeemerald), which porymap requires in order to work properly. It also includes changes to the scripting API that may change the behavior of existing porymap scripts. If porymap is used with a project or API script that is not up-to-date with the breaking changes, then porymap will likely break or behave improperly.
+and this project somewhat adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).  The MAJOR version number is bumped when there are **"Breaking Changes"** in the pret projects. For more on this, see [the manual page on breaking changes](https://huderlem.github.io/porymap/manual/breaking-changes.html).
 
 ## [Unreleased]
 Nothing, yet.
 
+## [6.3.0] - 2025-12-26
+### 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.
+   - Previously, the middle mouse button could be used as a shortcut with the pencil tool to switch to bucket-fill mode. This is now achieved using the `Alt` key.
+
+### 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.0] - 2025-08-08
+### 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.0] - 2025-06-09
+### 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.
+
+## [6.0.0] - 2025-05-27
+### Breaking Changes
+- See [Breaking Changes](https://huderlem.github.io/porymap/manual/breaking-changes.html) in the manual.
+
+### Added
+- Redesigned the map list, adding new features including opening/editing layouts with no associated map, editing the names of map groups, rearranging maps and map groups, and hiding empty folders.
+- Add a drop-down for changing the layout of the currently opened map.
+- Add an option to duplicate maps/layouts.
+- Redesigned the Connections tab, adding new features including the option to open or display diving maps and a list UI for easier edit access.
+- Add a `Close Project` option
+- Add a search button to the `Wild Pokémon` tab that shows the encounter data for a species across all maps.
+- Add charts to the `Wild Pokémon` tab that show species and level distributions for the current map.
+- Add options for customizing the map grid under `View -> Grid Settings`.
+- Add an option to display Event sprites while editing the map.
+- Add an option to display a dividing line between tilesets in the Tileset Editor.
+- Add an input field to the Tileset Editor for editing the full metatile attributes value directly, including unused bits.
+- An alert will be displayed when attempting to open a seemingly invalid project.
+- Add support for defining project values with `enum` where `#define` was expected.
+- Add support for referring to object events and warps with named IDs, rather than referring to them with their index number.
+- Add a setting to specify the tile values to use for the unused metatile layer.
+- Add a setting to specify the maximum number of events in a group. A warning will be shown if too many events are added.
+- Add a setting to customize the size and position of the player view distance.
+- Add `onLayoutOpened` to the scripting API.
+- Add a splash loading screen for project openings.
+- Add Back/Forward buttons for navigating to previous maps or layouts.
+
+### Changed
+- `Change Dimensions` now has an interactive resizing rectangle.
+- Redesigned the new map dialog, including better error checking and a collapsible section for header data.
+- New maps/layouts are no longer saved automatically, and can be fully discarded by closing without saving.
+- Map groups and ``MAPSEC`` names specified when creating a new map will be added automatically if they don't already exist.
+- Custom fields in JSON files that Porymap writes are no longer discarded.
+- Edits to map connections now have Undo/Redo and can be viewed in exported timelapses.
+- Changes to the "Mirror to Connecting Maps" setting will now be saved between sessions.
+- A notice will be displayed when attempting to open the "Dynamic" map, rather than nothing happening.
+- The base game version is now auto-detected if the project name contains only one of "emerald", "firered/leafgreen", or "ruby/sapphire".
+- It's now possible to cancel quitting if there are unsaved changes in sub-windows.
+- The triple-layer metatiles setting can now be set automatically using a project constant.
+- `Export Map Stitch Image` and `Export Map Timelapse Image` now show a preview of the full image/gif, not just the current map.
+- `Custom Attributes` tables now display numbers using spin boxes. The `type` column was removed, because `value`'s type is now obvious.
+- Unrecognized map names in Event or Connections data will no longer be overwritten.
+- It's now possible to click on an event's sprite even if a different event's rectangle is overlapping it. The old selection behavior is available via a new setting.
+- Reduced diff noise when saving maps.
+- Map names and ``MAP_NAME`` constants are no longer required to match.
+- Porymap will no longer overwrite ``include/constants/map_groups.h`` or ``include/constants/layouts.h``.
+- Primary/secondary metatile images are now kept on separate rows, rather than blending together if the primary size is not divisible by 8.
+- The prompt to reload the project when a file has changed will now only appear when Porymap is the active application.
+- `Script` dropdowns now autocomplete only with scripts from the current map, rather than every script in the project. The old behavior is available via a new setting.
+- `Script` dropdowns now update automatically if the current map's scripts file is edited.
+- The options for `Encounter Type` and `Terrain Type` in the Tileset Editor are not hardcoded anymore, they're now read from the project.
+- The `symbol_wild_encounters` setting was replaced; this value is now read from the project.
+- The max encounter rate is now read from the project, rather than assuming the default value from RSE.
+- `MAP_OFFSET_W` and `MAP_OFFSET_H` (used to limit the maximum map size) are now read from the project.
+- The rendered area of the map border is now limited to the maximum player view distance (prior to this it included two extra rows on the top and bottom).
+- Right-clicking on the border metatiles image will now select that metatile.
+- An error message will now be shown when Porymap is unable to save changes (e.g. if Porymap doesn't have write permissions for your project).
+- Error and warning logs are now displayed in the status bar. This can be changed with a new setting.
+- A project may now be opened even if it has no maps or map groups. A minimum of one map layout is required.
+- The file extensions that are expected for `.png` and `.pal` data files and the extensions outputted when creating a new tileset can now be customized.
+- Miscellaneous performance improvements, especially for opening projects.
+
+### Fixed
+- Fix `Add Region Map...` not updating the region map settings file.
+- Fix some crashes on invalid region map tilesets.
+- Improve error reporting for invalid region map editor settings.
+- Fix the region map editor's palette resetting between region maps.
+- Fix the region map editor's h-flip and v-flip settings being swapped.
+- Fix config files being written before the project is opened successfully.
+- Fix the map and other project info still displaying if a new project fails to open.
+- Fix unsaved changes being ignored when quitting (such as with Cmd+Q on macOS).
+- Fix selections with multiple events not always clearing when making a new selection.
+- Fix the new event button not updating correctly when selecting object events.
+- Fix duplicated `Hidden Item` events not copying the `Requires Itemfinder` field.
+- Fix event sprites disappearing in certain areas outside the map boundaries.
+- Fix deselecting an event still allowing you to drag the event around.
+- Fix events rendering on top of the ruler at very high y values.
+- Fix new map names not appearing in event dropdowns that have already been populated.
+- Fix `About porymap` opening a new window each time it's activated.
+- Fix the `Edit History` window not raising to the front when reactivated.
+- New maps are now always inserted in map dropdowns at the correct position, rather than at the bottom of the list until the project is reloaded.
+- Fix species on the wild pokémon tab retaining icons from previously-opened projects.
+- Fix invalid species names clearing from wild pokémon data when revisited.
+- Fix editing wild pokémon data not marking the map as unsaved.
+- Fix editing an event's `Custom Attributes` not marking the map as unsaved.
+- Fix changes to map connections not marking connected maps as unsaved.
+- Fix numerous issues related to connecting a map to itself.
+- Fix incorrect map connections getting selected when opening a map by double-clicking a map connection.
+- Fix a visual issue when quickly dragging map connections around.
+- Fix map connections rendering incorrectly if their direction name was unknown.
+- Fix map connections rendering incorrectly if their dimensions were smaller than the border draw distance.
+- Fix metatile/collision selection images skewing off-center after opening a map from the Connections tab.
+- Fix the map list filter retaining text between project open/close.
+- Fix the map list mishandling value gaps when sorting by Area.
+- Fix a freeze on startup if project values are defined with mismatched parentheses.
+- Fix stitched map images sometimes rendering garbage
+- Fix the `Reset` button on `Export Map Timelapse Image` not resetting the Timelapse settings.
+- Fix events in exported map stitch images being occluded by neighboring maps.
+- Fix the map connections in exported map images coming from the map currently open in the editor, rather than the map shown in the export window.
+- Fix crash when exporting a map stitch image if a map fails to load.
+- Fix possible crash when exporting a timelapse that has events edit history.
+- Fix exported timelapses excluding pasted events and certain map size changes.
+- Fix exporting a timelapse sometimes altering the state of the current map's edit history.
+- Stop sliders in the Palette Editor from creating a bunch of edit history when used.
+- Fix scrolling on some containers locking up when the mouse stops over a spin box or combo box.
+- Fix the selection index for some combo boxes differing from their displayed text.
+- Fix some file dialogs returning to an incorrect window when closed.
+- Fix bug where reloading a layout would overwrite all unsaved changes.
+- Fix bug where layout json and blockdata could be saved separately leading to inconsistent data.
+- Fix crash when saving tilesets with fewer palettes than the maximum.
+- Fix projects not opening on Windows if the project filepath contains certain characters.
+- Fix custom project filepaths not converting Windows file separators.
+- Fix exported tile images containing garbage pixels after the end of the tiles.
+- Fix fully transparent pixels rendering with the incorrect color.
+- Fix the values for some config fields shuffling their order every save.
+- Fix `key`s in `Custom Attributes` disappearing if given an empty name or the name of an existing field.
+- Fix some problems with tileset detection when importing maps from AdvanceMap.
+- Fix certain input fields allowing invalid identifiers, like names starting with numbers.
+- Fix crash in the Shortcuts Editor when applying changes after closing certain windows.
+- Fix the Shortcuts Editor clearing shortcuts after selecting them.
+- Fix `Display Metatile Usage Counts` sometimes changing the counts after repeated use.
+- The Metatile / Tile usage counts in the Tileset Editor now update to reflect changes.
+- Fix regression that stopped the map zoom from centering on the cursor.
+- Fix `Open Map Scripts` not working on maps with a `shared_scripts_map` field.
+- Fix the main window sometimes exceeding the screen size on first launch.
+- Fix right-click selections with the eyedropper clearing when the mouse is released.
+- Fix overworld sprite facing directions if spritesheet is arranged in multiple rows.
+
+## [5.4.1] - 2024-03-21
+### Fixed
+- Fix object event sprites not loading for some struct data formats.
+
+## [5.4.0] - 2024-02-13
+### Added
+- Add a `Check for Updates` option to show new releases (Windows and macOS only).
+
+### Changed
+- If Wild Encounters fail to load they are now only disabled for that session, and the settings remain unchanged.
+- Defaults are used if project constants are missing, rather than failing to open the project or changing settings.
+- Selector images now center on the selection when eyedropping or zooming.
+
+### Fixed
+- Fix some minor visual issues with the various zoom sliders.
+- Smooth out scrolling when mouse is over tile/metatile images.
+- Fix the Tileset Editor selectors getting extra white space when changing tilesets.
+- Fix a crash when adding disabled events with the Pencil tool.
+- Fix error log about failing to find the scripts file when a new map is created.
+
+## [5.3.0] - 2024-01-15
+### Added
+- Add zoom sliders to the Tileset Editor.
+- Add `getMetatileBehaviorName` and `setMetatileBehaviorName` to the API.
+- Add `metatile_behaviors`, `num_primary_palettes`, and `num_secondary_palettes` to `constants` in the API.
+
+### Changed
+- Metatile ID strings are now padded to their current max, not the overall max.
+- Non-existent directories are now removed from the Open Recent Project menu.
+- Hovering on the layer view in the Tileset Editor now displays the tile ID.
+- Labels in the Script dropdown are now sorted alphabetically.
+- The name of the Heal Locations table is no longer enforced.
+- The API functions `addImage` and `createImage` now support project-relative paths.
+
+### Fixed
+- Fix the metatile selector rectangle jumping when selecting up or left of the origin.
+- Fix the event group tabs sometimes showing an event from the wrong group.
+- Fix the clear buttons in the Shortcuts Editor not actually removing shortcuts.
+- Fix slow speed for the script label autcomplete.
+- Fix deleted script labels still appearing in the autocomplete after project reload.
+- Fix the map search bar stealing focus on startup.
+- Fix border metatiles view not resizing properly.
+- Fix Open Recent Project not clearing the API overlay
+- Fix API error reporting.
+
 ## [5.2.0] - 2024-01-02
 ### Added
 - Add an editor window under `Options -> Project Settings...` to customize the project-specific settings in `porymap.project.cfg` and `porymap.user.cfg`.
@@ -327,7 +598,7 @@ Nothing, yet.
 ## [2.0.0] - 2019-10-16
 ### Breaking Changes
 - Accomodate event object graphics pointer table being explicitly indexed. From changes introduced in commits [cdae0c1444bed98e652c87dc3e3edcecacfef8be](https://github.com/pret/pokeemerald/commit/cdae0c1444bed98e652c87dc3e3edcecacfef8be) and [0e8ccfc4fd3544001f4c25fafd401f7558bdefba](https://github.com/pret/pokeruby/commit/0e8ccfc4fd3544001f4c25fafd401f7558bdefba).
-- New "field" key in wild encounter JSON data from pokeemerald and pokeruby commits [adb0a444577b59eb02788c782a3d04bc285be0ba](https://github.com/pret/pokeemerald/commit/adb0a444577b59eb02788c782a3d04bc285be0ba) and [https://github.com/pret/pokeruby/commit/c73de8bed752ca538d90cfc93c4a9e8c7965f8c9](c73de8bed752ca538d90cfc93c4a9e8c7965f8c9).
+- New "field" key in wild encounter JSON data from pokeemerald and pokeruby commits [adb0a444577b59eb02788c782a3d04bc285be0ba](https://github.com/pret/pokeemerald/commit/adb0a444577b59eb02788c782a3d04bc285be0ba) and [c73de8bed752ca538d90cfc93c4a9e8c7965f8c9](https://github.com/pret/pokeruby/commit/c73de8bed752ca538d90cfc93c4a9e8c7965f8c9).
 
 
 ### Added
@@ -439,7 +710,14 @@ Nothing, yet.
 ## [1.0.0] - 2018-10-26
 This was the initial release.
 
-[Unreleased]: https://github.com/huderlem/porymap/compare/5.2.0...HEAD
+[Unreleased]: https://github.com/huderlem/porymap/compare/6.3.0...HEAD
+[6.3.0]: https://github.com/huderlem/porymap/compare/6.2.0...6.3.0
+[6.2.0]: https://github.com/huderlem/porymap/compare/6.1.0...6.2.0
+[6.1.0]: https://github.com/huderlem/porymap/compare/6.0.0...6.1.0
+[6.0.0]: https://github.com/huderlem/porymap/compare/5.4.1...6.0.0
+[5.4.1]: https://github.com/huderlem/porymap/compare/5.4.0...5.4.1
+[5.4.0]: https://github.com/huderlem/porymap/compare/5.3.0...5.4.0
+[5.3.0]: https://github.com/huderlem/porymap/compare/5.2.0...5.3.0
 [5.2.0]: https://github.com/huderlem/porymap/compare/5.1.1...5.2.0
 [5.1.1]: https://github.com/huderlem/porymap/compare/5.1.0...5.1.1
 [5.1.0]: https://github.com/huderlem/porymap/compare/5.0.0...5.1.0

INSTALL.md

@@ -1,6 +1,13 @@
 # Installation
 
-porymap requires Qt 5.14.2 & C++11.
+**Note**: For Windows and macOS, installation is not required to use Porymap. You can download the latest release to begin using Porymap immediately.
+
+ - [Download Porymap for Windows](https://github.com/huderlem/porymap/releases/latest/download/porymap-windows.zip).
+ - [Download Porymap for macOS latest (arm)](https://github.com/huderlem/porymap/releases/latest/download/porymap-macos-latest.zip).
+ - [Download Porymap for macOS 15 (intel)](https://github.com/huderlem/porymap/releases/latest/download/porymap-macos-15-intel.zip).
+
+
+For installation, Porymap requires Qt 5.14.2 & C++11.
 
 ## macOS
 
@@ -30,11 +37,30 @@ Install [Qt development tools](https://www.qt.io/download-qt-installer), and use
 ## Ubuntu
 
 You need to install Qt. The minimum supported version is currently Qt 5.14.2. You can check your Qt version
-with `qtdiag`.
+with `qtdiag` or `qmake --version`.
 
 ```bash
 sudo apt-get install qt6-declarative-dev
 # if your distro does not have qt6-declarative-dev, try sudo apt-get install qtdeclarative5-dev
+
+git clone https://github.com/huderlem/porymap
+cd porymap
+
+qmake
+make
+./porymap
+```
+
+## Arch Linux
+
+You need to install Qt. You can check the version of your Qt packages with `qtdiag` or `qmake --version`.
+
+```bash
+sudo pacman -S qt6-declarative qt6-charts
+
+git clone https://github.com/huderlem/porymap
+cd porymap
+
 qmake
 make
 ./porymap

README.md

@@ -6,14 +6,29 @@ A map editor for the Pokémon generation 3 decompilation projects ([pokeruby][po
 
 To get started, view the full online guide here: https://huderlem.github.io/porymap/
 
-View the [Changelog][changelog] to see what's new, and download the latest version from the [Releases][releases].
+View the [Changelog][changelog] to see what's new.
+
+## Download
+
+Windows and macOS users can download Porymap below to start using it immediately. Older versions of Porymap may be downloaded from the [Releases][releases] page.
+
+ - [Download Porymap for Windows](https://github.com/huderlem/porymap/releases/latest/download/porymap-windows.zip).
+ - [Download Porymap for macOS latest (arm)](https://github.com/huderlem/porymap/releases/latest/download/porymap-macos-latest.zip).
+ - [Download Porymap for macOS 15 (intel)](https://github.com/huderlem/porymap/releases/latest/download/porymap-macos-15-intel.zip).
+
+Linux users must compile Porymap from source.
+
+<details>
+    <summary><i>Pre-compiled builds for Linux...</i></summary>
+
+>   If you are a Linux user and you do not want to compile Porymap from source, you may find Porymap on an external package repository like Flathub or AUR.
+>   Builds installed through an external package manager are not explicitly maintained by Porymap and may be out of date.
+</details>
+
+Read [INSTALL.md](INSTALL.md) for instructions on how to compile Porymap from source.
 
 ![Porymap Preview](docsrc/manual/images/introduction/porymap-loaded-project.png)
 
-## Local Development
-
-Read [INSTALL.md](INSTALL.md) for instructions on how to compile Porymap from source. If you simply want to use Porymap, download the latest version from the [Releases][releases].
-
 [pokeruby]: https://github.com/pret/pokeruby
 [pokeemerald]: https://github.com/pret/pokeemerald
 [pokefirered]: https://github.com/pret/pokefirered

RELEASE-README.txt

@@ -1,10 +1,5 @@
-Version: 5.2.0
-Date: January 2nd, 2024
-
-This version of porymap works with pokeruby and pokeemerald as of the following commit hashes:
-* pokeemerald: c76beed98990a57c84d3930190fd194abfedf7e8
-* pokefirered: 52591dcee42933d64f60c59276fc13c3bb89c47b
-* pokeruby: d99cb43736dd1d4ee4820f838cb259d773d8bf25
+Version: 6.3.0
+Date: December 26th, 2025
 
 Official Porymap documentation: https://huderlem.github.io/porymap/
 
@@ -12,6 +7,279 @@ Please report any issues on GitHub: [https://github.com/huderlem/porymap/issues]
 
 -------------------------
 
+## [6.3.0] - 2025-12-26
+### 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.
+   - Previously, the middle mouse button could be used as a shortcut with the pencil tool to switch to bucket-fill mode. This is now achieved using the `Alt` key.
+
+### 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.0] - 2025-08-08
+### 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.0] - 2025-06-09
+### 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.
+
+## [6.0.0] - 2025-05-27
+### Breaking Changes
+- See [Breaking Changes](https://huderlem.github.io/porymap/manual/breaking-changes.html) in the manual.
+
+### Added
+- Redesigned the map list, adding new features including opening/editing layouts with no associated map, editing the names of map groups, rearranging maps and map groups, and hiding empty folders.
+- Add a drop-down for changing the layout of the currently opened map.
+- Add an option to duplicate maps/layouts.
+- Redesigned the Connections tab, adding new features including the option to open or display diving maps and a list UI for easier edit access.
+- Add a `Close Project` option
+- Add a search button to the `Wild Pokémon` tab that shows the encounter data for a species across all maps.
+- Add charts to the `Wild Pokémon` tab that show species and level distributions for the current map.
+- Add options for customizing the map grid under `View -> Grid Settings`.
+- Add an option to display Event sprites while editing the map.
+- Add an option to display a dividing line between tilesets in the Tileset Editor.
+- Add an input field to the Tileset Editor for editing the full metatile attributes value directly, including unused bits.
+- An alert will be displayed when attempting to open a seemingly invalid project.
+- Add support for defining project values with `enum` where `#define` was expected.
+- Add support for referring to object events and warps with named IDs, rather than referring to them with their index number.
+- Add a setting to specify the tile values to use for the unused metatile layer.
+- Add a setting to specify the maximum number of events in a group. A warning will be shown if too many events are added.
+- Add a setting to customize the size and position of the player view distance.
+- Add `onLayoutOpened` to the scripting API.
+- Add a splash loading screen for project openings.
+- Add Back/Forward buttons for navigating to previous maps or layouts.
+
+### Changed
+- `Change Dimensions` now has an interactive resizing rectangle.
+- Redesigned the new map dialog, including better error checking and a collapsible section for header data.
+- New maps/layouts are no longer saved automatically, and can be fully discarded by closing without saving.
+- Map groups and ``MAPSEC`` names specified when creating a new map will be added automatically if they don't already exist.
+- Custom fields in JSON files that Porymap writes are no longer discarded.
+- Edits to map connections now have Undo/Redo and can be viewed in exported timelapses.
+- Changes to the "Mirror to Connecting Maps" setting will now be saved between sessions.
+- A notice will be displayed when attempting to open the "Dynamic" map, rather than nothing happening.
+- The base game version is now auto-detected if the project name contains only one of "emerald", "firered/leafgreen", or "ruby/sapphire".
+- It's now possible to cancel quitting if there are unsaved changes in sub-windows.
+- The triple-layer metatiles setting can now be set automatically using a project constant.
+- `Export Map Stitch Image` and `Export Map Timelapse Image` now show a preview of the full image/gif, not just the current map.
+- `Custom Attributes` tables now display numbers using spin boxes. The `type` column was removed, because `value`'s type is now obvious.
+- Unrecognized map names in Event or Connections data will no longer be overwritten.
+- It's now possible to click on an event's sprite even if a different event's rectangle is overlapping it. The old selection behavior is available via a new setting.
+- Reduced diff noise when saving maps.
+- Map names and ``MAP_NAME`` constants are no longer required to match.
+- Porymap will no longer overwrite ``include/constants/map_groups.h`` or ``include/constants/layouts.h``.
+- Primary/secondary metatile images are now kept on separate rows, rather than blending together if the primary size is not divisible by 8.
+- The prompt to reload the project when a file has changed will now only appear when Porymap is the active application.
+- `Script` dropdowns now autocomplete only with scripts from the current map, rather than every script in the project. The old behavior is available via a new setting.
+- `Script` dropdowns now update automatically if the current map's scripts file is edited.
+- The options for `Encounter Type` and `Terrain Type` in the Tileset Editor are not hardcoded anymore, they're now read from the project.
+- The `symbol_wild_encounters` setting was replaced; this value is now read from the project.
+- The max encounter rate is now read from the project, rather than assuming the default value from RSE.
+- `MAP_OFFSET_W` and `MAP_OFFSET_H` (used to limit the maximum map size) are now read from the project.
+- The rendered area of the map border is now limited to the maximum player view distance (prior to this it included two extra rows on the top and bottom).
+- Right-clicking on the border metatiles image will now select that metatile.
+- An error message will now be shown when Porymap is unable to save changes (e.g. if Porymap doesn't have write permissions for your project).
+- Error and warning logs are now displayed in the status bar. This can be changed with a new setting.
+- A project may now be opened even if it has no maps or map groups. A minimum of one map layout is required.
+- The file extensions that are expected for `.png` and `.pal` data files and the extensions outputted when creating a new tileset can now be customized.
+- Miscellaneous performance improvements, especially for opening projects.
+
+### Fixed
+- Fix `Add Region Map...` not updating the region map settings file.
+- Fix some crashes on invalid region map tilesets.
+- Improve error reporting for invalid region map editor settings.
+- Fix the region map editor's palette resetting between region maps.
+- Fix the region map editor's h-flip and v-flip settings being swapped.
+- Fix config files being written before the project is opened successfully.
+- Fix the map and other project info still displaying if a new project fails to open.
+- Fix unsaved changes being ignored when quitting (such as with Cmd+Q on macOS).
+- Fix selections with multiple events not always clearing when making a new selection.
+- Fix the new event button not updating correctly when selecting object events.
+- Fix duplicated `Hidden Item` events not copying the `Requires Itemfinder` field.
+- Fix event sprites disappearing in certain areas outside the map boundaries.
+- Fix deselecting an event still allowing you to drag the event around.
+- Fix events rendering on top of the ruler at very high y values.
+- Fix new map names not appearing in event dropdowns that have already been populated.
+- Fix `About porymap` opening a new window each time it's activated.
+- Fix the `Edit History` window not raising to the front when reactivated.
+- New maps are now always inserted in map dropdowns at the correct position, rather than at the bottom of the list until the project is reloaded.
+- Fix species on the wild pokémon tab retaining icons from previously-opened projects.
+- Fix invalid species names clearing from wild pokémon data when revisited.
+- Fix editing wild pokémon data not marking the map as unsaved.
+- Fix editing an event's `Custom Attributes` not marking the map as unsaved.
+- Fix changes to map connections not marking connected maps as unsaved.
+- Fix numerous issues related to connecting a map to itself.
+- Fix incorrect map connections getting selected when opening a map by double-clicking a map connection.
+- Fix a visual issue when quickly dragging map connections around.
+- Fix map connections rendering incorrectly if their direction name was unknown.
+- Fix map connections rendering incorrectly if their dimensions were smaller than the border draw distance.
+- Fix metatile/collision selection images skewing off-center after opening a map from the Connections tab.
+- Fix the map list filter retaining text between project open/close.
+- Fix the map list mishandling value gaps when sorting by Area.
+- Fix a freeze on startup if project values are defined with mismatched parentheses.
+- Fix stitched map images sometimes rendering garbage
+- Fix the `Reset` button on `Export Map Timelapse Image` not resetting the Timelapse settings.
+- Fix events in exported map stitch images being occluded by neighboring maps.
+- Fix the map connections in exported map images coming from the map currently open in the editor, rather than the map shown in the export window.
+- Fix crash when exporting a map stitch image if a map fails to load.
+- Fix possible crash when exporting a timelapse that has events edit history.
+- Fix exported timelapses excluding pasted events and certain map size changes.
+- Fix exporting a timelapse sometimes altering the state of the current map's edit history.
+- Stop sliders in the Palette Editor from creating a bunch of edit history when used.
+- Fix scrolling on some containers locking up when the mouse stops over a spin box or combo box.
+- Fix the selection index for some combo boxes differing from their displayed text.
+- Fix some file dialogs returning to an incorrect window when closed.
+- Fix bug where reloading a layout would overwrite all unsaved changes.
+- Fix bug where layout json and blockdata could be saved separately leading to inconsistent data.
+- Fix crash when saving tilesets with fewer palettes than the maximum.
+- Fix projects not opening on Windows if the project filepath contains certain characters.
+- Fix custom project filepaths not converting Windows file separators.
+- Fix exported tile images containing garbage pixels after the end of the tiles.
+- Fix fully transparent pixels rendering with the incorrect color.
+- Fix the values for some config fields shuffling their order every save.
+- Fix `key`s in `Custom Attributes` disappearing if given an empty name or the name of an existing field.
+- Fix some problems with tileset detection when importing maps from AdvanceMap.
+- Fix certain input fields allowing invalid identifiers, like names starting with numbers.
+- Fix crash in the Shortcuts Editor when applying changes after closing certain windows.
+- Fix the Shortcuts Editor clearing shortcuts after selecting them.
+- Fix `Display Metatile Usage Counts` sometimes changing the counts after repeated use.
+- The Metatile / Tile usage counts in the Tileset Editor now update to reflect changes.
+- Fix regression that stopped the map zoom from centering on the cursor.
+- Fix `Open Map Scripts` not working on maps with a `shared_scripts_map` field.
+- Fix the main window sometimes exceeding the screen size on first launch.
+- Fix right-click selections with the eyedropper clearing when the mouse is released.
+- Fix overworld sprite facing directions if spritesheet is arranged in multiple rows.
+
+## [5.4.1] - 2024-03-21
+### Fixed
+- Fix object event sprites not loading for some struct data formats.
+
+## [5.4.0] - 2024-02-13
+### Added
+- Add a `Check for Updates` option to show new releases (Windows and macOS only).
+
+### Changed
+- If Wild Encounters fail to load they are now only disabled for that session, and the settings remain unchanged.
+- Defaults are used if project constants are missing, rather than failing to open the project or changing settings.
+- Selector images now center on the selection when eyedropping or zooming.
+
+### Fixed
+- Fix some minor visual issues with the various zoom sliders.
+- Smooth out scrolling when mouse is over tile/metatile images.
+- Fix the Tileset Editor selectors getting extra white space when changing tilesets.
+- Fix a crash when adding disabled events with the Pencil tool.
+- Fix error log about failing to find the scripts file when a new map is created.
+
+## [5.3.0] - 2024-01-15
+### Added
+- Add zoom sliders to the Tileset Editor.
+- Add `getMetatileBehaviorName` and `setMetatileBehaviorName` to the API.
+- Add `metatile_behaviors`, `num_primary_palettes`, and `num_secondary_palettes` to `constants` in the API.
+
+### Changed
+- Metatile ID strings are now padded to their current max, not the overall max.
+- Non-existent directories are now removed from the Open Recent Project menu.
+- Hovering on the layer view in the Tileset Editor now displays the tile ID.
+- Labels in the Script dropdown are now sorted alphabetically.
+- The name of the Heal Locations table is no longer enforced.
+- The API functions `addImage` and `createImage` now support project-relative paths.
+
+### Fixed
+- Fix the metatile selector rectangle jumping when selecting up or left of the origin.
+- Fix the event group tabs sometimes showing an event from the wrong group.
+- Fix the clear buttons in the Shortcuts Editor not actually removing shortcuts.
+- Fix slow speed for the script label autcomplete.
+- Fix deleted script labels still appearing in the autocomplete after project reload.
+- Fix the map search bar stealing focus on startup.
+- Fix border metatiles view not resizing properly.
+- Fix Open Recent Project not clearing the API overlay
+- Fix API error reporting.
+
 ## [5.2.0] - 2024-01-02
 ### Added
 - Add an editor window under `Options -> Project Settings...` to customize the project-specific settings in `porymap.project.cfg` and `porymap.user.cfg`.

docs/.buildinfo

@@ -1,4 +1,4 @@
 # Sphinx build info version 1
-# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: 23fd5c9a8562e86bc017afd5666bb426
+# This file records the configuration used when building these files. When it is not found, a full rebuild will be done.
+config: ee6cde30f72e7b58d77ea515379cc182
 tags: 645f666f9bcd5a90fca523b33c5a78b7