Resetting MapTool JVM Settings

Resetting MapTool JVM Settings

This information applies to MapTool v1.7.0 and prior. Note that these versions are no longer supported and should not be used. This information does not apply to later releases

If you changed the JVM memory settings under Edit->Preferences, there is a possibility of adding an invalid value that will keep MapTool from starting.

The first method is to pass the -reset option to your MapTool executable. The location of the MapTool executable will vary based on operating system.

  • Windows: C:\Users\[username]\AppData\Local\MapTool\MapTool.exe -reset
  • Linux: /opt/MapTool/MapTool -reset
  • Mac: Varies but may be open /Applications/MapTool –args -reset

You can also manually edit the memory config file for MapTool to set the appropriate Java Virtual Machine (JVM) values. Deleting the jvmuserargs.cfg file has the same effect as the reset flag.

  • Mac: ~/Library/Application Support/net.rptools.maptool.client/packager/jvmuserargs.cfg
  • Windows: C:\Users\[username]\AppData\Roaming\net.rptools.maptool.client\packager\jvmuserargs.cfg
  • Linux: ~/.local/net.rptools.maptool.client/packager/jvmuserargs.cfg

The contents of the file will look something like

[JVMUserOverrideOptions]
-Xmx=4G
-Xms=4G

You then modify the -Xmx= to be something your computer will digest. We generally recommend setting -Xmx (max) and -Xms(min) memory to the same settings. The -Xss defaults to 4M which satisfies the stack size for most frameworks. Note that only altered entries show up in the file.

For help with MapTool, TokenTool, or other RPTools products, please see the RPTools Forums or live chat on Discord.

You can download the new version of MapTool from the following link:

https://github.com/RPTools/maptool/releases/tag/1.9.3

All users running versions prior to 1.8.3 are strongly encouraged to update. See this announcement post on our forum.

A JAR file version may be downloaded as well but is only recommended for developers or other advanced users.

Mac Users are encouraged to use the PKG version of the install. Windows users are encouraged to use the MSI.

If you need help, please join our Discord Server. A list of all changes can be found in our Change Log

One Response to Resetting MapTool JVM Settings

Leave a reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.