Skip to content
Frank Edwards edited this page Mar 20, 2020 · 2 revisions

Frequently Asked Questions

Where can I get help/support?

Help using MapTool can be found in several places:

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.