RPTools is the Millennium Falcon of RPG Software

RPTools Game in Progress

MapTool Light and Sight

RPTools is a brand of open-source programs designed to enhance traditional pen-and-paper role playing games. They can be used for face-to-face play, or Internet role-playing in real time even if your players are on the other side of the world.  MapTool (which is our free virtual tabletop application) in particular works great with voice-chat services! These tools are not a role playing game by themselves, nor are they meant to replace everything at the RPG table. Rather, they are designed to be as flexible as we can make them, usable for a wide variety of gaming systems, from fantasy to sci-fi; from tabletop miniatures games to purely spoken-word games.

The community forums are a thriving, active source of rapid responses to any questions you may have about RPTools. We take pride in this as one of our greatest strengths and we encourage you to join us there. If the game you want to run is a commonly-found one, there’s a good chance you can locate someone in the RPTools community who’s done most of the fine-tuning for you!  Although certainly not comprehensive here you can find a list supported games: D&D 3.5 Ed, D&D 4 Ed (English, French and Spanish), D&D 5th Ed, Pathfinder, Warhammer 40k – Dark Heresy, Warhammer 40k – Rogue Trader, Warhammer 40k – Deathwatch, Warhammer 2nd Ed, Warhammer 3rd Ed, Warhammer 40k Battle, Warhammer Fantasy Battle, ShadowRun, nWOD, Call of Cthulhu 5.6 Ed, Fate 3.0, Fate Core/Accelerated, Hackmaster, Dragon Age, Savage Worlds, Hero 5th Ed, Hero 6th Ed, HarnMaster 3, Star Wars, Star Wars: Edge of the Empire, Bash, GURPS, Gumshoe, Ars Magica 5h Ed., Dogs in the Vineyard, Earth Dawn 3rd Ed, Numenera and a couple of board games.

Continue reading RPTools is the Millennium Falcon of RPG Software

MapTool Version Released

Jagged's Icon

Great news everyone. There’s a new version of MapTool available from the download page of rptools.net. The most exciting features of Build includes some new functionality that will make drawing maps easier and new MapTool Table functions that effectively allow for global variables and image stores without resorting to dropping new tokens on a map. Look for posts regarding this new functionality soon™.

Please visit the Announcements page on the forum for full details as to what’s new then go to the downloads page to try it out. Please post to the forums if you have any issues.

Many thanks to Craig, DarkAlf, Jagged, Jamz, and joshsziegler for their donations of time, talent and code. Special thanks to Jagged for all the new user functionality, joshsziegler for getting some of the development house in order, and Craig for the arduous task of porting the support libraries to GIT. Way to go, everyone.


MapTool 1.4.0 Release

We’re proud to announce the release of MapTool 1.4.0, creating a revitalization of MapTool development methodologies and direction. The MapTool application began life in 2005 when three programmers started an open source Java project as a way to connect remote friends for their RPG. It has grown in features and functionality over the last decade to include capabilities suggested by and implemented by its users but retains the goal of bringing gamers together. MapTool will always be free and supported by people that love RPGs and willingly give back to the gaming community.

This build represents a great deal of backend work to move the source code to GitHub, implements a new program build methodology using Gradle, and the initial implementation of server-side capabilities the will greatly increase the extensibility of the MapTool feature set going forward. Unfortunately you, as the user, won’t notice much of that as you run your game but it does set up the application to introduce new features with greater ease.

Now, for what you will notice:
We’ve introduce isometric maps in this release which can greatly enhance height and depth visualization for your dungeon.



For more information on isometric maps, please visit Jagged’s forum topic on the subject.

For you macro coders we’ve added the following new functions:

  • Set view area macro command
  • Add setTokenWidth/Height macro functions
  • Add setZoom(x) and getZoom() macro functions

Other changes include

  • Default the “Rename Map” input dialog
  • Refactor SightType and Light to use same shape code from Grid class
  • Change boundary to be boundary of cell and adjust image boundary instead
  • Improved random suffix logic
  • Fixes for stylesheet removal issues in htmlframe/form with Java 1.7 and up
  • New right-click menu option on Stamps to allow user to select a pixel range and enter the number of cells/squares in the selection
  • German Language Updates
  • Start of a WebAPI
  • Full Java 8 compatibility

Those last two bullets are some of the most important. These are down-in-the-technical-weeds features that set up MapTool for great things going forward.

We invite you to download and try the new version then go to the forums, Facebook, or Google+ to let us know how your tests went. As with any new release, please test with your frameworks before using this release in a game.

You can find a full list of new features, bug fixes, and technical debt payoff here. You can download MapTool from the RPTools.net download page.

Editing Macros

MTScript is a custom language for writing MapTool macros which grew out of MapTool’s chat functionality. It began simply enough as a way to roll dice. It expanded over time to the point where users create custom gaming frameworks and convenience functions in MapTool to be used by GMs and Players alike. To get a hint of what mtScript can do, check out the User Creations topic in the MapTool forum. To see MTScript taken to the Nth degree see Wolph42’s Bag of Tricks which encapsulates extreme MTScripting. You’ll find support for complete RPG frameworks for a huge number of games systems in Campaign Frameworks.

The MapTool macro editor is a little lacking in functionality so the community stepped up to create tools for editing. It’s one of the strengths of this group, the desire to contribute when and where they can. There are at least two community gems out there that allow for easy editing and syntax checking for Macros.

vim_headerThe first is Craig’s GVIM configuration. You can find download and installation instructructions at this forum link. GVIM is the descendant of the venerable VI editor. People either love or hate VI. It uses one or two character commands and is very powerful. You almost never need to touch the mouse once you get use to it. To get over VI’s learning curve we suggest reading vimbook-OPL.pdf. Azhrei also produced a quick reference sheet. GVIM runs on Windows, Mac, Linux.


The second external editor that can be used is Notepad++ with Aliasmask’s configuration. Notepad++ is more user friendly and is closer to the editors most users know. However, it only runs on Windows operating systems or a system in Windows emulation mode, such as Linux Wine.

RPedit LogoRegardless of which you use, the RPEdit library token is a great utility that allows you to extract all the macros from a token for easy copying into one of the above tools.  The tool is actually written in MTScript and allows for macro configuration and button display properties.


You can find the files and full instructions on this forum link. Besides editing, you can also put your macros under source code control by saving them out to github or sourceforge.

If you decide to take the plunge into Macro writing, visit the Introduction to Macro Writing on the RPTools Documentation Wiki. If you get stuck head over to the MapTool->Macros topic in the RPTools forum for help.

New Website Launch

Website Launch Celebration

Welcome to RPTools new website. We hope you find the new site cleaner, slicker, and easier to navigate. We’ve added a group of quick links to the side bar and reorganized the pages a bit including links to the forums, Wiki, user created frameworks, online communities, and other helpful links to get new users started. We hope you find it more user friendly.

The strength of RPTools has ever been its community and the goal of the new website will be to highlight that strength. Expect updates to the main page that will show interesting posts on the forum, examples of the tool’s users in actual play, and helpful videos of the tools in use. The goal is to make rptools.net a place to come to for more than just downloads. We hope to provide useful information to both the long-time user and the person trying to decide which VTT is right for them.

Website Still Improving

We have a strong international community and one of the early goals of the new site was to provide content in various languages in order to improve the experience for our non-native english speakers. It is still a goal but may will take a bit of time to achieve. Thanks to everyone that provided translation support. RPTools software is free, open source, and open community. We try never to build artificial walls around development, testing, or content. Our goal of providing multilingual support is just another facet of that belief.

Take it for a spin

Please take a few minutes and click through the site. Feel free to leave any feedback in the comments below.

The RPTools Staff

MapTool 1.3b91 Released

MapTool LogoThis build features a number of bug fixes, new VBL functionality, a new Java launcher, and Java 8 support (hellya). The new release is located on our download page or you can launch it directly from the web launch page. Note that Oracle now has quite a few security warnings around web launch programs. You can find a complete list of updates on the announcements page.

While the web launcher is handy, you should encourage your players to use the new launcher jar that now ships with MapTool: launcher-130829.01.jar. It makes starting MapTool much easier. It remembers the MapTool version, stack, and maximum memory settings between launches. Additionally, you can select the language – English, French, or German, the logging level for reporting bugs, and the warning level – all helpful when reporting bugs into the forums. We recommend this as the method of choice for starting the program.



This release should be the last in the 1.3 line as we move on to MapTool 1.4. Please feel free to leave comments below or in the forums.