--An elderly man sits in his chair, beckoning you forward.

"Ah, welcome my child. Come, sit. Let me tell you of times past and times to come. Once, a long time ago, Astral was a different place full of novel technology such as Character Sheets and click actions that rolled dice. It was a primitive past, and has long since been buried. It always strikes me as peculiar, however, how history inevitably repeats itself."

Character Actions and Attributes:

So, you've got yourself a beautiful character token and TableTop Chat with dice rolls. What's next? How can we make this better?

Your character is it's own being. As such, they have many things they can or cannot do. You can define these things (e.g. emotes, rolls, etc) by creating an Action in the Character Window. When clicked, these actions will be performed as your character in TableTop Chat.

Table of Contents:

  1. Setting Up Character Actions: The Basics
  2. Roll Syntax
  3. Character Attributes
  4. Advanced Character Actions

Setting Up Character Actions: The Basics

To start, open up a Character Window. You can do this by clicking the character in the GM Sidebar, or by clicking the token, followed by clicking the gear icon that appears in the Character Quick Bar in the upper side of your screen.

Then, click on Actions. If this is a fresh character, it's likely going to be blank. You'll need to set up a category, followed by actions for that category.

Actions can be created in each category using the "+" icon on the right hand side of the Categories list.

Actions can be as simple as an emote of your character taking a swig out of their flagon with a dragon (that may or may not contain the pellet with the poison or the brew that is true). They can also be a mixture of an emote and a roll.  

**Notice that if an action is clicked, it will display in Tabletop Chat. If players don't have Tabletop Chat open, they won't be able to see the result of your actions.

Roll Syntax

A roll is declared using the following syntax: rolltype(#d#)  where the first # is the number of dice, and the 2nd # is the die size. The rolltype is determined by exclamation points. One exclamation point is an automatic roll, the second exclamation point is a delayed roll. 

So, !(1d20) would roll a single 20 sided die as soon as it was sent. !!(1d20) would prepare that roll when sent to Tabletop Chat

Try making an action like this: 

The guard charges forward. He's trying to throw shackles on you! !!(1d20+{grapple})

The Chat output will look something like this:

You may notice that I threw a curve ball in there, I added the City Guard's {grapple} attribute as a modifier to the roll in the message; This will be covered in the next section! 

For a complete guide on Message and Rolling Syntax, check out the tutorial for Tabletop Chat!

Character Attributes

Attributes are powerful modifiers that can be referenced during rolls in Tabletop Chat. If you followed the above example, you'll notice that the value of grapple on your roll was 0. That's because you haven't set up the attribute yet! 

To set up attributes, click the "Attributes" tab of the Character Window. From there, you'll be able to add an attribute to your character.

Notice the roll now displays the correct modifier for the grapple attribute. This can be used as a modifier after a roll, the size of the die, or even the number of dice rolled! Simply replace the number with the attribute wrapped in curly brackets {likeso}

**The attributes are case sensitive. If you are having trouble getting your attributes to work, check to make sure they are identical to the attribute being called in the roll!

Advanced Character Actions

As you can tell, these actions can make incredibly complex rolls very simple, just a click of a button. Preset your character's complicated actions for future use. Here's just an example of what you can do:

Tabletop Chat (and through inheritance, Actions) uses markdown for formatting. You can declare rolls at any point in the text. Here's some examples of input, and what their Tabletop Chat output will look like:

I attack with my sword !(1d20) and do !!(1d6+1) damage!

|  Tables are useful  |   Here's a thing  |
| :-----------------:|:--------------: |
| Attack|!!(1d20+1) |
|Attack (Advantage)|!!(1d20adv+1)|
| Damage | !!(1d6+1) |
| Crit | Add !!(1d6)|

|  Skill Check |   Persuasion |
| :-----------------:|:--------------: |
| Normal| !!(1d100<={persuasion}) |
|Hard|!!(1d100<={persuasion / 2}) |
| Extreme |!!(1d100<={persuasion / 5}) |

**Astral is not responsible for any trans-dimensional tabling that happens as a result of tables inside of tables.

Remember, you can always reach out on the Forums or Discord with any questions or comments! You can also use the bug reporting form, or drop us a line at support@astraltabletop.com if there's any problems.

Happy Adventuring!

Related Articles:
TableTop Chat