Getting Started

Avrae is a powerful bot, but it can be pretty daunting to get everything set up! Here’s three quick steps to getting a character sheet linked with Avrae, and ready to play in a game!

Step 1: Invite Avrae to Your Server

The first step is to add Avrae to your server. Make sure you have the Manage Server permission, and head over to

Optional: Setting a Prefix

After you add Avrae, you might want to change the prefix in case other bots use the same prefix:

!prefix <prefix> - Insert any prefix you want to use based on your server (ex. !, #, $, !!, etc.)

Using Help

With the built in !help command, you get information about other commands in the bot. Here is the syntax for using help:

!help <command>

For example, !help attack will bring up the help dialog for the !attack command. Try it out for yourself!


Help will give you examples of commands you can use and information about them.

Step 2: Add a Character

Once you have your stats, think of what character you want to play and make them a sheet on D&D Beyond, Dicecloud v1, Dicecloud v2, or Google Sheets!

Once you’re done making your character, make sure it’s publicly viewable (Avrae needs to be able to see your sheet), grab the sharing URL, and follow the steps below depending on what sheet system you chose to use. You should see your character’s stats pop up in Discord!

D&D Beyond

To add a character from D&D Beyond, use the following command:



If you link your D&D Beyond and Discord accounts and your DM links your campaign to a channel, your character’s rolls made on D&D Beyond or the Player App will appear in Discord!

Dicecloud v1

To add a character from Dicecloud, use the following command:



Avrae can update your HP and consumables live on Dicecloud - share the sheet with edit permissions with avrae.

Dicecloud v2

To add a character from Dicecloud V2, use the following command:


Google Sheets

To add a character from GSheet, use the following command:



You will need to share your sheet with

Step 3: Ready to Roll

You’re ready to roll now! You can use the !check command to roll skill checks, !save for saving throws, and !attack to attack with your weapons!

For example:
  • !check arcana - rolls an Intelligence (Arcana) check

  • !save dexterity - rolls a Dexterity Save

  • !attack longsword - rolls an attack with a longsword

Next Steps

For more detailed documentation on how each command works, you can use !help <command> to view a list of supported arguments, or come join us at the Avrae Development Discord!