As version 1.3 of MapTool has progressed in its development, the documentation on the tool has fallen a bit behind. Below, you can find information on some of the dice-rolling functions that can be typed into the chat window or coded into macros. Click on the tutorials tab at the top of this page for a series of tutorial videos outlining some of the features of MapTool and how best to use them. These videos are a bit old, made with an older version of MapTool, and as such some of the menus and features go by different names or work in slightly different ways. The videos are nevertheless a tremendous resource as an introduction to the multitude of features available to you.

The wiki originally used for macros has been expanded to be more general purposes (wikis tend to work like that!).

For those seeking to take advantage of the powerful macro features, please visit the wiki previously mentioned. It is a work in progress, but still an important resource. The community forums, especially the Macros subforum, are a great place to get answers to any questions you might have, from those so basic you might feel embarassed to mention them (don't) to the very advanced.

Developers and testers, can find a change log for the 1.3 builds here.

 

Description of the syntax for dice rolls:

The dicelib is a thin extension built on top of the parser. Dicelib adds regular expression transformations to support the 2 most common die rolling expressions XdY and dY.

Added Features

Format Function Description
XdY roll If only 1 argument is supplied, pick a random number between 1 and the single argument inclusively. If 2 arguments are supplied, pick a number between 1 and the second argument a number of times represented by the first argument.
XdYdN drop Drop the N lowest dice when rolling X times with a Y-sided die.
XdYkN keep Keep the N highest dice when rolling X times with a Y-sided die.
XdYrL reroll Reroll any rolls that are lower than L, rolling X times with a Y-sided die.
XdYsS success Count the number of rolls that meet or exceed S, rolling X times with a Y-sided die.
XdYe explode Add a roll anytime one of the rolls is the maximum, starting by rolling X times with a Y-sided die.
Xsr4 basic SR4 test Roll X number of 6 sided dice. Output the number of Hits (Rolls 5 or above) and the numbers of Ones rolled. If the number of Ones is half or more of X, display Glitch. If the number of Ones is half or more of X and there are no Hits, display Critical Glitch
Xsr4gY SR4 test with Gremlins Roll X number of 6 sided dice. Output the number of Hits (Rolls 5 or above) and the numbers of Ones rolled. If the number of Ones is half or more of X minus Y, display Glitch. If the number of Ones is half or more of X minus Y and there are no Hits, display Critical Glitch
Xsr4e SR4 test "Rule of 6" Roll X number of 6 sided dice. Output the number of Hits (Rolls 5 or above) and the numbers of Ones rolled. Reroll any 6 adding it to the pool. If the number of Ones is half or more of X, display Glitch. If the number of Ones is half or more of X and there are no Hits, display Critical Glitch
Xsr4egY SR4 test "Rule of 6" with Gremlins Roll X number of 6 sided dice. Output the number of Hits (Rolls 5 or above) and the numbers of Ones rolled. Reroll any 6 adding it to the pool. If the number of Ones is half or more of X minus Y, display Glitch. If the number of Ones is half or more of X minus Y and there are no Hits, display Critical Glitch

 

d20 roll a random number between 1 and 20
2d6 roll a random number between 2 and 12 with a bell curve distribution
10d6d2 roll 10 random numbers between 1 and 6, dropping the 2 lowest
5d6k3 roll 5 random numbers between 1 and 6, keeping the highest 3
3d6r2 roll 3 random number between 1 and 6, rerolling anything lower than a 2 (rerolling 1's)
10d6s4 roll 10 random number between 1 and 6. Count the number of results that meet or exceed 4
5sr4 Roll a random number between 1 and 6, 5 separate times
Output appears as: Tester: « 5sr4 ⇒ sr4(5) = Hits: 4 Ones: 1 Results: 1 5 5 5 5 »
5sr4e Roll a random number between 1 and 6, 5 separate times, rerolling any 6's
5sr4eg2 Roll a random number between 1 and 6, 5 separate times, rerolling any 6's. Reduce 2 from the number of Ones required to glitch