MapTool 이전 버전 및 전체 버전

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 #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

New Features 🥳
- 1.18 - backport native apple arm build from 1.19 by @kwvanderlinde in #6062

Performance Improvements 🏎️
- 1.18 - Only treat macro results as HTML when in an HTML context. by @kwvanderlinde in #6052

Bug Fixes 🩹
- 1.18 - Backport token drag fix from 1.19 by @kwvanderlinde in #6057

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 #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 - Fix token image tables by @kwvanderlinde in #5823
Full Changelog: 1.18.5...1.18.6

Read Me First
Before uninstalling any previous version, please copy them elsewhere beforehand if you have saved your campaign files, logs, or anything else you want to keep under the directory structure where MapTool is installed. It is also a good idea to always have backups.
Note: Do not install over the top of an old version; either install it in a new directory or uninstall the old version first. If you have installed a beta version of 1.16.0, uninstall that first.
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.
Windows
If you want to install multiple version of MapTool on windows download the MapTool-1.xx.x-win.zip file and unzip it to the directory you want it in. If you use the .msi or .exe it will uninstall the older version.
Linux
If using Ubuntu, you will need Ubuntu 24.04 or later, as the dependencies are not available for earlier versions
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 #2679.
What's Changed
Bug Fixes 🩹
- Force anchor position to the cell center for snap-to-grid movement by @kwvanderlinde in #5605
Full Changelog: 1.17.0...1.17.1

Read Me First
Before uninstalling any previous version, please copy them elsewhere beforehand if you have saved your campaign files, logs, or anything else you want to keep under the directory structure where MapTool is installed. It is also a good idea to always have backups.
Note: Do not install over the top of an old version; either install it in a new directory or uninstall the old version first. If you have installed a beta version of 1.16.0, uninstall that first.
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.
Windows
If you want to install multiple version of MapTool on windows download the MapTool-1.xx.x-win.zip file and unzip it to the directory you want it in. If you use the .msi or .exe it will uninstall the older version.
Linux
If using Ubuntu, you will need Ubuntu 24.04 or later, as the dependencies are not available for earlier versions
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 #2679.
What's Changed
New Features 🥳
- Add directionality to walls by @kwvanderlinde in #5118
- Handle rptools-maptool: URI for quick-join links by @fishface60 in #5076
- Support Ephemeral ports by @fishface60 in #5126
- Default campaign props with metric values by @bubblobill in #5175
- MTScript Drawing functions by @bubblobill in #5158
- Windows uri by @fishface60 in #5161
- getNamespace for macro context by @bubblobill in #5197
- Add archives of the app-images as release assets by @kwvanderlinde in #5198
- Hide statsheet overlay when no statsheet visible, and overlay panel when no overlay is visible by @kwvanderlinde in #5264
Bug Fixes 🩹
- Bump upnplib to latest version by @fishface60 in #5131
- Only show drawing layer in Draw Explorer if it is not empty by @kwvanderlinde in #5170
- Add StartupWMClass so MT windows are properly recognized on Linux. by @kwvanderlinde in #5162
- Add property default and reset js bindings by @fishface60 in #5156
- Fix the Arch build so assets are available again by @kwvanderlinde in #5193
- Fix background and fog paints returned by getInfo("map") by @kwvanderlinde in #5181
- Disable focusable tooltips for RSyntaxTextAreas by @kwvanderlinde in #5195
- Reimplement json-indent to remove json-lib by @kwvanderlinde in #5217
- Support strformat literals without passing args by @fishface60 in #5227
- Recognise empty files in addons with .mts suffix as text files by @fishface60 in #5230
- Remove direct console output through the application by @kwvanderlinde in #5245
- Fix deadlock in 1.16.0.rc-1 by @kwvanderlinde in #5269
- Updates to README as well as contributor doco by @cwisniew in #5286
- Disable escaping of HTML characters in json.indent() by @kwvanderlinde in #5303
- Fix with repository export when encountering missing asset. by @cwisniew in #5317
- Retain null in json.indent by @cwisniew in #5359
- 1.17 - Fix ClassCastException when draging snap-to-grid token on gridless map by @kwvanderlinde in #5504
Code Maintenance 🔧
- Retain serviceIdentifier in MapToolServer objects by @fishface60 in #5143
- Update actions/cache to v4 by @kwvanderlinde in #5201
- Add gradle version catalogue by @kwvanderlinde in #5237
- Consolidate scattered protobuf versions by @kwvanderlinde in #5244
- Remove TODO like comments and commented out code by @cwisniew in #5260
- Register mockito as a java agent by @kwvanderlinde in #5261
- Update credits by @cwisniew in #5318
- Exclude all bin/ directories from git source control by @cwisniew in #5320
Dependency Updates
- Bump com.jcabi:jcabi-xml from 0.29.0 to 0.33.5 by @dependabot in #5155
- Bump org.beryx.runtime from 1.13.0 t

Read Me First
Before uninstalling any previous version, please copy them elsewhere beforehand if you have saved your campaign files, logs, or anything else you want to keep under the directory structure where MapTool is installed. It is also a good idea to always have backups.
Note: Do not install over the top of an old version; either install it in a new directory or uninstall the old version first. If you have installed a beta version of 1.16.0, uninstall that first.
Platform Notes
We strongly encourage you to use the installer format for your operating system. The JAR file should only be used by advanced users comfortable installing Java releases. You need to install a working Java with JavaFX on your system to use it.
Note: if using Ubuntu, you will need Ubuntu 24.04 or later, as the dependencies are not available for earlier versions
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 #2679.
What's Changed Since 1.16.3
Bug Fixes 🩹
- Fix for remote client image corruption by @fishface60 in #5451
What's Changed Since 1.16.2
Bug Fixes 🩹
- 1.16 - Do not detach tool if new tool is not available to the player by @kwvanderlinde in #5378
What's Changed Since 1.16.1
Bug Fixes 🩹
- 1.16 - Fix bad FoW check in PointerTool by @kwvanderlinde in #5309
- Fix hex grid dimensions when reading from GridDto by @kwvanderlinde in #5310
- 1.16 - Make tooltips show again for drawing tools, fog of war tools, and topology tools by @kwvanderlinde in #5315
- 1.16 - fix map dragging for drawing tools and expose tools by @kwvanderlinde in #5314
What's Changed Since 1.15.2
New Features 🥳
- BoardTool upgraded to control map image scale by @bubblobill in #4861
- Added ability to load MRU campaign at startup by @bubblobill in #4870
- Return JSON on rest failure to mtscript instead of exception by @Jmr3366 in #4896
- Bind getBar, setBar isBarVisible and setBarVisible to javascript by @fishface60 in #4899
- Add a Handlebars LibraryTemplateLoader and rework file loading to support partial templates by @fishface60 in #4921
- Restrict each drawable light to its lumens level by @kwvanderlinde in #4940
- Add base64Encode handlebars helper by @fishface60 in #4925
- Added hotkey macro button properties to metamacro functions by @bubblobill in #4970
- Do not show local player in Connections window or status panel by @kwvanderlinde in #4983
- Changed behaviour of adding token property. Added JSON export by @bubblobill in #4972
- New function createAsset by @Jmr3366 in #4923
- Add deflate as a supported REST response encoding by @fishface60 in #5016
- Remove topology type selections from zones by @kwvanderlinde in #5042
- Feature to lock an overlay by @Jmr3366 in #5051
- Add landing maps to campaigns by @kwvanderlinde in #5055
- Add "Is landing map?" checkbox to map properties dialog by @kwvanderlinde in #5064
- Bring back unique light sources (no new macro functions) by @kwvanderlinde in #5067
- Add wall-based topology by @kwvanderlinde in #5050
Performance Improvements 🏎️
- Restore circular "unlimited" vision for grid sights by @kwvanderlinde in #5135
Bug Fixes 🩹
- Make tokens more closely follow their leader by @kwvanderlinde in #4817
- Fix hexagon geometry by @kwvanderlinde in #4831
- Add Label.background i18n key needed for editing text labels by @kwvanderlinde in #4846
- Fix splash screen transparency on Linux by @kwvanderlinde in #4847
- Apply changes made to token properties in the campaign settings when pressing "Ok" by @maltedreschert in #4863
- Keep selected token property in view when moving it up or down a big property table by @maltedreschert in #4864
- Call finalizeCellEditing() before switching tokenTypes to make sure t… by @maltedres

Read Me First
Before uninstalling any previous version, please copy them elsewhere beforehand if you have saved your campaign files, logs, or anything else you want to keep under the directory structure where MapTool is installed. It is also a good idea to always have backups.
Note: Do not install over the top of an old version; either install it in a new directory or uninstall the old version first. If you have installed a beta version of 1.16.0, uninstall that first.
Platform Notes
We strongly encourage you to use the installer format for your operating system. The JAR file should only be used by advanced users comfortable installing Java releases. You need to install a working Java with JavaFX on your system to use it.
Note: if using Ubuntu, you will need Ubuntu 24.04 or later, as the dependencies are not available for earlier versions
macOS: Use either .pkg (recommended) 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 #2679.
What's Changed Since 1.16.1
Bug Fixes 🩹
- 1.16 - Fix bad FoW check in PointerTool by @kwvanderlinde in #5309
- Fix hex grid dimensions when reading from GridDto by @kwvanderlinde in #5310
- 1.16 - Make tooltips show again for drawing tools, fog of war tools, and topology tools by @kwvanderlinde in #5315
- 1.16 - fix map dragging for drawing tools and expose tools by @kwvanderlinde in #5314
What's Changed Since 1.15.2
New Features 🥳
- BoardTool upgraded to control map image scale by @bubblobill in #4861
- Added ability to load MRU campaign at startup by @bubblobill in #4870
- Return JSON on rest failure to mtscript instead of exception by @Jmr3366 in #4896
- Bind getBar, setBar isBarVisible and setBarVisible to javascript by @fishface60 in #4899
- Add a Handlebars LibraryTemplateLoader and rework file loading to support partial templates by @fishface60 in #4921
- Restrict each drawable light to its lumens level by @kwvanderlinde in #4940
- Add base64Encode handlebars helper by @fishface60 in #4925
- Added hotkey macro button properties to metamacro functions by @bubblobill in #4970
- Do not show local player in Connections window or status panel by @kwvanderlinde in #4983
- Changed behaviour of adding token property. Added JSON export by @bubblobill in #4972
- New function createAsset by @Jmr3366 in #4923
- Add deflate as a supported REST response encoding by @fishface60 in #5016
- Remove topology type selections from zones by @kwvanderlinde in #5042
- Feature to lock an overlay by @Jmr3366 in #5051
- Add landing maps to campaigns by @kwvanderlinde in #5055
- Add "Is landing map?" checkbox to map properties dialog by @kwvanderlinde in #5064
- Bring back unique light sources (no new macro functions) by @kwvanderlinde in #5067
- Add wall-based topology by @kwvanderlinde in #5050
Performance Improvements 🏎️
- Restore circular "unlimited" vision for grid sights by @kwvanderlinde in #5135
Bug Fixes 🩹
- Make tokens more closely follow their leader by @kwvanderlinde in #4817
- Fix hexagon geometry by @kwvanderlinde in #4831
- Add Label.background i18n key needed for editing text labels by @kwvanderlinde in #4846
- Fix splash screen transparency on Linux by @kwvanderlinde in #4847
- Apply changes made to token properties in the campaign settings when pressing "Ok" by @maltedreschert in #4863
- Keep selected token property in view when moving it up or down a big property table by @maltedreschert in #4864
- Call finalizeCellEditing() before switching tokenTypes to make sure t… by @maltedreschert in #4865
- Modify ButtonGroup drag to check for no change by @bubblobill in #4888
- Rework javascript getProperty API to handle missing properties better by @fishface60 in #4900
- Reduce number of interfaces scanned for UPnP 

Bug Fix Release for MapTool
This release should fix the issues with disconnects and with the dreaded red Xs.
Read Me First
Before uninstalling any previous version, if you have saved your campaign files, logs, or anything else you want to keep under the directory structure where MapTool is installed, please copy them elsewhere beforehand. It is also a good idea to always have backups.
Note: Do not install over the top of an old version, either install into a new directory or uninstall the old version first.
Highlights## Changes since 1.12.1
- #3723 Checkbox to use theme for chatbox colors move to top of theme preferences tab.
- #3720 Corrected issue with players randomly disconnecting.
- #3719 Macro function setHalo("None") was throwing NPE. Fixed.
- #3703 Grid offsets were reset on loaded maps.
- #3702 Grid offsets were changing on server start. Fixed.
- #3701 Fixed issue with dropped assets showing as red Xs.
- #3700 Macro function removeTokenFacing() was throwing NPE. Fixed.
- #3689 Soft FoW opacity was ignored when no sight was present. Fixed.
- #3688 Soft FoW was rendered even when Sight is off. Fixed.
See full Change Log for more details.
Platform Notes
We strongly encourage you to use the installer format for your operating system. The JAR file should only by used by advanced users comfortable with installing Java releases. It requires a working Java 17 install with JavaFX on your system in order to use it.
Download one of the assets listed below. Each platform has options for which file to download, as described below.
- Windows: Use either .msi (recommended) or .exe.
- Recommend that previous 1.12.0 versions be uninstalled prior to installing new one. If you have made modifications to the MapTool.cfg file, make a backup so you can copy your changes into the new config file.
- Do not install over older versions of MapTool.
- We're seeing notes from Windows users that they double-click the icon after installing and no window appears. This seems to be an antivirus issue, so check your AV if you have this problem.
- Linux: Use either .deb, .rpm or .zst (depending on which packager your system uses).
- The deb version installs under /opt/maptool/bin as MapTool.
- macOS: Use either .pkg (recommended) 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. See this issue for more details.
- Note that macOS Ventura has added even more restrictions as Apple further locks down their walled garden. If you're on that OS, check this page for details on how to solve the problem: https://iboysoft.com/news/app-is-damaged-and-cannot-be-opened.html

MapTool v1.12.1 Bug-Fix Release
Read Me First
Before uninstalling any previous version, if you have saved your campaign files, logs, or anything else you want to keep under the directory structure where MapTool is installed, please copy them elsewhere beforehand. It is also a good idea to always have backups.
Note: Do not install over the top of an old version, either install into a new directory or uninstall the old version first. If you have installed a previous version of 1.12.0, uninstall that first.
Changes since 1.12.0
- #3669 Token Bars were resetting to Top side after server start. Fixed.
- #3662 Edit Token dialog was too tall for lower resolution screens. Fixed.
- #3660 Image Scaling Quality now defaults to Low (Fastest) setting.
- #3658 Docked windows set to auto-hide could not be resized. Fixed.
- #3656 Fixes for image scaling performance.
- #3654 Added logging for initiative null pointer.
- #3653 More fixes for older campaign compatibility.
- #3652 Image scaling on all layers now respect preferences choice to improve performance.
- #3651 For performance reasons additive blending for lights/sights removed.
- #3647 Fixes for loading campaigns created in prior versions.
- #3642 Macro function getState() would always return 0. Fixed.
See complete change log for v1.12.1.
Platform Notes
We strongly encourage you to use the installer format for your operating system. The JAR file should only by used by advanced users comfortable with installing Java releases. It requires a working Java 17 install with JavaFX on your system in order to use it.
Download one of the assets listed below. Each platform has options for which file to download, as described below.
- Windows: Use either .msi (recommended) or .exe.
- Recommend that previous 1.12.0 versions be uninstalled prior to installing new one. If you have made modifications to the MapTool.cfg file, make a backup so you can copy your changes into the new config file.
- Do not install over older versions of MapTool.
- We're seeing notes from Windows users that they double-click the icon after installing and no window appears. This seems to be an antivirus issue, so check your AV if you have this problem.
- Linux: Use either .deb, .rpm or .zst (depending on which packager your system uses).
- The deb version installs under /opt/maptool/bin as MapTool.
- macOS: Use either .pkg (recommended) 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. See this issue for more details.

MapTool v1.12.0 Feature Release
Read Me First
Before uninstalling any previous version, if you have saved your campaign files, logs, or anything else you want to keep under the directory structure where MapTool is installed, please copy them elsewhere beforehand. It is also a good idea to always have backups.
Note: Do not install over the top of an old version, either install into a new directory or uninstall the old version first. If you have installed a beta version of 1.12.0, uninstall that first.
Highlights
- New theme support using the FlatLaf library
- Hill, Pit VBL types and MBL can now be placed on Tokens
- Improved WebRTC stability/functionality
- Improvements to new Add-On Library functionality
- See https://rptools-doc.craigs-stuff.net/blog/
- And https://rptools-doc.craigs-stuff.net/docs/add-ons/index
- And #3158
- Improved rendering of lights and darkness sources
- New preferences option for Low/Medium/High quality scaling of images
- Now using Java 17
Changes
See Change Log for more details.
Platform Notes
We strongly encourage you to use the installer format for your operating system. The JAR file should only by used by advanced users comfortable with installing Java releases. It requires a working Java 17 install with JavaFX on your system in order to use it.
Download one of the assets listed below. Each platform has options for which file to download, as described below.
- Windows: Use either .msi (recommended) or .exe.
- Recommend that previous 1.12.0 versions be uninstalled prior to installing new one. If you have made modifications to the MapTool.cfg file, make a backup so you can copy your changes into the new config file.
- Do not install over older versions of MapTool.
- We're seeing notes from Windows users that they double-click the icon after installing and no window appears. This seems to be an antivirus issue, so check your AV if you have this problem.
- Linux: Use either .deb, .rpm or .zst (depending on which packager your system uses).
- The deb version installs under /opt/maptool/bin as MapTool.
- macOS: Use either .pkg (recommended) 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. See this issue for more details.

Connectivity Improvement Release
Read Me First
Before uninstalling any previous version, if you have saved your campaign files, logs, or anything else you want to keep under the directory structure where MapTool is installed, please copy them elsewhere beforehand. It is also a good idea to always have backups.
Note: Do not install over the top of an old version, either install into a new directory or uninstall the old version first.
Changes
- Adds additional logging and improved connection handling when using the WebRTC server option.
See Change Log for more details.
Platform Notes
We strongly encourage you to use the installer format for your operating system. The JAR file should only by used by advanced users comfortable with installing Java releases. It requires a working Java 16 install with JavaFX on your system in order to use it.
Download one of the assets listed below. Each platform has options for which file to download, as described below.
- Windows: Use either .msi (recommended) or .exe.
- Recommend that previous 1.10 versions be uninstalled prior to installing new one. If you have made modifications to the MapTool.cfg file, make a backup so you can copy your changes into the new config file.
- Do not install over older versions of MapTool.
- We're seeing notes from Windows users that they double-click the icon after installing and no window appears. This seems to be an antivirus issue, so check your AV if you have this problem.
- Linux: Use either .deb or .rpm (depending on which packager your system uses).
- The deb version installs under /opt/maptool/bin as MapTool.
- macOS: Use either .pkg (recommended) 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. See this issue for more details.
- Note that macOS Ventura has added even more restrictions as Apple further locks down their walled garden. If you're on that OS, check this page for details on how to solve the problem: https://iboysoft.com/news/app-is-damaged-and-cannot-be-opened.html

Security Fix Release
Read Me First
Before uninstalling any previous version, if you have saved your campaign files, logs, or anything else you want to keep under the directory structure where MapTool is installed, please copy them elsewhere beforehand. It is also a good idea to always have backups.
Note: Do not install over the top of an old version, either install into a new directory or uninstall the old version first.
Changes
- Updated the Log4J libraries for a security vulnerability.
See Change Log for more details.
Platform Notes
We strongly encourage you to use the installer format for your operating system. The JAR file should only by used by advanced users comfortable with installing Java releases. It requires a working Java 16 install with JavaFX on your system in order to use it.
Download one of the assets listed below. Each platform has options for which file to download, as described below.
- Windows: Use either .msi (recommended) or .exe.
- Recommend that previous 1.10 versions be uninstalled prior to installing new one. If you have made modifications to the MapTool.cfg file, make a backup so you can copy your changes into the new config file.
- Do not install over older versions of MapTool.
- We're seeing notes from Windows users that they double-click the icon after installing and no window appears. This seems to be an antivirus issue, so check your AV if you have this problem.
- Linux: Use either .deb or .rpm (depending on which packager your system uses).
- The deb version installs under /opt/maptool/bin as MapTool.
- macOS: Use either .pkg (recommended) 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. See this issue for more details.

Bug Fix Release
Before uninstalling any previous version, if you have saved your campaign files, logs, or anything else you want to keep under the directory structure where MapTool is installed, please copy them elsewhere beforehand. It is also a good idea to always have backups.
Note: Do not install over the top of an old version, either install into a new directory or uninstall the old version first.
Changes
- Another fix for token size reset upon loading older campaigns.
- Calling playStream() without a start time could cause exceptions after playback stopped. Fixed.
- onInitiativeChange event was not triggering unless onInitativeChangeRequest was also on lib:token. Fixed.
Lib:Token Changes
If you use lib:tokens and call macros from dialogs/frames/overlays, you will may need to go into the Lib:Token Properties tab of the Edit Token dialog to enable Allow URI Access.
See ChangeLog for more details and links to individual issues.
Platform Notes
We strongly encourage you to use the installer format for your operating system. The JAR file should only by used by advanced users comfortable with installing Java releases. It requires a working Java 16 install with JavaFX on your system in order to use it.
Download one of the assets listed below. Each platform has options for which file to download, as described below.
- Windows: Use either .msi (recommended) or .exe.
- Recommend that previous 1.10 versions be uninstalled prior to installing new one. If you have made modifications to the MapTool.cfg file, make a backup so you can copy your changes into the new config file.
- Do not install over older versions of MapTool.
- We're seeing notes from Windows users that they double-click the icon after installing and no window appears. This seems to be an antivirus issue, so check your AV if you have this problem.
- Linux: Use either .deb or .rpm (depending on which packager your system uses).
- The deb version installs under /opt/maptool/bin as MapTool.
- macOS: Use either .pkg (recommended) 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. See this issue for more details.

Bug Fix Release
Before uninstalling any previous version, if you have saved your campaign files, logs, or anything else you want to keep under the directory structure where MapTool is installed, please copy them elsewhere beforehand. It is also a good idea to always have backups.
Note: Do not install over the top of an old version, either install into a new directory or uninstall the old version first.
Changes
- Fixes for the dreaded red X plus bar and size resets.
See ChangeLog for more details and links to individual issues.
Platform Notes
We strongly encourage you to use the installer format for your operating system. The JAR file should only by used by advanced users comfortable with installing Java releases. It requires a working Java 16 install with JavaFX on your system in order to use it.
Download one of the assets listed below. Each platform has options for which file to download, as described below.
- Windows: Use either .msi (recommended) or .exe.
- Recommend that previous 1.10 versions be uninstalled prior to installing new one. If you have made modifications to the MapTool.cfg file, make a backup so you can copy your changes into the new config file.
- Do not install over older versions of MapTool.
- We're seeing notes from Windows users that they double-click the icon after installing and no window appears. This seems to be an antivirus issue, so check your AV if you have this problem.
- Linux: Use either .deb or .rpm (depending on which packager your system uses).
- The deb version installs under /opt/maptool/bin as MapTool.
- macOS: Use either .pkg (recommended) 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. See this issue for more details.

Before uninstalling any previous version, if you have saved your campaign files, logs, or anything you want to keep under the directory structure where MapTool is installed, please copy them elsewhere beforehand. It is also a good idea to always have backups.
Note: Do not install over the top of an old version, either install into a new directory or remove the old version.
Bug Fix release for MapTool 1.10.4
What's Changed
- Fix for issue connecting via WebRTC. There are some issues with stopping the server when using WebRTC Still considered experimental for now and for testing only.
Bug Fix release for MapTool 1.10.3
What's Changed
- Fix for issue some windows users are experiencing which does not allow them to exit MapTool.
Bug Fix release for MapTool 1.10.2
What's Changed
- Fix for webp images not being displayed in html dialog/frame when using getTokenImage(), tblImg() as source
Bug Fix release for MapTool 1.10.1
What's Changed
- Fix for size modifier in getTokenImage()
- Properly return numeric values from JavaScript UDFs
- Update README.md Github introduction to MapTool
- New translations updates
See ChangeLog for v1.10.4 for more details and links to individual issues.
Feature release for MapTool 1.10.0
Highlights
- Significantly reduced startup time for MapTool with a large asset cache under Windows.
- User database with encrypted passwords and public key support for logging in to MapTool servers plus macro functions for accessing database.
- WebRTC supported for connecting to servers without using port-forwarding.
- More support for JavaScript through GraalVM-JS.
- Access HTML/CSS/JS content on lib:tokens via URI from dialogs/frames/overlays plus new macro functions to open dialogs/frames/overlays using URIs.
- GIF anim support in dialogs, frame5 and overlays.
- More performance improvements for Fog of War handling.
- New macro functions, bug fixes and localization translations.
See ChangeLog for v1.10.0 for more details and links to individual issues.
Platform Notes
We strongly encourage you to use the installer format for your operating system. The JAR file should only by used by advanced users comfortable with installing Java releases. It requires a working Java 16 install with JavaFX on your system in order to use it.
Download one of the assets listed below. Each platform has options for which file to download, as described below.
- Windows: Use either .msi (recommended) or .exe.
- Recommend that previous 1.10 versions be uninstalled prior to installing new one. If you have made modifications to the MapTool.cfg file, make a backup so you can copy your changes into the new config file.
- Do not install over older versions of MapTool.
- We're seeing notes from Windows users that they double-click the icon after installing and no window appears. This seems to be an antivirus issue, so check your AV if you have this problem.
- Linux: Use either .deb or .rpm (depending on which packager your system uses).
- The deb version installs under /opt/maptool/bin as MapTool.
- macOS: Use either .pkg (recommended) 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. See this issue for more details.
Full Changelog: 1.10.2...1.10.4

Before uninstalling any old version, if you have saved your campaign files, logs, or anything you want to keep under the directory structure where MapTool is installed please copy them elsewhere beforehand. It is also a good idea to always have backups.
Note: Do not install over the top of an old version, either install into a new directory or remove the old version.
Bug Fix release for MapTool 1.10.3
What's Changed
- Fix for issue some windows users are experiencing which does not allow them to exit MapTool.
Bug Fix release for MapTool 1.10.2
What's Changed
- Fix for webp images not being displayed in html dialog/frame when using getTokenImage(), tblImg() as source
Bug Fix release for MapTool 1.10.1
What's Changed
- Fix for size modifier in getTokenImage()
- Properly return numeric values from JavaScript UDFs
- Update README.md Github introduction to MapTool
- New translations updates
See ChangeLog for v1.10.1 for more details and links to individual issues.
Feature release for MapTool 1.10.0
Highlights
- Significantly reduced startup time for MapTool with a large asset cache under Windows.
- User database with encrypted passwords and public key support for logging in to MapTool servers plus macro functions for accessing database.
- WebRTC supported for connecting to servers without using port-forwarding.
- More support for JavaScript through GraalVM-JS.
- Access HTML/CSS/JS content on lib:tokens via URI from dialogs/frames/overlays plus new macro functions to open dialogs/frames/overlays using URIs.
- GIF anim support in dialogs, frame5 and overlays.
- More performance improvements for Fog of War handling.
- New macro functions, bug fixes and localization translations.
See ChangeLog for v1.10.0 for more details and links to individual issues.
Platform Notes
We strongly encourage you to use the installer format for your operating system. The JAR file should only by used by advanced users comfortable with installing Java releases. It requires a working Java 16 install with JavaFX on your system in order to use it.
Download one of the assets listed below. Each platform has options for which file to download, as described below.
- Windows: Use either .msi (recommended) or .exe.
- Recommend that previous 1.10 versions be uninstalled prior to installing new one. If you have made modifications to the MapTool.cfg file, make a backup so you can copy your changes into the new config file.
- Do not install over older versions of MapTool.
- We're seeing notes from Windows users that they double-click the icon after installing and no window appears. This seems to be an antivirus issue, so check your AV if you have this problem.
- Linux: Use either .deb or .rpm (depending on which packager your system uses).
- The deb version installs under /opt/maptool/bin as MapTool.
- macOS: Use either .pkg (recommended) 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. See this issue for more details.
Full Changelog: 1.10.2...1.10.3

Before uninstalling any old version, if you have saved your campaign files, logs, or anything you want to keep under the directory structure where MapTool is installed please copy them elsewhere beforehand. It is also a good idea to always have backups.
Note: Do not install over the top of an old version, either install into a new directory or remove the old version.
Bug Fix release for MapTool 1.10.2
What's Changed
- Fix for webp images not being displayed in html dialog/frame when using getTokenImage(), tblImg() as source
Bug Fix release for MapTool 1.10.1
What's Changed
- Fix for size modifier in getTokenImage()
- Properly return numeric values from JavaScript UDFs
- Update README.md Github introduction to MapTool
- New translations updates
See ChangeLog for v1.10.1 for more details and links to individual issues.
Feature release for MapTool 1.10.0
Highlights
- Significantly reduced startup time for MapTool with a large asset cache under Windows.
- User database with encrypted passwords and public key support for logging in to MapTool servers plus macro functions for accessing database.
- WebRTC supported for connecting to servers without using port-forwarding.
- More support for JavaScript through GraalVM-JS.
- Access HTML/CSS/JS content on lib:tokens via URI from dialogs/frames/overlays plus new macro functions to open dialogs/frames/overlays using URIs.
- GIF anim support in dialogs, frame5 and overlays.
- More performance improvements for Fog of War handling.
- New macro functions, bug fixes and localization translations.
See ChangeLog for v1.10.0 for more details and links to individual issues.
Platform Notes
We strongly encourage you to use the installer format for your operating system. The JAR file should only by used by advanced users comfortable with installing Java releases. It requires a working Java 16 install with JavaFX on your system in order to use it.
Download one of the assets listed below. Each platform has options for which file to download, as described below.
- Windows: Use either .msi (recommended) or .exe.
- Recommend that previous 1.10 versions be uninstalled prior to installing new one. If you have made modifications to the MapTool.cfg file, make a backup so you can copy your changes into the new config file.
- Do not install over older versions of MapTool.
- We're seeing notes from Windows users that they double-click the icon after installing and no window appears. This seems to be an antivirus issue, so check your AV if you have this problem.
- Linux: Use either .deb or .rpm (depending on which packager your system uses).
- The deb version installs under /opt/maptool/bin as MapTool.
- macOS: Use either .pkg (recommended) 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. See this issue for more details.

Note: Please either remove old version or install into a new directory, do not attempt to overwrite a previous version of MapTool with the new version.
Bug Fix release for MapTool 1.10.1
What's Changed
- Fix for size modifier in getTokenImage()
- Properly return numeric values from JavaScript UDFs
- Update README.md Github introduction to MapTool
- New translations updates
See ChangeLog for v1.10.1 for more details and links to individual issues.
Feature release for MapTool 1.10.0
Highlights
- Significantly reduced startup time for MapTool with a large asset cache under Windows.
- User database with encrypted passwords and public key support for logging in to MapTool servers plus macro functions for accessing database.
- WebRTC supported for connecting to servers without using port-forwarding.
- More support for JavaScript through GraalVM-JS.
- Access HTML/CSS/JS content on lib:tokens via URI from dialogs/frames/overlays plus new macro functions to open dialogs/frames/overlays using URIs.
- GIF anim support in dialogs, frame5 and overlays.
- More performance improvements for Fog of War handling.
- New macro functions, bug fixes and localization translations.
See ChangeLog for v1.10.0 for more details and links to individual issues.
Platform Notes
We strongly encourage you to use the installer format for your operating system. The JAR file should only by used by advanced users comfortable with installing Java releases. It requires a working Java 16 install with JavaFX on your system in order to use it.
Download one of the assets listed below. Each platform has options for which file to download, as described below.
- Windows: Use either .msi (recommended) or .exe.
- Recommend that previous 1.10 versions be uninstalled prior to installing new one. If you have made modifications to the MapTool.cfg file, make a backup so you can copy your changes into the new config file.
- Do not install over older versions of MapTool.
- We're seeing notes from Windows users that they double-click the icon after installing and no window appears. This seems to be an antivirus issue, so check your AV if you have this problem.
- Linux: Use either .deb or .rpm (depending on which packager your system uses).
- The deb version installs under /opt/maptool/bin as MapTool.
- macOS: Use either .pkg (recommended) 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. See this issue for more details.

Feature release for MapTool 1.10.
Highlights
- Significantly reduced startup time for MapTool with a large asset cache under Windows.
- User database with encrypted passwords and public key support for logging in to MapTool servers plus macro functions for accessing database.
- WebRTC supported for connecting to servers without using port-forwarding.
- More support for JavaScript through GraalVM-JS.
- Access HTML/CSS/JS content on lib:tokens via URI from dialogs/frames/overlays plus new macro functions to open dialogs/frames/overlays using URIs.
- GIF anim support in dialogs, frame5 and overlays.
- More performance improvements for Fog of War handling.
- New macro functions, bug fixes and localization translations.
See ChangeLog for v1.10.0 for more details and links to individual issues.
Platform Notes
We strongly encourage you to use the installer format for your operating system. The JAR file should only by used by advanced users comfortable with installing Java releases. It requires a working Java 16 install with JavaFX on your system in order to use it.
Download one of the assets listed below. Each platform has options for which file to download, as described below.
- Windows: Use either .msi (recommended) or .exe.
- Recommend that previous 1.10 versions be uninstalled prior to installing new one. If you have made modifications to the MapTool.cfg file, make a backup so you can copy your changes into the new config file.
- Do not install over older versions of MapTool.
- We're seeing notes from Windows users that they double-click the icon after installing and no window appears. This seems to be an antivirus issue, so check your AV if you have this problem.
- Linux: Use either .deb or .rpm (depending on which packager your system uses).
- The deb version installs under /opt/maptool/bin as MapTool.
- macOS: Use either .pkg (recommended) 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. See this issue for more details.

Bug fix release for MapTool 1.9.
Of particular note are several VBL/MBL performance fixes for complex maps plus a variety of QoL and functionality fixes.
See full ChangeLog for v1.9.3 for more details and links to individual issues.
Platform Notes
We strongly encourage you to use the installer format for your operating system. The JAR file should only by used by advanced users comfortable with installing Java releases. It requires a working Java 16 install with JavaFX on your system in order to use it.
Download one of the assets listed below. Each platform has options for which file to download, as described below.
- Windows: Use either .msi (recommended) or .exe.
- Recommend that previous 1.9 versions be uninstalled prior to installing new one. If you have made modifications to the MapTool.cfg file, make a backup so you can copy your changes into the new config file.
- Do not install over older versions of MapTool.
- We're seeing notes from Windows users that they double-click the icon after installing and no window appears. This seems to be an antivirus issue, so check your AV if you have this problem.
- Linux: Use either .deb or .rpm (depending on which packager your system uses).
- The deb version installs under /opt/maptool/bin as MapTool.
- macOS: Use either .pkg (recommended) 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. See this issue for more details.

Bug fix release. Missed one.
Bug Fixes
- #2749 Macro editor help missing entries for many functions. Most documented functions now have help.
See full ChangeLog for v1.9.0 for more details and links to individual issues.
Platform Notes
We strongly encourage you to use the installer format for your operating system. The JAR file should only by used by advanced users comfortable with installing Java releases. It requires a working Java 16 install with JavaFX on your system in order to use it.
Download one of the assets listed below. Each platform has options for which file to download, as described below.
- Windows: Use either .msi (recommended) or .exe.
- We're seeing notes from Windows users that they double-click the icon after installing and no window appears. This seems to be an antivirus issue, so check your AV if you have this problem.
- Linux: Use either .deb or .rpm (depending on which packager your system uses).
- The deb version installs under /opt/maptool/bin as MapTool.
- macOS: Use either .pkg (recommended) 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. See this issue for more details.