Read Me First

If you have saved anything you want to keep - campaign files, logs, etc. - under the directory where MapTool is installed, please copy these elsewhere before installing a new version otherwise they will be lost. It is also a good idea to always have backups.

Do not install overtop of an old version. Either install it in a new directory or uninstall the old version first. If using the one of the installers, the previous version should be uninstalled automatically (check the Platform Notes for details).

Platform Notes

The JAR file should only be used by advanced users who are comfortable installing Java releases. You need to install a working Java with JavaFX on your system to use it.

The ZIP file for your platform is a self-contained version of MapTool that can be unzipped into any directory of your choosing. No need for an installer or working Java installation. Just heed the warnings above and don't store campaigns or other files in this directory, and don't try to unzip overtop of an existing version.

Windows

For most users, use the .msi or .exe installer. This will seamlessly update MapTool in the standard location, installing the new version while automatically uninstalling the old versions. But note that versions older than 1.17.0 will not be automatically uninstalled, so you should uninstall such a version manually before updating to 1.17.0 or later.

If you want to install multiple versions of MapTool on Windows, download the MapTool-1.xx.x-win.zip file and unzip it to the folder you want it in.

Linux

If using Ubuntu, you will need Ubuntu 24.04 or later, as the dependencies are not available for earlier versions

If you want to install multiple versions of MapTool on Linux, download the MapTool-1.xx.x-linux.zip file and unzip it to the directory you want it in.

macOS:

Use either .pkg or .dmg.

• On macOS, to run the app the first time after installation, hold Ctrl while clicking the icon and continue to hold Ctrl while choosing Open, then choose to open the application (this is part of Apple's approach when dealing with an unidentified developer).
• The macOS Gatekeeper may flag the DMG file as broken. For more details, see https://github.com/RPTools/maptool/issues/2679.

If you want to install multiple versions of MapTool on MacOS, download the MapTool-1.xx.x-mac.app.zip file and unzip it to the directory you want it in. You can then run the .app file.

What's Changed

Bug Fixes 🩹

• 1.18 - Remove remaining references to GdxRenderer by @kwvanderlinde in https://github.com/RPTools/maptool/pull/5784

Full Changelog: https://github.com/RPTools/maptool/compare/1.18.4...1.18.5