MapTool 1.12.0 Beta 1

Warning: Beta Release - Please do not use for your regular gaming or to modify campaigns and maps without making a backup first.

If you are so inclined, download and install in a separate location and use to test/evaluate new features and provide feedback on them. In particular features that need broader testing are:

• Hill, Pit and MBL on Tokens
• WebRTC stability/functionality
• Add-On Libraries
• Lights - especially colored lights and darkness sources
• Loading older campaigns, maps, tokens, etc.

Changes since 1.12.0 Alpha 1

• #3521 Vision broken on maps where VBL points had very small differences in location. Fixed.
• #3515 User language now availabe through getInfo("client") and MapTool.clientInfo.getUserLanguage() in JavaScript.
• #3514 setAllStates() was throwing a ArrayIndexOutOfBoundsException. Fixed.
• #3510 createTable() function throwing exception. Fixed.
• #3506 Updated MapTool.log() to varargs.
• #3503 html5 javascript contexts now know their own identity and can get their user data.
• #3498 Add-On libraries with undefined fields in the library.json would fail to load. Fixed.
• #3489 Using Arrange->Send to Back in Draw Explorer would cause ClassCastException. Fixed.
• #3488 Background/Object layer Drawings on Player clients rendered over Darkness sources. Fixed.
• #3479 Darkness sources without color specified were not rendering on Player view. Fixed.
• #3322 Add-On lib properties were always treated as strings. Fixed.

See 1.12.0-beta.1 release for change log.

MapTool 1.12.0 Alpha 1

Warning: Alpha Release - Please do not use for your regular gaming or to modify campaigns and maps without making a backup first.

If you are so inclined, do download and install in a separate location and use to test/evaluate new features and provide feedback on them. In particular features that need broader testing are:

• Hill, Pit and MBL on Tokens
• WebRTC stability functionality
• Add-On Libraries
• Lights - especially colored lights and darkness sources
• Loading older campaigns, maps, tokens, etc.

Highlights

• Hill, Pit and MBL now supported on tokens via Edit Token dialog and macros
• Various fixes/improvements to WebRTC support
• Add-On Libraries Improvements
• Improved colored light and darkness rendering.
• Improved performance on maps with complex VBL and maps with many lights.

See 1.12.0-alpha.1 release for change log.

MapTool 1.11.5

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

MapTool 1.11.4

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.

MapTool 1.11.3

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.

MapTool 1.11.2

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.

MapTool 1.11.1

Removed.

MapTool 1.11.0

As this release has a couple serious bugs related to token sizes and missing assets the downloads have been removed. See release 1.11.2 instead.

Feature release for MapTool 1.11.0

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

• New VBL Modes - new VBL modes Hill and Pit.
• New MapTool Easy Connect server mode makes it easier for players to connect using their Public Key for authentication.
• Initial support for "Add-On" Libraries (not lib:tokens).
  • See https://rptools-doc.craigs-stuff.net/blog/add-on-libraries/
  • And #3158
• New and updated macro functions.
• Long-time Java bug causing MapTool to hang when dropping images into Edit Token dialog fixed with new Java release.

See ChangeLog for v1.11.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.

MapTool 1.11.0 Alpha 5

Warning: Alpha Release - Please do not use for your regular gaming or to modify campaigns and maps without making a backup first.

If you are so inclined, do download and install in a separate location and use to test/evaluate new features and provide feedback on them. In particular features that need broader testing are:

• Terrain VBL
• WebRTC
• Add-On Libraries

Highlights

• New VBL Modes - new VBL modes Hill and Pit.
• Initial support for "Add-On" Libraries (not lib:tokens).
  • See https://rptools-doc.craigs-stuff.net/blog/add-on-libraries/
  • And #3158

Changes for Alpha 5

• #3176 getLibraryProperty() not handling numeric values correctly. Fixed.
• #3175 Errors thrown when deleting lib:tokens. Fixed.
• #3174 onCampaignLoad not being called consistently for lib:tokens. Fixed.
• #3171 Extend @this behaviour to the data.getStaticData function.
• #3170 New macro functions to create tokens.
  • createToken(tokenValues) to create a token from a JsonObject
  • createTokens(arrayofTokenValues) to create multiple tokens from a JsonArray of JsonObjects.

See 1.11.0-alpha.4 release for previous changes.

1.11.0-alpha.4

Warning: Alpha Release - Please do not use for your regular gaming or to modify campaigns and maps without making a backup first.

If you are so inclined, do download and install in a separate location and use to test/evaluate new features and provide feedback on them. In particular features that need broader testing are:

• Terrain VBL
• WebRTC
• Add-On Libraries

Highlights

• New VBL Modes - new VBL modes Hill and Pit.
• Initial support for "Add-On" Libraries (not lib:tokens).
  • See https://rptools-doc.craigs-stuff.net/blog/add-on-libraries/
  • And #3158
• New and updated macro functions.
• Long-time Java bug causing MapTool to hang when dropping images into Edit Token dialog fixed with new Java release.

Enhancements & Features

• #3164 New macro function data.getStaticData(namespace, path) for accessing static data in Add-On libraries.
• #3103 Additional properties added to output of getFrameProperties()
  • tabtitle, html5, temporary, visible, docked, floating, autohide, undocked_x, undocked_y, undocked_h, undocked_w
• #3098 Universal VTT import now uses Terrain VBL for Object LOS Blocking.
• #3077 Initial support for "Add-On" libraries that can contain MTScript, JavaScript, HTML, CSS, assets and more in a zip file. New macro functions in support:
  • library.listAddOnLibraries() Lists the add on libraries
  • library.getInfo(namespace) Gets information about a library (either Add-On or lib:token)
  • library.listTokenLibraries(namespace) Lists the Lib:tokens in the campaign
  • library.getContents(namespace) Lists the contents of a library
• #3073 Macro function getInfo("server") now returns additional properties:
  • useWebRTC, usePasswordFile, server name, port number
• #3057 New getInfo("theme") option returns the color information for the various UI elements.
• #2984 Campaign Panel now part of default layout.
• #2982 Use of Direct3D by Java disabled by default to avoid display issues.
• #2935 getInfo("server") now includes corner info for Corner Image types, grid for the Grid * types and the group name is included in each state entry.
• #2777 New server option to disable Map Selection on player clients.
• #2755 New VBL types and changes:
  • Hill - Can see into but not through areas enclosed in Hill VBL.
  • Pit - Tokens outside of Pit VBL can see over but tokens inside can only see within.
  • Regular VBL is now called Wall. No changes to functionality.
• #2431 New macro functions to show/hide Overlays:
  • [r: setOverlayVisible(OverlayName, {1|0})]
  • [r: visible = isOverlayVisible(OverlayName)] // returns 1|0
• #1348 Method for storing HTML / CSS/ JavaScript / Audio / etc in campaigns.
• #1346 Asset class expanded to support more than just images.

Bug Fixes

• #3159 Allow URI Access fag was being reset on server start. Fixed.
• #3140 Unable to add/edit Bars if Type was localized. Fixed.
• #3114 MBL/VBL/TVBL misaligned on imported UVTT maps that were cropped during export. Fixed.
• #3112 Possible exceptions when multiple instances of MapTool tried to backup campaigns at the same time. Fixed.
• #3093 MapTool hanging when opening a campaign whose assets were not already in assetcache. Not in released code. Fixed.
• #3088 Player-editable macros on an unowned token should be treated as trusted. Fixed.
• #3081 NPE when using library.listTokenLibraries() that were missing/unset properties. Fixed.
• #3062 Preferences dialog had a mispelled and pointless tooltip. Removed.
• #3061 Bad Universal VTT files causing Null Pointer Exceptions. Code added to catch issue.
• #3013 Various macro functions were using case-sensitive function name comparisons. Changed to use case-insensitive comparisons.
• #2781 MapTool could freeze when dropping images into Edit Token dialog. Fixed.
• #233 Users could inadvertently advance initiative with Spacebar or Enter keys. Fixed.

Other

• #3100 Builds updated to use Adoptium JDK 16.0.2_7.
• #3062 Map -> Import Dungeondraft VTT... changed to Map -> Import Unversal VTT...
• #1347 Several classes added to facilitate using JFX panels in Maptool.

Change Log for 1.10.4