Help using MapTool can be found in several places:

• To chat or find other MapTool Users on Discord → https://discord.gg/gevEtpC

• To post general questions on the forums → http://forums.rptools.net/viewtopic.php?f=60&t=23681

• You can also reach out to other users on FaceBook or Reddit. To report a bug or request a new feature, you can file an issue here on GitHub. We recommend that you first search the Forums regarding your issue, then ask questions about the issue on the Discord — your issue may already be known or have existing solutions.

• Open a new bug report or feature request.

Note that search engines will index the Forum pages, but cannot index Discord channels. For this reason, please search the Forum first and if you don’t find the information you need, then check Discord.

MapTool is now packaged using standard Oracle javapackager’s native OS executable. The normal java.exe, javac.exe, and javaw.exe are not packaged with the supplied JRE as a security precaution (preventing other programs from using the supplied JRE for nefarious reasons!). This made the Launcher obsolete and incompatible.

Easy! Within MapTool, go to Edit → Preferences, then click the Startup tab. Be sure to restart MapTool after any changes here for them to take effect.

Be sure you are entering valid Java JVM settings. They should end with either a K, M, or G. e.g. 2048M or 2G. I recommend 2G to 4G for Max memory settings and a Stack Size setting of 4M.

This can happen sometimes if you’ve entered something your system can not support or doesn’t like. To clear all your settings, start MapTool with a -reset appended to the end, e.g. in Windows, copy the shortcut, edit the properties, and for Target add -reset at the end like:

Note: Create a copy or change it back after launching MapTool, otherwise it will reset your settings again the next time you use it!

You can manually edit the startup settings. They are stored in the jvmuserargs.cfg file at the following locations, specifically under the [JVMUserOverrideOptions] header:

• macOS

  ~/Library/Application Support/net.rptools.maptool.client/packager/jvmuserargs.cfg

• Windows

  C:\Users\username\AppData\Roaming\net.rptools.maptool.client\packager\jvmserargs.cfg

• Linux

  ~/.local/net.rptools.maptool.client/packager/jvmuserargs.cfg

Apple, in their infinite wisdom, decided that applications should only run once at any given time. So if MapTool is running and you double-click on the launch icon again, it simply switches to the one that’s already open.

There are two ways to launch the application a second time:

1. Copy the application to another name and launch that one!

   This is obviously pretty easy to do. Just navigate to where you’ve put MapTool.app and select it with a single left-click, then press Ctrl-C to copy it and Ctrl-V to paste it. The new one will have the same name but with copy added to the end of the name. (You can Ctrl-click it and rename it, if you wish.)

2. Open a terminal and run a command that forces a second instance to be started.

   Open a Terminal prompt (you can open Launchpad and type "Term" and then click on Terminal). Type open -n -a MapTool.app (or whatever name your MapTool has). You can then close Terminal.