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 |