MapTool 1.11.0 Alpha 3

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

• Terrain VBL - new VBL type allows vision to see into but not through an area enclosed with Terrain VBL.
• Initial support for "Add-On" Libraries (not lib:tokens).
• New and updated macro functions.
• Bug fixes to WebRTC support.
• Long-time Java bug causing MapTool to hang when dropping images into Edit Token dialog fixed with new Java release.

Enhancements & Features

• #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
• #2982 Use of Direct3D by Java disabled by default to avoid display issues.
• #2755 New VBL type, Terrain VBL, added. Can see into but not through areas enclosed in Terrain VBL.
• #2431 New macro functions to show/hide Overlays:
  • [r: setOverlayVisible(OverlayName, {1|0})]
  • [r: visible = isOverlayVisible(OverlayName)] // returns 1|0

Bug Fixes

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

Full Changelog: 1.11.0-alpha.2...1.11.0-alpha.3

MapTool 1.10.4

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

MapTool 1.11.0 Alpha Build 2

Warning Alpha Release, please do not use for your regular gaming, or use it to modify maps you don't have a backup of!

What's Changed

• Fixes for several macro functions where name was case sensitive #3011 #3013
• implement terrain VBL #2755
• Preference Dialog Fixes #3063
• More error handling / clean up for Universal VTT import #3061
• Disable Direct 3D by default #3065
• Space/Enter will no long advance initiative #3066
• show / hide / get visibility of overlay macro functions #2431
• Add initial support for Add-Ons #1346 #1348 (see also https://rptools-doc.craigs-stuff.net/blog/add-on-libraries)
• Terrain vbl app preference compatibility with old versions #2755
• Fixes issue with trusted macros where player editable is set but token is owned by no one #3088
• Fix hanging when trying to import assets from a campaign file. #3093
• Add information returned by getInfo("server") #3073

Full Changelog: 1.11.0-alpha.1...1.11.0-alpha.2

MapTool 1.11.0 Alpha Build 1

Warning Alpha Release, please do not use for your regular gaming, or use it to modify maps you don't have a backup of!

What's Changed

• Fixes for several macro functions where name was case sensitive #3011 #3013
• implement terrain VBL #2755
• Preference Dialog Fixes #3063
• More error handling / clean up for Universal VTT import #3061
• Disable Direct 3D by default #3065
• Space/Enter will no long advance initiative #3066
• show / hide / get visibility of overlay macro functions #2431
• Add initial support for Add-Ons #1346 #1348 (see also https://rptools-doc.craigs-stuff.net/blog/add-on-libraries)

NOTE: if you experiment with the terrain VBL feature be sure to set the VBL mode back to plain VBL or MBL before exiting MT 1.11.0 or previous MapTool versions will not be able to start.

Full Changelog: 1.10.1...1.11.0-alpha.1

1.10.3: Fix for NPE on exit with no connection

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

MapTool 1.10.2

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.

1.10.1

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.

MapTool 1.10.0

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.

MapTool 1.10.0 Beta 4

WebRTC

Beta Test 4 to test WebRTC changes in MapTool - This feature will allow player clients to connect with the server without requiring port-forwarding on the server end. To test both Server and Player clients must enable it via the Help menu -> Use WebRTC for communications...

Those users that were unable to configure the router that an ISP provided should give this a test.

User Passwords

Also part of this build is the initial per-user password database support. This can be enabled on the Start Server dialog. You will need to manually add the passwords.json file to your .maptool-rptools/config directory. You can create the file initially in plain text and MapTool will convert on server startup. Example passwords.json file:

{
	"passwords": [
		{
			"username": "GM",
			"password": "MothersMaidenName",
			"role": "GM"
		},
		{
			"username": "Player1",
			"password": "NotMyBirthday",
			"role": "Player"
		}
	]
}

See #2917 for more details.

MapTool 1.10.0 Beta 2

Beta 2 test build for WebRTC network changes in MapTool.