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.13.0, uninstall that first.

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 or .exe.
  • Recommend that previous 1.13.0 versions be uninstalled prior to installing the 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.

Thanks to everyone who contributed and helped with testing.

What's Changed

New Features 🥳

• Upgrade to FlatLaf version 3.1 by @cwisniew in #3944
• Upgrade JavaFX to version 20 by @cwisniew in #3945
• Added dependancy upgrade section to release note by @cwisniew in #3946
• creates function setZoomLock(0/1) - fr#3438 by @Jmr3366 in #3941
• functions- getMoveLock() - setMoveLock(0/1) by @Jmr3366 in #3951
• Show player loading status by @sauliuskarmanovas in #3894
• Feature user definable HTML pop up stat sheet by @cwisniew in #4084
• Add support for map IDs in macro functions by @kwvanderlinde in #4127
• Add a createMap() macro function by @kwvanderlinde in #4128
• Reimplement the add-on dialog so that it follows the selected MT theme. by @cwisniew in #4157
• Add buttons to the add-on dialog to easily copy MT Theme and MT Stat Sheet Theme CSS to the clipboard by @cwisniew in #4156
• Feature addon metadata by @cwisniew in #4167
• Themed CSS updates by @cwisniew in #4173
• Add handlebars helpers for statsheets by @cwisniew in #4188
• Update themed CSS by @cwisniew in #4189
• Add ability to set Token Images, Portraits, and Handouts from addon assets (include copy/create token) by @cwisniew in #4192
• #4207 #4206 Changed the ConnectionInfoDialog to show active interface… by @PeterPeet in #4208
• Stop rendering clear lights by @kwvanderlinde in #4225
• Add display name to token properties by @cwisniew in #4235
• Block loading/saving campaign from/to installation dir by @cwisniew in #4262
• Add macro function getIllumination() by @kwvanderlinde in #4267
• Add move up / move down buttons for token properties by @kwvanderlinde in #4271
• Add slash command macro functions by @cwisniew in #4249
• new functions - getMapVision(), setMapVision("off/day/night") by @Jmr3366 in #4279
• onChangeMap event by @Jmr3366 in #4284
• Add Reverends Stat Sheets by @cwisniew in #4278
• Extended getTokenByID to search other Maps by @ColdAnkles in #4296
• Add Genesys Narrative Dice (incl StarWars) by @cwisniew in #4304 (see https://discord.com/channels/296230822262865920/1148551135301476352/1157248013857734708 for more info)

Performance Improvements 🏎️

• Preallocate buffers for use with LightingComposite.BlenderContext by @kwvanderlinde in #4073
• change network compression from lzma to zstd. by @thelsing in #4083

Bug Fixes 🩹

• Add Missing tool-tips to token topology tab by @Jmr3366 in #3950
• include label in add new token dialog by @Jmr3366 in #3973
• Fix package names by @kwvanderlinde in #3998
• Fix junit test by @cwisniew in #4005
• Correct Diamond VBL Tooltip by @cwisniew in #4029
• Fill the lumens overlay properly by @kwvanderlinde in #4045
• Fixes for Hero Lab tokens by @cwisniew in #4050
• Make almost all of MacroButtonProperties fields non-null by @kwvanderlinde in #4052
• Clean up logging by @kwvanderlinde in #4063
• Fix for error when executing a token macro as a player with the current map not visible by @Kkrafy in #4101
• Fix missing statsheet css values by @cwisniew in #4146
• Check trusted flag against BigDecimal.ZERO instead of casting to int by @kwvanderlinde in #4153
• Handle invalid hex representations of GUIDs by @kwvanderlinde in #4174
• Clear Legacy Statsheet when moving between tokens by @cwisniew in #4177
• Properly sequence response logic for HTML5 XMLHttpResponse to avoid races by @kwvanderlinde in #4197
• Fix array predicates in JSON path filters by @kwvanderlinde in #4199
• Fix errors caused by auras inside solid VBL by @kwvanderlinde in #4204
• fixes for missing scrollbar values in stat sheet CSS by @cwisniew in #4223
• Ensure MacroEditorDialog.callback is not null by @kwvanderlinde in #4239
• Fix for character sheet not being copied with token copy by @cwisniew in #4242
• Attempt to fix overlay flicker by @kwvanderlinde in #4246
• Fix json.* constants to keep a GSON representation by @kwvanderlinde in #4247
• Update to gradle 8.2.1 by @cwisniew in #4252
• Work around the JavaFX NPE bug causing HTML5 listeners to not be called by @kwvanderlinde in #4259
• Fix delete drawing tool to respect the selected layer by @kwvanderlinde in #4263
• Fix double title bars with grouped floating frames by @kwvanderlinde in #4264
• Fix table import/export buttons with classic icons. by @kwvanderlinde in #4269
• Remove child node enumeration when registering HTML5 event listeners by @kwvanderlinde in #4285
• Convert MTScript input numbers and output objects by @fishface60 in #4291
• ignore path not found exception on json.path.put to retain compatability by @cwisniew in #4280
• JS API setProperty() fix. by @ColdAnkles in #4301
• Add zipfs to the jlink package. by @cwisniew in #4308
• Feature devmode by @thelsing in #4311
• fix for statsheet error when renaming property type by @cwisniew in #4309
• fix overeager parser preprocessor by @cwisniew in #4313
• Apply compat fix for json.path.set and json.path.delete as well by @cwisniew in #4317
• Disable developer options by default by @kwvanderlinde in #4329
• Fix for error determining install directory on save/load by @cwisniew in #4331
• Workaround for windows duplicate file issue by @cwisniew in #4337
• Fix For Unable to lo...

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.13.0, uninstall that first.

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 or .exe.
  • Recommend that previous 1.13.0 versions be uninstalled prior to installing the 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.

Known Issue: The building of the arch packages fails during release builds so there is no ZST for 1.14.1. this will be fixed in a later point release

Thanks to everyone who contributed and helped with testing.

What's Changed

New Features 🥳

• Upgrade to FlatLaf version 3.1 by @cwisniew in #3944
• Upgrade JavaFX to version 20 by @cwisniew in #3945
• Added dependancy upgrade section to release note by @cwisniew in #3946
• creates function setZoomLock(0/1) - fr#3438 by @Jmr3366 in #3941
• functions- getMoveLock() - setMoveLock(0/1) by @Jmr3366 in #3951
• Show player loading status by @sauliuskarmanovas in #3894
• Feature user definable HTML pop up stat sheet by @cwisniew in #4084
• Add support for map IDs in macro functions by @kwvanderlinde in #4127
• Add a createMap() macro function by @kwvanderlinde in #4128
• Reimplement the add-on dialog so that it follows the selected MT theme. by @cwisniew in #4157
• Add buttons to the add-on dialog to easily copy MT Theme and MT Stat Sheet Theme CSS to the clipboard by @cwisniew in #4156
• Feature addon metadata by @cwisniew in #4167
• Themed CSS updates by @cwisniew in #4173
• Add handlebars helpers for statsheets by @cwisniew in #4188
• Update themed CSS by @cwisniew in #4189
• Add ability to set Token Images, Portraits, and Handouts from addon assets (include copy/create token) by @cwisniew in #4192
• #4207 #4206 Changed the ConnectionInfoDialog to show active interface… by @PeterPeet in #4208
• Stop rendering clear lights by @kwvanderlinde in #4225
• Add display name to token properties by @cwisniew in #4235
• Block loading/saving campaign from/to installation dir by @cwisniew in #4262
• Add macro function getIllumination() by @kwvanderlinde in #4267
• Add move up / move down buttons for token properties by @kwvanderlinde in #4271
• Add slash command macro functions by @cwisniew in #4249
• new functions - getMapVision(), setMapVision("off/day/night") by @Jmr3366 in #4279
• onChangeMap event by @Jmr3366 in #4284
• Add Reverends Stat Sheets by @cwisniew in #4278
• Extended getTokenByID to search other Maps by @ColdAnkles in #4296
• Add Genesys Narrative Dice (incl StarWars) by @cwisniew in #4304

Performance Improvements 🏎️

• Preallocate buffers for use with LightingComposite.BlenderContext by @kwvanderlinde in #4073
• change network compression from lzma to zstd. by @thelsing in #4083

Bug Fixes 🩹

• Add Missing tool-tips to token topology tab by @Jmr3366 in #3950
• include label in add new token dialog by @Jmr3366 in #3973
• Fix package names by @kwvanderlinde in #3998
• Fix junit test by @cwisniew in #4005
• Correct Diamond VBL Tooltip by @cwisniew in #4029
• Fill the lumens overlay properly by @kwvanderlinde in #4045
• Fixes for Hero Lab tokens by @cwisniew in #4050
• Make almost all of MacroButtonProperties fields non-null by @kwvanderlinde in #4052
• Clean up logging by @kwvanderlinde in #4063
• Fix for error when executing a token macro as a player with the current map not visible by @Kkrafy in #4101
• Fix missing statsheet css values by @cwisniew in #4146
• Check trusted flag against BigDecimal.ZERO instead of casting to int by @kwvanderlinde in #4153
• Handle invalid hex representations of GUIDs by @kwvanderlinde in #4174
• Clear Legacy Statsheet when moving between tokens by @cwisniew in #4177
• Properly sequence response logic for HTML5 XMLHttpResponse to avoid races by @kwvanderlinde in #4197
• Fix array predicates in JSON path filters by @kwvanderlinde in #4199
• Fix errors caused by auras inside solid VBL by @kwvanderlinde in #4204
• fixes for missing scrollbar values in stat sheet CSS by @cwisniew in #4223
• Ensure MacroEditorDialog.callback is not null by @kwvanderlinde in #4239
• Fix for character sheet not being copied with token copy by @cwisniew in #4242
• Attempt to fix overlay flicker by @kwvanderlinde in #4246
• Fix json.* constants to keep a GSON representation by @kwvanderlinde in #4247
• Update to gradle 8.2.1 by @cwisniew in #4252
• Work around the JavaFX NPE bug causing HTML5 listeners to not be called by @kwvanderlinde in #4259
• Fix delete drawing tool to respect the selected layer by @kwvanderlinde in #4263
• Fix double title bars with grouped floating frames by @kwvanderlinde in #4264
• Fix table import/export buttons with classic icons. by @kwvanderlinde in #4269
• Remove child node enumeration when registering HTML5 event listeners by @kwvanderlinde in #4285
• Convert MTScript input numbers and output objects by @fishface60 in #4291
• ignore path not found exception on json.path.put to retain compatability by @cwisniew in #4280
• JS API setProperty() fix. by @ColdAnkles in #4301
• Add zipfs to the jlink package. by @cwisniew in #4308
• Feature devmode by @thelsing in #4311
• fix for statsheet error when renaming property type by @cwisniew in #4309
• fix overeager parser preprocessor by @cwisniew in #4313
• Apply compat fix for json.path.set and json.path.delete as well by @cwisniew in #4317
• Disable developer options by default by @kwvanderlinde in #4329
• Fix for error determining install directory on save/load by @cwisniew in https://github.com/RPTools/maptool/...

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.13.0, uninstall that first.

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 or .exe.
  • Recommend that previous 1.13.0 versions be uninstalled prior to installing the 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.

Thanks to everyone who contributed and helped with testing.

What's Changed

New Features 🥳

• Upgrade to FlatLaf version 3.1 by @cwisniew in #3944
• Upgrade JavaFX to version 20 by @cwisniew in #3945
• Added dependancy upgrade section to release note by @cwisniew in #3946
• creates function setZoomLock(0/1) - fr#3438 by @Jmr3366 in #3941
• functions- getMoveLock() - setMoveLock(0/1) by @Jmr3366 in #3951
• Show player loading status by @sauliuskarmanovas in #3894
• Feature user definable HTML pop up stat sheet by @cwisniew in #4084
• Add support for map IDs in macro functions by @kwvanderlinde in #4127
• Add a createMap() macro function by @kwvanderlinde in #4128
• Reimplement the add-on dialog so that it follows the selected MT theme. by @cwisniew in #4157
• Add buttons to the add-on dialog to easily copy MT Theme and MT Stat Sheet Theme CSS to the clipboard by @cwisniew in #4156
• Feature addon metadata by @cwisniew in #4167
• Themed CSS updates by @cwisniew in #4173
• Add handlebars helpers for statsheets by @cwisniew in #4188
• Update themed CSS by @cwisniew in #4189
• Add ability to set Token Images, Portraits, and Handouts from addon assets (include copy/create token) by @cwisniew in #4192
• #4207 #4206 Changed the ConnectionInfoDialog to show active interface… by @PeterPeet in #4208
• Stop rendering clear lights by @kwvanderlinde in #4225
• Add display name to token properties by @cwisniew in #4235
• Block loading/saving campaign from/to installation dir by @cwisniew in #4262
• Add macro function getIllumination() by @kwvanderlinde in #4267
• Add move up / move down buttons for token properties by @kwvanderlinde in #4271
• Add slash command macro functions by @cwisniew in #4249
• new functions - getMapVision(), setMapVision("off/day/night") by @Jmr3366 in #4279
• onChangeMap event by @Jmr3366 in #4284
• Add Reverends Stat Sheets by @cwisniew in #4278
• Extended getTokenByID to search other Maps by @ColdAnkles in #4296
• Add Genesys Narrative Dice (incl StarWars) by @cwisniew in #4304

Performance Improvements 🏎️

• Preallocate buffers for use with LightingComposite.BlenderContext by @kwvanderlinde in #4073
• change network compression from lzma to zstd. by @thelsing in #4083

Bug Fixes 🩹

• Add Missing tool-tips to token topology tab by @Jmr3366 in #3950
• include label in add new token dialog by @Jmr3366 in #3973
• Fix package names by @kwvanderlinde in #3998
• Fix junit test by @cwisniew in #4005
• Correct Diamond VBL Tooltip by @cwisniew in #4029
• Fill the lumens overlay properly by @kwvanderlinde in #4045
• Fixes for Hero Lab tokens by @cwisniew in #4050
• Make almost all of MacroButtonProperties fields non-null by @kwvanderlinde in #4052
• Clean up logging by @kwvanderlinde in #4063
• Fix for error when executing a token macro as a player with the current map not visible by @Kkrafy in #4101
• Fix missing statsheet css values by @cwisniew in #4146
• Check trusted flag against BigDecimal.ZERO instead of casting to int by @kwvanderlinde in #4153
• Handle invalid hex representations of GUIDs by @kwvanderlinde in #4174
• Clear Legacy Statsheet when moving between tokens by @cwisniew in #4177
• Properly sequence response logic for HTML5 XMLHttpResponse to avoid races by @kwvanderlinde in #4197
• Fix array predicates in JSON path filters by @kwvanderlinde in #4199
• Fix errors caused by auras inside solid VBL by @kwvanderlinde in #4204
• fixes for missing scrollbar values in stat sheet CSS by @cwisniew in #4223
• Ensure MacroEditorDialog.callback is not null by @kwvanderlinde in #4239
• Fix for character sheet not being copied with token copy by @cwisniew in #4242
• Attempt to fix overlay flicker by @kwvanderlinde in #4246
• Fix json.* constants to keep a GSON representation by @kwvanderlinde in #4247
• Update to gradle 8.2.1 by @cwisniew in #4252
• Work around the JavaFX NPE bug causing HTML5 listeners to not be called by @kwvanderlinde in #4259
• Fix delete drawing tool to respect the selected layer by @kwvanderlinde in #4263
• Fix double title bars with grouped floating frames by @kwvanderlinde in #4264
• Fix table import/export buttons with classic icons. by @kwvanderlinde in #4269
• Remove child node enumeration when registering HTML5 event listeners by @kwvanderlinde in #4285
• Convert MTScript input numbers and output objects by @fishface60 in #4291
• ignore path not found exception on json.path.put to retain compatability by @cwisniew in #4280
• JS API setProperty() fix. by @ColdAnkles in #4301
• Add zipfs to the jlink package. by @cwisniew in #4308
• Feature devmode by @thelsing in #4311
• fix for statsheet error when renaming property type by @cwisniew in #4309
• fix overeager parser preprocessor by @cwisniew in #4313
• Apply compat fix for json.path.set and json.path.delete as well by @cwisniew in #4317
• Disable developer options by default by @kwvanderlinde in #4329
• Fix for error determining install directory on save/load by @cwisniew in #4331
• Workaround for windows duplicate file issue by @cwisniew in #4337
• Fix For Unable to load/save campa...

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.13.0, uninstall that first.

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 or .exe.
  • Recommend that previous 1.13.0 versions be uninstalled prior to installing the 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.

Thanks to everyone who contributed and helped with testing.

What's Changed

New Features 🥳

• Upgrade to FlatLaf version 3.1 by @cwisniew in #3944
• Upgrade JavaFX to version 20 by @cwisniew in #3945
• Added dependancy upgrade section to release note by @cwisniew in #3946
• creates function setZoomLock(0/1) - fr#3438 by @Jmr3366 in #3941
• functions- getMoveLock() - setMoveLock(0/1) by @Jmr3366 in #3951
• Show player loading status by @sauliuskarmanovas in #3894
• Feature user definable HTML pop up stat sheet by @cwisniew in #4084
• Add support for map IDs in macro functions by @kwvanderlinde in #4127
• Add a createMap() macro function by @kwvanderlinde in #4128
• Reimplement the add-on dialog so that it follows the selected MT theme. by @cwisniew in #4157
• Add buttons to the add-on dialog to easily copy MT Theme and MT Stat Sheet Theme CSS to the clipboard by @cwisniew in #4156
• Feature addon metadata by @cwisniew in #4167
• Themed CSS updates by @cwisniew in #4173
• Add handlebars helpers for statsheets by @cwisniew in #4188
• Update themed CSS by @cwisniew in #4189
• Add ability to set Token Images, Portraits, and Handouts from addon assets (include copy/create token) by @cwisniew in #4192
• #4207 #4206 Changed the ConnectionInfoDialog to show active interface… by @PeterPeet in #4208
• Stop rendering clear lights by @kwvanderlinde in #4225
• Add display name to token properties by @cwisniew in #4235
• Block loading/saving campaign from/to installation dir by @cwisniew in #4262
• Add macro function getIllumination() by @kwvanderlinde in #4267
• Add move up / move down buttons for token properties by @kwvanderlinde in #4271
• Add slash command macro functions by @cwisniew in #4249
• new functions - getMapVision(), setMapVision("off/day/night") by @Jmr3366 in #4279
• onChangeMap event by @Jmr3366 in #4284
• Add Reverends Stat Sheets by @cwisniew in #4278
• Extended getTokenByID to search other Maps by @ColdAnkles in #4296
• Add Genesys Narrative Dice (incl StarWars) by @cwisniew in #4304

Performance Improvements 🏎️

• Preallocate buffers for use with LightingComposite.BlenderContext by @kwvanderlinde in #4073
• change network compression from lzma to zstd. by @thelsing in #4083

Bug Fixes 🩹

• Add Missing tool-tips to token topology tab by @Jmr3366 in #3950
• include label in add new token dialog by @Jmr3366 in #3973
• Fix package names by @kwvanderlinde in #3998
• Fix junit test by @cwisniew in #4005
• Correct Diamond VBL Tooltip by @cwisniew in #4029
• Fill the lumens overlay properly by @kwvanderlinde in #4045
• Fixes for Hero Lab tokens by @cwisniew in #4050
• Make almost all of MacroButtonProperties fields non-null by @kwvanderlinde in #4052
• Clean up logging by @kwvanderlinde in #4063
• Fix for error when executing a token macro as a player with the current map not visible by @Kkrafy in #4101
• Fix missing statsheet css values by @cwisniew in #4146
• Check trusted flag against BigDecimal.ZERO instead of casting to int by @kwvanderlinde in #4153
• Handle invalid hex representations of GUIDs by @kwvanderlinde in #4174
• Clear Legacy Statsheet when moving between tokens by @cwisniew in #4177
• Properly sequence response logic for HTML5 XMLHttpResponse to avoid races by @kwvanderlinde in #4197
• Fix array predicates in JSON path filters by @kwvanderlinde in #4199
• Fix errors caused by auras inside solid VBL by @kwvanderlinde in #4204
• fixes for missing scrollbar values in stat sheet CSS by @cwisniew in #4223
• Ensure MacroEditorDialog.callback is not null by @kwvanderlinde in #4239
• Fix for character sheet not being copied with token copy by @cwisniew in #4242
• Attempt to fix overlay flicker by @kwvanderlinde in #4246
• Fix json.* constants to keep a GSON representation by @kwvanderlinde in #4247
• Update to gradle 8.2.1 by @cwisniew in #4252
• Work around the JavaFX NPE bug causing HTML5 listeners to not be called by @kwvanderlinde in #4259
• Fix delete drawing tool to respect the selected layer by @kwvanderlinde in #4263
• Fix double title bars with grouped floating frames by @kwvanderlinde in #4264
• Fix table import/export buttons with classic icons. by @kwvanderlinde in #4269
• Remove child node enumeration when registering HTML5 event listeners by @kwvanderlinde in #4285
• Convert MTScript input numbers and output objects by @fishface60 in #4291
• ignore path not found exception on json.path.put to retain compatability by @cwisniew in #4280
• JS API setProperty() fix. by @ColdAnkles in #4301
• Add zipfs to the jlink package. by @cwisniew in #4308
• Feature devmode by @thelsing in #4311
• fix for statsheet error when renaming property type by @cwisniew in #4309
• fix overeager parser preprocessor by @cwisniew in #4313
• Apply compat fix for json.path.set and json.path.delete as well by @cwisniew in #4317
• Disable developer options by default by @kwvanderlinde in #4329
• Fix for error determining install directory on save/load by @cwisniew in #4331
• Workaround for windows duplicate file issue by @cwisniew in #4337
• Fix For Unable to load/save campaig...

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.13.0, uninstall that first.

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 or .exe.
  • Recommend that previous 1.13.0 versions be uninstalled prior to installing the 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.

What's Changed

New Features 🥳

• Upgrade to FlatLaf version 3.1 by @cwisniew in #3944
• Upgrade JavaFX to version 20 by @cwisniew in #3945
• Added dependancy upgrade section to release note by @cwisniew in #3946
• creates function setZoomLock(0/1) - fr#3438 by @Jmr3366 in #3941
• functions- getMoveLock() - setMoveLock(0/1) by @Jmr3366 in #3951
• Show player loading status by @sauliuskarmanovas in #3894
• Preallocate buffers for use with LightingComposite.BlenderContext by @kwvanderlinde in #4073
• Feature user definable HTML pop up stat sheet by @cwisniew in #4084
• Add support for map IDs in macro functions by @kwvanderlinde in #4127
• Add a createMap() macro function by @kwvanderlinde in #4128
• Reimplement the add-on dialog so that it follows the selected MT theme. by @cwisniew in #4157
• Add buttons to the add-on dialog to easily copy MT Theme and MT Stat Sheet Theme CSS to the clipboard by @cwisniew in #4156
• Feature addon metadata by @cwisniew in #4167
• Themed CSS updates by @cwisniew in #4173
• Add handlebars helpers for statsheets by @cwisniew in #4188
• Update themed CSS by @cwisniew in #4189
• Add ability to set Token Images, Portraits, and Handouts from addon assets (include copy/create token) by @cwisniew in #4192
• #4207 #4206 Changed the ConnectionInfoDialog to show active interface… by @PeterPeet in #4208
• Stop rendering clear lights by @kwvanderlinde in #4225
• Add display name to token properties by @cwisniew in #4235
• Block loading/saving campaign from/to installation dir by @cwisniew in #4262
• Add macro function getIllumination() by @kwvanderlinde in #4267
• Add move up / move down buttons for token properties by @kwvanderlinde in #4271
• Add slash command macro functions by @cwisniew in #4249
• new functions - getMapVision(), setMapVision("off/day/night") by @Jmr3366 in #4279
• Add Reverends Stat Sheets by @cwisniew in #4278
• Extended getTokenByID to search other Maps by @ColdAnkles in #4296
• Add Genesys Narrative Dice (incl StarWars) by @cwisniew in #4304

Performance Improvements 🏎️

• change network compression from lzma to zstd. by @thelsing in #4083

Bug Fixes 🩹

• Add Missing tool-tips to token topology tab by @Jmr3366 in #3950
• include label in add new token dialog by @Jmr3366 in #3973
• Fix package names by @kwvanderlinde in #3998
• Fix junit test by @cwisniew in #4005
• Correct Diamond VBL Tooltip by @cwisniew in #4029
• Fill the lumens overlay properly by @kwvanderlinde in #4045
• Fixes for Hero Lab tokens by @cwisniew in #4050
• Make almost all of MacroButtonProperties fields non-null by @kwvanderlinde in #4052
• Clean up logging by @kwvanderlinde in #4063
• Fix for error when executing a token macro as a player with the current map not visible by @Kkrafy in #4101
• Fix missing statsheet css values by @cwisniew in #4146
• Check trusted flag against BigDecimal.ZERO instead of casting to int by @kwvanderlinde in #4153
• Handle invalid hex representations of GUIDs by @kwvanderlinde in #4174
• Clear Legacy Statsheet when moving between tokens by @cwisniew in #4177
• Properly sequence response logic for HTML5 XMLHttpResponse to avoid races by @kwvanderlinde in #4197
• Fix array predicates in JSON path filters by @kwvanderlinde in #4199
• Fix errors caused by auras inside solid VBL by @kwvanderlinde in #4204
• fixes for missing scrollbar values in stat sheet CSS by @cwisniew in #4223
• Ensure MacroEditorDialog.callback is not null by @kwvanderlinde in #4239
• Fix for character sheet not being copied with token copy by @cwisniew in #4242
• Attempt to fix overlay flicker by @kwvanderlinde in #4246
• Fix json.* constants to keep a GSON representation by @kwvanderlinde in #4247
• Update to gradle 8.2.1 by @cwisniew in #4252
• Work around the JavaFX NPE bug causing HTML5 listeners to not be called by @kwvanderlinde in #4259
• Fix delete drawing tool to respect the selected layer by @kwvanderlinde in #4263
• Fix double title bars with grouped floating frames by @kwvanderlinde in #4264
• Fix table import/export buttons with classic icons. by @kwvanderlinde in #4269
• Remove child node enumeration when registering HTML5 event listeners by @kwvanderlinde in #4285
• Convert MTScript input numbers and output objects by @fishface60 in #4291
• ignore path not found exception on json.path.put to retain compatability by @cwisniew in #4280
• JS API setProperty() fix. by @ColdAnkles in #4301
• Add zipfs to the jlink package. by @cwisniew in #4308
• Feature devmode by @thelsing in #4311
• fix for statsheet error when renaming property type by @cwisniew in #4309
• fix overeager parser preprocessor by @cwisniew in #4313
• Apply compat fix for json.path.set and json.path.delete as well by @cwisniew in #4317
• Disable developer options by default by @kwvanderlinde in #4329
• Fix for error determining install directory on save/load by @cwisniew in #4331
• Workaround for windows duplicate file issue by @cwisniew in #4337

Code Maintenance 🔧

• Merge Dicelib code into MapTool Repo by @cwisniew in #4000
• Fix some stutters when dragging maps by @kwvanderlinde in #4003
• Remove campaign export and all related co...

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.13.0, uninstall that first.

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 or .exe.
  • Recommend that previous 1.13.0 versions be uninstalled prior to installing the 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.

What's Changed

New Features 🥳

• Upgrade to FlatLaf version 3.1 by @cwisniew in #3944
• Upgrade JavaFX to version 20 by @cwisniew in #3945
• Added dependancy upgrade section to release note by @cwisniew in #3946
• creates function setZoomLock(0/1) - fr#3438 by @Jmr3366 in #3941
• functions- getMoveLock() - setMoveLock(0/1) by @Jmr3366 in #3951
• Show player loading status by @sauliuskarmanovas in #3894
• Preallocate buffers for use with LightingComposite.BlenderContext by @kwvanderlinde in #4073
• Feature user definable HTML pop up stat sheet by @cwisniew in #4084
• Add support for map IDs in macro functions by @kwvanderlinde in #4127
• Add a createMap() macro function by @kwvanderlinde in #4128
• Reimplement the add-on dialog so that it follows the selected MT theme. by @cwisniew in #4157
• Add buttons to the add-on dialog to easily copy MT Theme and MT Stat Sheet Theme CSS to the clipboard by @cwisniew in #4156
• Feature addon metadata by @cwisniew in #4167
• Themed CSS updates by @cwisniew in #4173
• Add handlebars helpers for statsheets by @cwisniew in #4188
• Update themed CSS by @cwisniew in #4189
• Add ability to set Token Images, Portraits, and Handouts from addon assets (include copy/create token) by @cwisniew in #4192
• #4207 #4206 Changed the ConnectionInfoDialog to show active interface… by @PeterPeet in #4208
• Stop rendering clear lights by @kwvanderlinde in #4225
• Add display name to token properties by @cwisniew in #4235
• Block loading/saving campaign from/to installation dir by @cwisniew in #4262
• Add macro function getIllumination() by @kwvanderlinde in #4267
• Add move up / move down buttons for token properties by @kwvanderlinde in #4271
• Add slash command macro functions by @cwisniew in #4249
• new functions - getMapVision(), setMapVision("off/day/night") by @Jmr3366 in #4279
• Add Reverends Stat Sheets by @cwisniew in #4278
• Extended getTokenByID to search other Maps by @ColdAnkles in #4296
• Add Genesys Narrative Dice (incl StarWars) by @cwisniew in #4304

Performance Improvements 🏎️

• change network compression from lzma to zstd. by @thelsing in #4083

Bug Fixes 🩹

• Add Missing tool-tips to token topology tab by @Jmr3366 in #3950
• include label in add new token dialog by @Jmr3366 in #3973
• Fix package names by @kwvanderlinde in #3998
• Fix junit test by @cwisniew in #4005
• Correct Diamond VBL Tooltip by @cwisniew in #4029
• Fill the lumens overlay properly by @kwvanderlinde in #4045
• Fixes for Hero Lab tokens by @cwisniew in #4050
• Make almost all of MacroButtonProperties fields non-null by @kwvanderlinde in #4052
• Clean up logging by @kwvanderlinde in #4063
• Fix for error when executing a token macro as a player with the current map not visible by @Kkrafy in #4101
• Fix missing statsheet css values by @cwisniew in #4146
• Check trusted flag against BigDecimal.ZERO instead of casting to int by @kwvanderlinde in #4153
• Handle invalid hex representations of GUIDs by @kwvanderlinde in #4174
• Clear Legacy Statsheet when moving between tokens by @cwisniew in #4177
• Properly sequence response logic for HTML5 XMLHttpResponse to avoid races by @kwvanderlinde in #4197
• Fix array predicates in JSON path filters by @kwvanderlinde in #4199
• Fix errors caused by auras inside solid VBL by @kwvanderlinde in #4204
• fixes for missing scrollbar values in stat sheet CSS by @cwisniew in #4223
• Ensure MacroEditorDialog.callback is not null by @kwvanderlinde in #4239
• Fix for character sheet not being copied with token copy by @cwisniew in #4242
• Attempt to fix overlay flicker by @kwvanderlinde in #4246
• Fix json.* constants to keep a GSON representation by @kwvanderlinde in #4247
• Update to gradle 8.2.1 by @cwisniew in #4252
• Work around the JavaFX NPE bug causing HTML5 listeners to not be called by @kwvanderlinde in #4259
• Fix delete drawing tool to respect the selected layer by @kwvanderlinde in #4263
• Fix double title bars with grouped floating frames by @kwvanderlinde in #4264
• Fix table import/export buttons with classic icons. by @kwvanderlinde in #4269
• Remove child node enumeration when registering HTML5 event listeners by @kwvanderlinde in #4285
• Convert MTScript input numbers and output objects by @fishface60 in #4291
• ignore path not found exception on json.path.put to retain compatability by @cwisniew in #4280
• JS API setProperty() fix. by @ColdAnkles in #4301
• Add zipfs to the jlink package. by @cwisniew in #4308
• Feature devmode by @thelsing in #4311
• fix for statsheet error when renaming property type by @cwisniew in #4309
• fix overeager parser preprocessor by @cwisniew in #4313
• Apply compat fix for json.path.set and json.path.delete as well by @cwisniew in #4317
• Disable developer options by default by @kwvanderlinde in #4329
• Fix for error determining install directory on save/load by @cwisniew in #4331

Code Maintenance 🔧

• Merge Dicelib code into MapTool Repo by @cwisniew in #4000
• Fix some stutters when dragging maps by @kwvanderlinde in #4003
• Remove campaign export and all related code by @kwvanderlinde in #4065
• Make XStream more agreeable, and oth...

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.13.0, uninstall that first.

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 or .exe.
  • Recommend that previous 1.13.0 versions be uninstalled prior to installing the 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.

What's Changed

New Features 🥳

• Upgrade to FlatLaf version 3.1 by @cwisniew in #3944
• Upgrade JavaFX to version 20 by @cwisniew in #3945
• Added dependancy upgrade section to release note by @cwisniew in #3946
• creates function setZoomLock(0/1) - fr#3438 by @Jmr3366 in #3941
• functions- getMoveLock() - setMoveLock(0/1) by @Jmr3366 in #3951
• Show player loading status by @sauliuskarmanovas in #3894
• Preallocate buffers for use with LightingComposite.BlenderContext by @kwvanderlinde in #4073
• Feature user definable HTML pop up stat sheet by @cwisniew in #4084
• Add support for map IDs in macro functions by @kwvanderlinde in #4127
• Add a createMap() macro function by @kwvanderlinde in #4128
• Reimplement the add-on dialog so that it follows the selected MT theme. by @cwisniew in #4157
• Add buttons to the add-on dialog to easily copy MT Theme and MT Stat Sheet Theme CSS to the clipboard by @cwisniew in #4156
• Feature addon metadata by @cwisniew in #4167
• Themed CSS updates by @cwisniew in #4173
• Add handlebars helpers for statsheets by @cwisniew in #4188
• Update themed CSS by @cwisniew in #4189
• Add ability to set Token Images, Portraits, and Handouts from addon assets (include copy/create token) by @cwisniew in #4192
• #4207 #4206 Changed the ConnectionInfoDialog to show active interface… by @PeterPeet in #4208
• Stop rendering clear lights by @kwvanderlinde in #4225
• Add display name to token properties by @cwisniew in #4235
• Block loading/saving campaign from/to installation dir by @cwisniew in #4262
• Add macro function getIllumination() by @kwvanderlinde in #4267
• Add move up / move down buttons for token properties by @kwvanderlinde in #4271
• Add slash command macro functions by @cwisniew in #4249
• new functions - getMapVision(), setMapVision("off/day/night") by @Jmr3366 in #4279
• Add Reverends Stat Sheets by @cwisniew in #4278
• Extended getTokenByID to search other Maps by @ColdAnkles in #4296
• Add Genesys Narrative Dice (incl StarWars) by @cwisniew in #4304

Performance Improvements 🏎️

• change network compression from lzma to zstd. by @thelsing in #4083

Bug Fixes 🩹

• Add Missing tool-tips to token topology tab by @Jmr3366 in #3950
• include label in add new token dialog by @Jmr3366 in #3973
• Fix package names by @kwvanderlinde in #3998
• Fix junit test by @cwisniew in #4005
• Correct Diamond VBL Tooltip by @cwisniew in #4029
• Fill the lumens overlay properly by @kwvanderlinde in #4045
• Fixes for Hero Lab tokens by @cwisniew in #4050
• Make almost all of MacroButtonProperties fields non-null by @kwvanderlinde in #4052
• Clean up logging by @kwvanderlinde in #4063
• Fix for error when executing a token macro as a player with the current map not visible by @Kkrafy in #4101
• Fix missing statsheet css values by @cwisniew in #4146
• Check trusted flag against BigDecimal.ZERO instead of casting to int by @kwvanderlinde in #4153
• Handle invalid hex representations of GUIDs by @kwvanderlinde in #4174
• Clear Legacy Statsheet when moving between tokens by @cwisniew in #4177
• Properly sequence response logic for HTML5 XMLHttpResponse to avoid races by @kwvanderlinde in #4197
• Fix array predicates in JSON path filters by @kwvanderlinde in #4199
• Fix errors caused by auras inside solid VBL by @kwvanderlinde in #4204
• fixes for missing scrollbar values in stat sheet CSS by @cwisniew in #4223
• Ensure MacroEditorDialog.callback is not null by @kwvanderlinde in #4239
• Fix for character sheet not being copied with token copy by @cwisniew in #4242
• Attempt to fix overlay flicker by @kwvanderlinde in #4246
• Fix json.* constants to keep a GSON representation by @kwvanderlinde in #4247
• Update to gradle 8.2.1 by @cwisniew in #4252
• Work around the JavaFX NPE bug causing HTML5 listeners to not be called by @kwvanderlinde in #4259
• Fix delete drawing tool to respect the selected layer by @kwvanderlinde in #4263
• Fix double title bars with grouped floating frames by @kwvanderlinde in #4264
• Fix table import/export buttons with classic icons. by @kwvanderlinde in #4269
• Remove child node enumeration when registering HTML5 event listeners by @kwvanderlinde in #4285
• Convert MTScript input numbers and output objects by @fishface60 in #4291
• ignore path not found exception on json.path.put to retain compatability by @cwisniew in #4280
• JS API setProperty() fix. by @ColdAnkles in #4301
• Add zipfs to the jlink package. by @cwisniew in #4308
• Feature devmode by @thelsing in #4311
• fix for statsheet error when renaming property type by @cwisniew in #4309
• fix overeager parser preprocessor by @cwisniew in #4313

Code Maintenance 🔧

• Merge Dicelib code into MapTool Repo by @cwisniew in #4000
• Fix some stutters when dragging maps by @kwvanderlinde in #4003
• Remove campaign export and all related code by @kwvanderlinde in #4065
• Make XStream more agreeable, and other fixes by @kwvanderlinde in #4067
• Separate ServerConnection and ClientConnection by @kwvanderlinde in #4078
• Ensure PackedFile is always closed and remove PackedFile.finalize() by @kwvanderlinde in #4226
• Stop the gradle daemon aft...

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.13.0, uninstall that first.

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 or .exe.
  • Recommend that previous 1.13.0 versions be uninstalled prior to installing the 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.

What's Changed

New Features 🥳

• Upgrade to FlatLaf version 3.1 by @cwisniew in #3944
• Upgrade JavaFX to version 20 by @cwisniew in #3945
• Added dependancy upgrade section to release note by @cwisniew in #3946
• creates function setZoomLock(0/1) - fr#3438 by @Jmr3366 in #3941
• functions- getMoveLock() - setMoveLock(0/1) by @Jmr3366 in #3951
• Show player loading status by @sauliuskarmanovas in #3894
• Preallocate buffers for use with LightingComposite.BlenderContext by @kwvanderlinde in #4073
• Feature user definable HTML pop up stat sheet by @cwisniew in #4084
• Add support for map IDs in macro functions by @kwvanderlinde in #4127
• Add a createMap() macro function by @kwvanderlinde in #4128
• Reimplement the add-on dialog so that it follows the selected MT theme. by @cwisniew in #4157
• Add buttons to the add-on dialog to easily copy MT Theme and MT Stat Sheet Theme CSS to the clipboard by @cwisniew in #4156
• Feature addon metadata by @cwisniew in #4167
• Themed CSS updates by @cwisniew in #4173
• Add handlebars helpers for statsheets by @cwisniew in #4188
• Update themed CSS by @cwisniew in #4189
• Add ability to set Token Images, Portraits, and Handouts from addon assets (include copy/create token) by @cwisniew in #4192
• #4207 #4206 Changed the ConnectionInfoDialog to show active interface… by @PeterPeet in #4208
• Stop rendering clear lights by @kwvanderlinde in #4225
• Add display name to token properties by @cwisniew in #4235
• Block loading/saving campaign from/to installation dir by @cwisniew in #4262
• Add macro function getIllumination() by @kwvanderlinde in #4267
• Add move up / move down buttons for token properties by @kwvanderlinde in #4271
• Add slash command macro functions by @cwisniew in #4249
• new functions - getMapVision(), setMapVision("off/day/night") by @Jmr3366 in #4279
• Add Reverends Stat Sheets by @cwisniew in #4278
• Extended getTokenByID to search other Maps by @ColdAnkles in #4296
• Add Genesys Narrative Dice (incl StarWars) by @cwisniew in #4304

Performance Improvements 🏎️

• change network compression from lzma to zstd. by @thelsing in #4083

Bug Fixes 🩹

• Add Missing tool-tips to token topology tab by @Jmr3366 in #3950
• include label in add new token dialog by @Jmr3366 in #3973
• Fix package names by @kwvanderlinde in #3998
• Fix junit test by @cwisniew in #4005
• Correct Diamond VBL Tooltip by @cwisniew in #4029
• Fill the lumens overlay properly by @kwvanderlinde in #4045
• Fixes for Hero Lab tokens by @cwisniew in #4050
• Make almost all of MacroButtonProperties fields non-null by @kwvanderlinde in #4052
• Clean up logging by @kwvanderlinde in #4063
• Fix for error when executing a token macro as a player with the current map not visible by @Kkrafy in #4101
• Fix missing statsheet css values by @cwisniew in #4146
• Check trusted flag against BigDecimal.ZERO instead of casting to int by @kwvanderlinde in #4153
• Handle invalid hex representations of GUIDs by @kwvanderlinde in #4174
• Clear Legacy Statsheet when moving between tokens by @cwisniew in #4177
• Properly sequence response logic for HTML5 XMLHttpResponse to avoid races by @kwvanderlinde in #4197
• Fix array predicates in JSON path filters by @kwvanderlinde in #4199
• Fix errors caused by auras inside solid VBL by @kwvanderlinde in #4204
• fixes for missing scrollbar values in stat sheet CSS by @cwisniew in #4223
• Ensure MacroEditorDialog.callback is not null by @kwvanderlinde in #4239
• Fix for character sheet not being copied with token copy by @cwisniew in #4242
• Attempt to fix overlay flicker by @kwvanderlinde in #4246
• Fix json.* constants to keep a GSON representation by @kwvanderlinde in #4247
• Update to gradle 8.2.1 by @cwisniew in #4252
• Work around the JavaFX NPE bug causing HTML5 listeners to not be called by @kwvanderlinde in #4259
• Fix delete drawing tool to respect the selected layer by @kwvanderlinde in #4263
• Fix double title bars with grouped floating frames by @kwvanderlinde in #4264
• Fix table import/export buttons with classic icons. by @kwvanderlinde in #4269
• Remove child node enumeration when registering HTML5 event listeners by @kwvanderlinde in #4285
• Convert MTScript input numbers and output objects by @fishface60 in #4291
• ignore path not found exception on json.path.put to retain compatability by @cwisniew in #4280
• JS API setProperty() fix. by @ColdAnkles in #4301

Code Maintenance 🔧

• Merge Dicelib code into MapTool Repo by @cwisniew in #4000
• Fix some stutters when dragging maps by @kwvanderlinde in #4003
• Remove campaign export and all related code by @kwvanderlinde in #4065
• Make XStream more agreeable, and other fixes by @kwvanderlinde in #4067
• Separate ServerConnection and ClientConnection by @kwvanderlinde in #4078
• Ensure PackedFile is always closed and remove PackedFile.finalize() by @kwvanderlinde in #4226
• Stop the gradle daemon after the build task during verification by @kwvanderlinde in #4261

Dependency Updates

• Bump org.mockito:mockito-core from 3.11.2 to 5.3.0 by @dependabot in #3917
• Bump com.jayway.jsonpath:json-path from 2.6.0 to 2.8.0 by @dependabot in #3897
• Bump guava from 31....

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.13.0, uninstall that first.

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 or .exe.
  • Recommend that previous 1.13.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.

What's Changed 1.14.0-alpha.3

New Features 🥳

• #4207 #4206 Changed the ConnectionInfoDialog to show active interface… by @PeterPeet in #4208

Bug Fixes 🩹

• Properly sequence response logic for HTML5 XMLHttpResponse to avoid races by @kwvanderlinde in #4197
• Fix array predicates in JSON path filters by @kwvanderlinde in #4199
• Fix errors caused by auras inside solid VBL by @kwvanderlinde in #4204
• fixes for missing scrollbar values in stat sheet css by @cwisniew in #4223

What's Changed in 1.14.0-alpha.2

New Features 🥳

• Reimplement the add-on dialog so that it follows the selected MT theme. by @cwisniew in #4157
• Add buttons to the add-on dialog to easily copy MT Theme and MT Stat Sheet Theme CSS to the clipboard by @cwisniew in #4156
• Feature addon metadata by @cwisniew in #4167
• Themed CSS updates by @cwisniew in #4173
• Add handlebars helpers for statsheets by @cwisniew in #4188
• Update themed CSS by @cwisniew in #4189
• Add ability to set Token Images, Portraits, and Handouts from addon assets (include copy/create token) by @cwisniew in #4192

Bug Fixes 🩹

• Fix for UPnP issues by @cwisniew in #4140
• Fix missing statsheet css values by @cwisniew in #4146
• Check trusted flag against BigDecimal.ZERO instead of casting to int by @kwvanderlinde in #4153
• Clear Legacy Statsheet when moving between tokens by @cwisniew in #4177
• Fix for MapTool Freeze when using an asset that can't be found on macro button by @cwisniew in #4182

Dependency Updates

• Bump com.google.protobuf from 0.8.19 to 0.9.3 by @dependabot in #4011
• Bump com.google.protobuf:protobuf-gradle-plugin from 0.8.18 to 0.9.3 by @dependabot in #4014
• Bump org.java-websocket:Java-WebSocket from 1.5.2 to 1.5.3 by @dependabot in #4015
• Bump org.mockito:mockito-core from 5.3.0 to 5.4.0 by @dependabot in #4165

Other Changes 💬

• Add support for map IDs in macro functions by @kwvanderlinde in #4127
• Update build to use 20.0.1 for packaging by @cwisniew in #4125
• Add a createMap() macro function by @kwvanderlinde in #4128
• Handle invalid hex representations of GUIDs by @kwvanderlinde in #4174
  MapTool v1.14.0 Alpha 1 Pre Release

What's Changed 1.14.0-alpha.1

New Features 🥳

• Upgrade to FlatLaf version 3.1 by @cwisniew in #3944
• Upgrade JavaFX to version 20 by @cwisniew in #3945
• Added dependancy upgrade section to release note by @cwisniew in #3946
• creates function setZoomLock(0/1) - fr#3438 by @Jmr3366 in #3941
• functions- getMoveLock() - setMoveLock(0/1) by @Jmr3366 in #3951
• Show player loading status by @sauliuskarmanovas in #3894
• Preallocate buffers for use with LightingComposite.BlenderContext by @kwvanderlinde in #4073
• Feature user definable HTML pop stat sheet by @cwisniew in #4084

Performance Improvements 🏎️

• change network compression from lzma to zstd. by @thelsing in #4083

Bug Fixes 🩹

• Add Missing tool-tips to token topology tab by @Jmr3366 in #3950
• include label in add new token dialog by @Jmr3366 in #3973
• Fix package names by @kwvanderlinde in #3998
• Fix junit test by @cwisniew in #4005
• Correct Diamond VBL Tooltip by @cwisniew in #4029
• Fill the lumens overlay properly by @kwvanderlinde in #4045
• Fixes for Hero Lab tokens by @cwisniew in #4050
• Make almost all of MacroButtonProperties fields non-null by @kwvanderlinde in #4052
• Clean up logging by @kwvanderlinde in #4063
• Fix for error when executing a token macro as a player with the current map not visible by @Kkrafy in #4101

Code Maintenance 🔧

• Merge Dicelib code into MapTool Repo by @cwisniew in #4000
• Fix some stutters when dragging maps by @kwvanderlinde in #4003
• Remove campaign export and all related code by @kwvanderlinde in #4065
• Make XStream more agreeable, and other fixes by @kwvanderlinde in #4067
• Separate ServerConnection and ClientConnection by @kwvanderlinde in #4078

Dependency Updates

• Bump org.mockito:mockito-core from 3.11.2 to 5.3.0 by @dependabot in #3917
• Bump com.jayway.jsonpath:json-path from 2.6.0 to 2.8.0 by @dependabot in #3897
• Bump guava from 31.0.1-jre to 31.1-jre by @dependabot in #3407
• Bump flexmark-all from 0.62.2 to 0.64.0 by @dependabot in #3401
• Bump org.jsoup:jsoup from 1.14.3 to 1.15.4 by @dependabot in #3843
• Bump pdfbox from 2.0.25 to 2.0.27 by @dependabot in #3694
• Bump org.ajoberstar.grgit from 4.1.0 to 5.0.0 by @dependabot in #3433
• Bump imageio-tiff from 3.8.2 to 3.9.4 by @dependabot in #3796
• Bump com.miglayout:miglayout-swing from 11.0 to 11.1 by @dependabot in #3963
• Bump org.apache.logging.log4j:log4j-core from 2.15.0 to 2.20.0 by @dependabot in #3962
• Bump com.fifesoft:autocomplete from 3.3.0 to 3.3.1 by @dependabot in #3961
• Bump com.twelvemonkeys.imageio:imageio-psd from 3.8.2 to 3.9.4 by @dependabot in #3955
• Bump com.twelvemonkeys.imageio:imageio-batik from 3.8.2 to 3.9.4 by @dependabot in #3968
• Bump commons-net:commons-net from 3.8.0 to 3.9.0 by @dependabot in #3959
• Bump org.apache.xmlgraphics:batik-all from 1.14 to 1.16 by @dependabot in #3969
• Bump org.locationtech.jts:jts-core from 1.16.1 to 1.19.0 by @dependabot in #3970
• Bump org.reflections:reflections from 0.9.11 to 0.10.2 by @dependabot in #3957
• Bump org.apache.pdfbox:pdfbox from 2.0.27 to 2.0.28 by @dependabot in https://github.com/R...

MapTool 1.14.0 Alpha 2 (Pre 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.13.0, uninstall that first.

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 or .exe.
  • Recommend that previous 1.13.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.

What's Changed in 1.14.0-alpha.2

New Features 🥳

• Reimplement the add-on dialog so that it follows the selected MT theme. by @cwisniew in #4157
• Add buttons to the add-on dialog to easily copy MT Theme and MT Stat Sheet Theme CSS to the clipboard by @cwisniew in #4156
• Feature addon metadata by @cwisniew in #4167
• Themed CSS updates by @cwisniew in #4173
• Add handlebars helpers for statsheets by @cwisniew in #4188
• Update themed CSS by @cwisniew in #4189
• Add ability to set Token Images, Portraits, and Handouts from addon assets (include copy/create token) by @cwisniew in #4192

Bug Fixes 🩹

• Fix for UPnP issues by @cwisniew in #4140
• Fix missing statsheet css values by @cwisniew in #4146
• Check trusted flag against BigDecimal.ZERO instead of casting to int by @kwvanderlinde in #4153
• Clear Legacy Statsheet when moving between tokens by @cwisniew in #4177
• Fix for MapTool Freeze when using an asset that can't be found on macro button by @cwisniew in #4182

Dependency Updates

• Bump com.google.protobuf from 0.8.19 to 0.9.3 by @dependabot in #4011
• Bump com.google.protobuf:protobuf-gradle-plugin from 0.8.18 to 0.9.3 by @dependabot in #4014
• Bump org.java-websocket:Java-WebSocket from 1.5.2 to 1.5.3 by @dependabot in #4015
• Bump org.mockito:mockito-core from 5.3.0 to 5.4.0 by @dependabot in #4165

Other Changes 💬

• Add support for map IDs in macro functions by @kwvanderlinde in #4127
• Update build to use 20.0.1 for packaging by @cwisniew in #4125
• Add a createMap() macro function by @kwvanderlinde in #4128
• Handle invalid hex representations of GUIDs by @kwvanderlinde in #4174
  MapTool v1.14.0 Alpha 1 Pre Release

What's Changed 1.14.0-alpha.1

New Features 🥳

• Upgrade to FlatLaf version 3.1 by @cwisniew in #3944
• Upgrade JavaFX to version 20 by @cwisniew in #3945
• Added dependancy upgrade section to release note by @cwisniew in #3946
• creates function setZoomLock(0/1) - fr#3438 by @Jmr3366 in #3941
• functions- getMoveLock() - setMoveLock(0/1) by @Jmr3366 in #3951
• Show player loading status by @sauliuskarmanovas in #3894
• Preallocate buffers for use with LightingComposite.BlenderContext by @kwvanderlinde in #4073
• Feature user definable HTML pop stat sheet by @cwisniew in #4084

Performance Improvements 🏎️

• change network compression from lzma to zstd. by @thelsing in #4083

Bug Fixes 🩹

• Add Missing tool-tips to token topology tab by @Jmr3366 in #3950
• include label in add new token dialog by @Jmr3366 in #3973
• Fix package names by @kwvanderlinde in #3998
• Fix junit test by @cwisniew in #4005
• Correct Diamond VBL Tooltip by @cwisniew in #4029
• Fill the lumens overlay properly by @kwvanderlinde in #4045
• Fixes for Hero Lab tokens by @cwisniew in #4050
• Make almost all of MacroButtonProperties fields non-null by @kwvanderlinde in #4052
• Clean up logging by @kwvanderlinde in #4063
• Fix for error when executing a token macro as a player with the current map not visible by @Kkrafy in #4101

Code Maintenance 🔧

• Merge Dicelib code into MapTool Repo by @cwisniew in #4000
• Fix some stutters when dragging maps by @kwvanderlinde in #4003
• Remove campaign export and all related code by @kwvanderlinde in #4065
• Make XStream more agreeable, and other fixes by @kwvanderlinde in #4067
• Separate ServerConnection and ClientConnection by @kwvanderlinde in #4078

Dependency Updates

• Bump org.mockito:mockito-core from 3.11.2 to 5.3.0 by @dependabot in #3917
• Bump com.jayway.jsonpath:json-path from 2.6.0 to 2.8.0 by @dependabot in #3897
• Bump guava from 31.0.1-jre to 31.1-jre by @dependabot in #3407
• Bump flexmark-all from 0.62.2 to 0.64.0 by @dependabot in #3401
• Bump org.jsoup:jsoup from 1.14.3 to 1.15.4 by @dependabot in #3843
• Bump pdfbox from 2.0.25 to 2.0.27 by @dependabot in #3694
• Bump org.ajoberstar.grgit from 4.1.0 to 5.0.0 by @dependabot in #3433
• Bump imageio-tiff from 3.8.2 to 3.9.4 by @dependabot in #3796
• Bump com.miglayout:miglayout-swing from 11.0 to 11.1 by @dependabot in #3963
• Bump org.apache.logging.log4j:log4j-core from 2.15.0 to 2.20.0 by @dependabot in #3962
• Bump com.fifesoft:autocomplete from 3.3.0 to 3.3.1 by @dependabot in #3961
• Bump com.twelvemonkeys.imageio:imageio-psd from 3.8.2 to 3.9.4 by @dependabot in #3955
• Bump com.twelvemonkeys.imageio:imageio-batik from 3.8.2 to 3.9.4 by @dependabot in #3968
• Bump commons-net:commons-net from 3.8.0 to 3.9.0 by @dependabot in #3959
• Bump org.apache.xmlgraphics:batik-all from 1.14 to 1.16 by @dependabot in #3969
• Bump org.locationtech.jts:jts-core from 1.16.1 to 1.19.0 by @dependabot in #3970
• Bump org.reflections:reflections from 0.9.11 to 0.10.2 by @dependabot in #3957
• Bump org.apache.pdfbox:pdfbox from 2.0.27 to 2.0.28 by @dependabot in #3995
• Bump com.twelvemonkeys.imageio:imageio-core from 3.8.2 to 3.9.4 by @dependabot in #3993
• Bump org.apache.commons:commons-configuration2 from 2.7 to 2.9.0 by @dependabot in #3956
• Bump commons-cli:commons-cli from 1.4 to 1.5.0 by @dependabot in #3994
• Bump org.junit.jupiter:junit-jupiter-engine from 5.8.2 to 5.9.3 by @dependabot in #4010
• Bump org.apache.commons:commons-compress from 1.22 to 1.23.0 by @dependabot in https://github.com/RPTools/maptool/pul...