Atlas VTT

Roll dice

Throw dice on the map from the dice tray or a statblock, choose how they look, set your game's dice rules and look up past rolls.

Dice in Atlas are thrown on the map. They tumble over a panel at the top right and land on the result. You roll them from the dice tray or straight from a statblock.

Roll from the dice tray

  1. Click Roll Dice in the toolbar at the bottom of the map, or press R. The dice tray opens above the button.

  2. Click a die to add it: d4, d6, d8, d10, d12, d20 or d100. Every click adds one more, and a number on the die counts them. Click the minus under a die to take one back.

    The dice tray with two d6, one d20 and a modifier of +3.
  3. To add or subtract a fixed number, click the plus or minus next to Modifier.

  4. Check the formula under the modifier, for example "2d6 + 1d20 + 3", then click Roll.

    Click Roll, and the dice land on the result.

Clear empties the tray without rolling.

Read the result

The dice land with the rolled faces up. Under them is the total, and below the total each die and the modifier, for example "2 + 4 + 12 + 3".

Click the panel while the dice are in the air to skip the throw. Click it again or press Esc to close it. Left alone, it closes after a few seconds.

A second roll does not wait for the first one. The new roll takes the large panel and the older one shrinks to a row above it, so an attack and its damage stay on screen together. Atlas shows up to three rolls at a time.

Critical rolls

The total turns yellow on a critical success and red on a critical failure. In most games that is a d20 that shows 20 or 1. The Critical Rule of your collection decides which rolls count.

Roll from a statblock

Dice in a statblock are clickable. Click "2d6 + 2" in an attack to roll two six-sided dice and add 2. A bonus without dice, like "+4" or "Attack: +4", rolls the default roll of your collection and adds the bonus. In most games the default roll is a d20.

Roll an attack and its damage from a goblin boss's statblock.

The roll shows the token's portrait and the name of the ability, so you know whose Greatsword that was.

See Use Fantasy Statblocks with Atlas to give your tokens statblocks.

Change how the dice look

Press Space to open the command palette. On the Settings tab, click Dice settings. What you choose there applies to every map.

The Dice Settings panel with the three dice colours.

Roll display sets how a roll shows:

  • Dice: the dice are thrown and land on the result.
  • Fast dice: the same throw at double speed.
  • Result card: no dice. A card shows the total, and Details on the card lists each die.

Under Dice, click Light, Dark or Accent. Accent dice take the accent colour of your Obsidian theme. Numbers changes the numerals on the dice and the totals: Medieval for fantasy games, Sci-fi for futuristic ones.

A d100 rolled together with other dice, or more than 20 dice at once, always shows as a result card.

Set the dice rules of your game

Every collection has its own dice rules. Open the collection settings and click the Dice tab.

The Dice tab of the collection settings.

Default Roll is what Atlas rolls when a statblock gives only a bonus. With "1d20", a "+3" rolls 1d20 + 3. Type one group of dice, such as "1d20" or "2d12".

Critical Rule decides when the default dice are critical:

  • Natural: the highest face is a critical success, a 1 is a critical failure.
  • Roll-under: a 1 is a critical success, the highest face is a critical failure. Percentile games work this way.
  • Doubles: default dice that all show the same number are a critical success.
  • High total: default dice that add up to their highest total, or one below it, are a critical success. On 2d10 that is 19 or 20.
  • None: no roll is critical.

Only the default dice can be critical. With a default roll of "1d20", a damage roll of 2d6 never is.

A game system preset brings the dice rules of its game. Call of Cthulhu, for example, rolls 1d100 and counts a 1 as a critical success.

Exploding dice

In some games a die that shows its highest face is rolled again, and the new die is added. Under Exploding Dice, choose Default dice to let only the default dice explode, or All dice for every die you roll. A sentence under the menu says what your choice does to your default die.

Two switches change the rule:

  • New dice explode too: a die rolled for an explosion can explode again, up to ten times.
  • Lowest face rolls again and subtracts: a die that shows 1 is rolled again, and the new die is taken off the roll.

If more than the highest face explodes in your game, open Explode on more than one face and set how many faces do.

One roll can explode even when the rule is off. In the statblock, write "!!" after its dice to add one more die ("2d6!!"), or "!i" to keep exploding ("2d6!i").

The dice log

The dice log lists the last 20 rolls on this map and keeps them when you close the map.

  1. Press Enter on the map. You can also click Open dice log in the command palette.

    The Dice Log with three rolls, one of them open.
  2. Click a roll to see each die. Click the round arrow button (Roll again) to roll the same dice again.

Press Enter or Esc to close the log, or click the pin button (Pin panel open) to keep it open while you play. The bin button (Clear history) empties it.

Show rolls to players

Players see your rolls only after you turn this on.

  1. Press Space to open the command palette. Click Local player view settings.

  2. Turn on Show dice rolls.

The player view then shows the same rolls, thrown at the top of the window. For a hidden token, players see the result without the token's name or portrait.