FAQ

Frequently Asked Questions

Where can I get help/support?

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.

Where did the launcher go?

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.

If the Launcher is gone, where can I customize memory settings?

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.

JVM Memory settings are not saving on the Edit → Preferences → Startup tab!

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.

MapTool will no longer start after changing Startup settings!

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:

C:\Users\Jamz\AppData\Local\MapTool\MapTool.exe -reset

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

The -reset option isn’t working, what now?

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

On macOS, how do I run a second instance of MapTool on the same computer?

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.