r/MapTool • • Dec 29 '22

Quick and dirty Maptool guide

43 Upvotes

Maptool guide

Maptool has a lot of advanced features, many of which can be safely ignored if you are just looking for a replacement for your tabletop Battlemat and Token setup. Here is a short walk though of how I use Maptool with minimal complexity.

DM setup:

Create your map (campaign) file in maptool.

  • Drag and drop a map image (jpg, png) into the background layer in maptool. (the layer selector is in the top right of the main window)

    • I find many maps that I like to use on r/dndmaps

  • Adjust the grid size to roughly the correct scale (ctrl+shift+a)

  • Add PC/NPC tokens to the token layer (SKIP this if you are using physical minis)

  • Turn on fog of war (ctrl+w)

CLIENT/SERVER configuration:

  • Start the GM instance of Maptool

  • Start the SERVER on the GM computer (file > start server)

    • set your Username (DM is fine)

    • select "Use MapTool Easy Connect"

    • Click OK

  • Start the Player instance of Maptool (GM and Player instances can both run on the GM computer)

  • Connect the Player instance(s) to the GM SERVER (File > Connect to Server)

    • Set a Username ("Player" or the Character name)

    • Click the LAN tab (There should be one server listed as the name set in the GM instance)

    • Select the server and click OK

      • On the GM instance click Window > Connections

      • in the new pane that appears click Pending > Approve

Playing and controlling the game:

  • The player screen should be black (can't see anything because DM hasn't revealed anything yet).

    • CTRL+E forces players to your MAP (if you have multiple maps in this file - changed with SELECT MAP - top right - above layers)

    • CTRL+F forces players to center on your VIEW of the current map

    • The above options are available from the TOOL menu - if you aren't into the keyboard shortcut thing.

  • On the DM screen click the FOG button in the tool bar

    • Draw a square around the area you want to reveal

    • SHIFT+draw square will hide that area again.

  • CTRL+G turns the grid on/off

A word about tokens (optional)

  • click+drag to move them

  • double click to set properties (NPC/PC - etc)

  • RT CLICK to set/unset "visible to players" and "snap to grid"

  • SHIFT+MOUSEWHEEL sets the facing direction (rotates the token)

  • RT CLICK to set SIZE

You can roll dice in the chat window (Window > Chat)

  • "/roll 1d20+1"

  • "/roll 4d6+7"

There are many more features like vision blocking, initiative tracking, macros, etc, but the above is a good start for using MapTool to run a game.


r/MapTool • • Jul 14 '21

TokenTool 2.2.0 Released

34 Upvotes

TokenTool 2.2.1 has been released to fix a couple bugs.

See https://www.reddit.com/r/MapTool/comments/oq6ahe/tokentool_221_release/

TokenTool 2.2.0 Released

  • Now supports saving both tokens and portrait images to webp, png, jpg, gif and tif image formats.

  • Bulk PDF Image extraction in image format of your choice by page or the whole shebang.

  • Finer control over image size when zooming and rotating token image.

Download: https://github.com/RPTools/TokenTool/releases/tag/2.2.0

Change Log: https://github.com/RPTools/TokenTool/blob/2.2.0/CHANGE_LOG.md

Token portrait is a bit soft as I zoomed in a bit much to fill the large token ring.


r/MapTool • • May 05 '20

Melek's Simple 5e D&D Framework 2.0 Release

34 Upvotes

Simple 5e is a Dungeons and Dragons 5th edition MapTool framework intended to be easy to learn and tinker with for newer MapTool players to make playing fun and easy, while being complete enough to grow with you as your game progresses.

This new version has a nice character sheet, help system, and a custom counters system to help track ammo, spells, abilities, and more right in MapTool.

The Dragons Are Real YouTube Channel has made an introductory video in case you want to see the framework in action.

If you are using MapTool 1.6+, I heartily recommend Merudo's 5e Spell Library Addon for this framework to help track learned and prepared spells, set concentration, and even roll spell damage and saving throws without fuss.

I spent a lot of time on this release and had a ton of help from MapTool's discord community. I highly recommend coming by. If you need any help, I am Melek on discord. If you want to download the framework pieces or you find any bugs, feel free to visit the GitHub repo.

Download on the Official RPTools.net Forum Post


r/MapTool • • Aug 04 '25

Simple5e 2.3.0 Released

30 Upvotes

Simple5e is still alive! This is a simple-to-use first framework for playing 5th edition Dungeons and Dragons in MapTool. Tinker friendly, this framework includes built-in help features and is designed to be a foundation for your game. For more information, check out this helpful introductory video and visit the official RPTools.net forum thread.

Changes in this version: 2.3.0 fixes compatibility issues when running the framework in MapTool 1.18+ and better accommodates theming improvements implemented since 1.12+ which degraded the default macro layouts. It also better handles dark mode themes.

There are additional improvements such as corrected critical hit language, displaying natural 1 hitrolls in chat, and many other bugfixes.

No simple upgrade path: If you already use Simple5e and are hoping to upgrade, I apologize that it won't be easy. The required changes were very extensive, so I did not make an 'upgrade token' or upgrade instructions. The main problem is you'd have to update many macros on every token based on Simple5e's standard token across a whole campaign, so I'd recommend sticking it out on your current MapTool version for those campaigns.

In other words, this new version is best for a fresh campaign, though if you are experienced you could backup and attempt to carefully update an ongoing campaign.

Need help? Ask! I honestly can't believe this framework is still kicking after all these years, but I get enough messages about it to justify further work so don't hesitate - If you need a hand, let me know on Discord or in the comments and I'll do my best. :)


r/MapTool • • Mar 20 '22

[OC] [Battlemap] Wave Echo Cave - Lost Mine of Phandelver

Post image
29 Upvotes

r/MapTool • • Jun 15 '21

MapTool 1.9.0 Released!

29 Upvotes

Many thanks to everyone who contributed code, documentation, translations, bug reports and feature requests. It is the MapTool community that makes it great.

Download the install for your OS here.

Highlights

  • Maps now have a Display Name (Players) and a True Name (GM).

  • More image types supported along with beginnings of support for non-image assets.

  • Quality of Life improvements: pan map with arrow keys, select drawings on map for deletion, hotkeys for image flip.

  • Improved performance and consistency for paths from AI pathfinding including improvements for paths for large tokens.

  • Additional UI elements available in full-screen mode.

  • Development moved to AdoptOpen Java 16.

  • Moved from Nashorn to GraalVM JavaScript engine.

  • More bug fixes.

  • More localization for the UI.

See the full ChangeLog for a complete list of changes and links to the relevant issues.


r/MapTool • • Sep 08 '20

MapTool 1.8.0 Beta 2 Released

29 Upvotes

MapTool 1.8.0 Beta 2

MapTool now uses Java 14 from AdoptOpenJDK.

The installers are now built using jpackage and are a little different. It's important to let us know about any installation/startup issues.

Download MT 1.8.0-beta.s here.

Lots of enhancements, bug fixes and performance improvements to the code base. See the Change Log for more details.

Many thanks to community developers merudo, selquest, nmeier, euank, ebudai, grimreaper, and pk1010 for all their work on this release. Also big thanks to the translators building up the language support and the wiki editors for improving/growing the documentation.

Highlights

  • Significant improvements in macro run times giving a 4x to 10x (and sometimes more) reduction in run times.

  • Macro errors now produce a call stack showing the macro calls leading to the error. Function "setTokenDrawOrder" requires at least 1 parameters; 0 were provided. Error trace : m3@Campaign <<< m2@Campaign <<< m1@campaign

  • ISO-8859-1 character support. Can now use accented characters in Token Properties and macros.

  • Several Export Screenshot bugs fixed.

  • A number of Initiative improvements/enhancement: #987, #1458, #1845, #2097


r/MapTool • • May 18 '20

MapTool 1.7.0 Released

29 Upvotes

Regular Release

Regular MapTool v1.7.0 release available for download.

Download here.

Highlights

A significant number of new features and bug fixes. Many thanks go out to the community members who contributed code, documentation, translations and time in testing the builds.

  • New macro functions for math operations on lists and arrays.

  • New Macro function markdownToHTML() converts text in Markdown to HTML.

  • nmeier has brought the majority of the MapTool UI under the control the Look & Feel themes accessible from the Themes menu.

  • New GM option to disable the use of the Edit Token dialog by players.

  • Issue with decimal point in Map Units per Cell for European locales fixed.

  • New overlay() function allows for transparent overlays over the map area. Think MMORPG-like GUI elements.

  • New Overlay helper functions for management.

  • Huge localization effort by Merudo has brought translatable strings to the majority of the MapTool dialogs.

  • MapTool can now import the Dungeondraft VTT export format.

Documentation is lagging a bit for new features on the wiki. More information may be found on the associated issue which is linked from the Change Log.


r/MapTool • • Feb 15 '21

MapTool 1.8.3 Released - Upgrade Immediately

28 Upvotes

MapTool 1.8.3

Download MapTool 1.8.3

MapTool now uses Java 14 from AdoptOpenJDK.

Do not install this over your 1.7.0 or previous installations. Uninstall previous versions or use a different location. The installers are now built using jpackage and are a little different.

Lots of enhancements, bug fixes and performance improvements to the code base. See the Change Log for more details.

Many thanks to community developers merudo, selquest, nmeier, euank, ebudai, grimreaper, and pk1010 for all their work on this release. Also big thanks to the translators building up the language support and the wiki editors for improving/growing the documentation.

Highlights

  • This release includes fixes for two security vulnerabilities. Use of all previous versions of MapTool should be discontinued. Builds for previous releases have been removed.

  • Significant improvements in macro run times giving a 4x to 10x (and sometimes more) reduction in run times.

  • Macro errors now produce a call stack showing the macro calls leading to the error. Function "setTokenDrawOrder" requires at least 1 parameters; 0 were provided. Error trace : m3@Campaign <<< m2@Campaign <<< m1@campaign

  • ISO-8859-1 character support. Can now use accented characters in Token Properties and macros.

  • Several Export Screenshot bugs fixed.

  • A number of Initiative improvements/enhancement: #987, #1458, #1845, #2097

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 14 install with JavaFX on your system in order to use it.


r/MapTool • • Sep 27 '22

MapTool v1.12.1 Released

26 Upvotes

A lot of new features and bug fixes in the 1.12 release. Some highlights:

  • New theme support using Flatlaf library. Access through Preferences.

  • The different VBL types and MBL can now be added to tokens via the Edit Token dialog and a number of macro functions for manipulating VBL/MBL have been added as well.

  • More optimizations for lighting and vision.

  • Improvements to new Add-On functionality.

More info can be found on the Release page and the full change log for 1.12.

If you have installed a previous 1.12 release make sure to uninstall that version first.


r/MapTool • • Feb 12 '23

The wiki is back - at a new address for now

24 Upvotes

Or, at least, as fully restored as is possible. It's about 99.5% complete. The new address is:

https://rptools.hyperbooks.com

If you were an editor, and would like to continue to do so, PM me with your user name and I'll update the password (all the passwords were randomized before Craig sent me the SQL dump). But you should update any bookmarks you have.

Where we go from here is up to Craig. I know he's inclined to move it all to GitHub, which is an idea that has a lot to be said for it. That will be easier with a working copy of the wiki. I've also made it clear I have no problem with continuing to host it indefinitely, if he wants the burden of maintaining it of his plate. But that's up to Craig.

In the meantime, the wiki is back.


r/MapTool • • Aug 22 '20

Survey - MapTool 2.0 Features and Functionality

24 Upvotes

We've got a survey up to get some feedback on what features you, the users, see as a priority.

https://www.surveymonkey.com/r/D6PV8RV


r/MapTool • • Oct 27 '22

MapTool v1.12.2 Released

23 Upvotes

Bug-fix release including fixes for the dreaded red Xs and random player disconnects.

Changes since 1.12.1:

  • #3723 Checkbox to use theme for chatbox colors move to top of theme preferences tab.

  • #3720 Corrected issue with players randomly disconnecting.

  • #3719 Macro function setHalo("None")
    was throwing NPE. Fixed.

  • #3703 Grid offsets were reset on loaded maps.

  • #3702 Grid offsets were changing on server start. Fixed.

  • #3701 Fixed issue with dropped assets showing as red Xs.

  • #3700 Macro function removeTokenFacing()
    was throwing NPE. Fixed.

  • #3689 Soft FoW opacity was ignored when no sight was present. Fixed.

  • #3688 Soft FoW was rendered even when Sight is off. Fixed.

More info can be found on the Release page and the full change log for 1.12.

If you have installed a previous 1.12 release make sure to uninstall that version first.


r/MapTool • • Jul 13 '21

MapTool 1.9.3 Released

23 Upvotes

More bug fix goodness.

Of particular note are several VBL/MBL performance fixes for complex maps plus a variety of QoL and functionality fixes.

See Change Log for more details.

Download: MapTool 1.9.3

Please read the Platform Notes for your OS prior to installing.


r/MapTool • • Dec 13 '19

MapTool 1.5.8 Released!

21 Upvotes

Get your download here: https://github.com/RPTools/maptool/releases/tag/1.5.8

Highlights

  • This release bumps the default stack size to 8MB. If you are running MapTool with max memory set to 2GB or less, you might want to bump that up to 3GB or more.

  • Macros on copied tokens having duplicate UUIDs problem fixed.

  • Toolbar/ribbon in MapTool can now be hidden to give you more screen space.

  • Additional parameters and improvements to various macro functions.

  • New translation team members, Deniz Köse and Vitaly Karpenko, have bumped our Russian translation up to 74%.

  • Fog of War exposure fixes.

  • Tooltips added to all menu items.

  • Bug fixes!

View Change Log


r/MapTool • • Mar 18 '19

MapTool 1.5 is live!

21 Upvotes

r/MapTool • • Dec 05 '21

MapTool 1.11.3 Released

20 Upvotes

Feature Release for MapTool 1.11.3

Couple more bugs squished.

Download from the MapTool GitHub repo.

See ChangeLog for more details and links to individual issues.

As always, either install to a new location or uninstall your previous MT version first.

Highlights

  • New VBL Modes - new Hill and Pit VBL modes.

  • New MapTool Easy Connect™ server mode makes it easier for players to connect using their Public Key for authentication.

  • Initial support for "Add-On" Libraries (not lib:tokens) that can contain HTML, CSS, JavaScript, MTScript macros, image assets, JSON data and more.

  • New and updated macro functions.

  • Long-time Java bug causing MapTool to hang when dropping images into Edit Token dialog fixed with new Java release.


r/MapTool • • Oct 10 '21

MapTool 1.10 Released

20 Upvotes

Feature release for MapTool. Get your download here.

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.


r/MapTool • • Apr 21 '20

MapTool Overlays Example

Post image
20 Upvotes

r/MapTool • • Aug 08 '22

MapTool 1.12.0 Beta 1

19 Upvotes

Warning: Beta Release - Please do not use for your regular gaming or to modify campaigns and maps without making a backup first.

More info can be found on the Release page.

Download from GitHub

If you are so inclined, 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:

  • Hill, Pit and MBL on Tokens

  • WebRTC stability functionality

  • Add-On Libraries

  • Lights - especially colored lights and darkness sources

  • Loading older campaigns, maps, tokens, etc.

See ChangeLog for more details and links to individual issues.

If you have a previous 1.12 release installed you must uninstall it first.


r/MapTool • • Jul 12 '22

MapTool 1.12.0 Alpha 1 Released

19 Upvotes

Warning: Alpha Release - Please do not use for your regular gaming or to modify campaigns and maps without making a backup first.

Download from GitHub

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:

  • Hill, Pit and MBL on Tokens

  • WebRTC stability functionality

  • Add-On Libraries

  • Lights - especially colored lights and darkness sources

  • Loading older campaigns, maps, tokens, etc.

Highlights

  • Hill, Pit and MBL now supported on tokens via Edit Token dialog and macros

  • Various fixes/improvements to WebRTC support

  • Add-On Libraries Improvements

  • Improved colored light and darkness rendering.

  • Improved performance on maps with complex VBL and maps with many lights.

See ChangeLog for more details and links to individual issues.

As always, either install to a new location or uninstall your previous MT version first.


r/MapTool • • May 24 '20

D&D 5e Framework 2.4.3 Released

19 Upvotes

This update has lots of performance improvements, bug fixes and a couple new tools, easier to use custom class creation, just need the campaign file that you can get here https://forums.rptools.net/viewtopic.php?f=85&t=28435&p=274694#p274694


r/MapTool • • Nov 14 '19

MapTool 1.5.7 Released

19 Upvotes

MapTool 1.5.7 has been released.

Download here.

Highlights

  • New accessibility features allows the user to apply Perlin noise to tiled textures to reduce obvious patterning.

  • New user preference (Edit -> Preferences -> Application -> Performance) for Max Frame Rate allows users to set a desired Max Frame Rate.

  • More updated macro functions for improved performance and reliability.

  • New GM macro panel for GM only macros. These macros are saved as part of the campaign.

  • Bug fixes!

Change Log


r/MapTool • • Nov 13 '19

New D&D 5E Framework for MapTool

19 Upvotes

For those of you playing D&D 5E, Rod Takehara has posted a new and very impressive-looking framework for it.

Worth taking a look.

https://forums.rptools.net/viewtopic.php?p=274714#p274694


r/MapTool • • Aug 27 '21

New Lib:Elevation Library for adding Elevation features to MapTool

18 Upvotes

Introducing Lib:Elevation 1.0 Beta!

The last few months I've been working on an Elevation library for MapTool so I can make vertical encounter maps by defining "key" elevations which each have their own VBL, MBL, and more. It is still rough around the edges, but I'm pretty proud of the results!

Apart from the core functionality, I'm very proud of making this feel like it is built into MapTool with an overlay system that fits right in (admittedly not great if you use a theme, but you could change the CSS with a little work):

Please check out the introductory video for a full demo, download it, and give it a whirl. I'd love your feedback! You can contact me here, on the Forum post, file bugs/issues/requests, on GitHub, and also ping me (Melek) on the MapTool Discord server.

Enjoy!