A handy cheatsheet and tutorial for using the Discord bot Avrae. https://avrae.io

avrae cheatsheet.md

Roll some dice: !roll 1d12+3 adv

---

^{A linked character sheet is needed to run commands in the following table.}

Action	Avrae command
Ability check	!check perception
Initiative roll	!check init
Saving throw	!save wisdom
Death save*	!save death
Attack	!attack longsword
Cast a spell	!cast fireball

*Avrae's deathsave counter automatically resets if you gain any hit points. To manually reset the counter: !game deathsave reset

---

Using the Initiative Tracker

Action	Avrae command	DM?	Player (on turn)?	Anyone else?
Start tracking initative	!init start	✓
Join the initiative order	!init join		✓	✓
Add a monster to initiative	!init madd "monster"	✓
List the current order and whose turn it is	!init list	✓	✓	✓
Opportunity Attack	!init aoo "combatant name" "attack name" -t "target name"	✓	✓	✓
Cast a spell as a reaction	!init reactcast "combatant name" "spell name"	✓	✓	✓
Move to the next turn in the initiative	!init next	✓	✓
End initiative	!init end	✓

avrae tutorial.md

Table of Contents

1. Player Reference
   1. Linking a Character Sheet
   2. Flags and Arguments
   3. Basic Character Commands
      1. Ability Checks
      2. Saving Throws
      3. Attack Rolls
      4. Spellcasting
   4. Resting and Recharging
   5. Initiative and Combat
      1. Attacking and Casting
      2. Other Actions
      3. Using Your Reaction
2. Dungeon Master Reference
   1. Using the Initiative Tracker

Player Reference

Roll some dice:

# Format: !roll <dice>
!roll 1d12+3
!r 1d12+2

Add advantage/disadvantage to a roll:

# adv       Roll with advantage.
!attack longsword adv
!check perception adv

# dis       Roll with disadvantage.
!save wisdom dis
!check arcana dis

Linking a Character Sheet

Linking a character sheet is needed for many of Avrae’s features. This will allow you to roll directly for things, and saves you the trouble of having to remember your modifiers: !check arcana, !save dexterity, !attack longsword

To link a D&D Beyond character to the bot:

!beyond https://ddb.ac/...

To update the bot's version of your character from your sheet (e.g. after a level-up)

!beyond update

Using Purchased Content: To use purchased content (e.g. casting spells, reference feature text) with Avrae, you'll need to link your Discord account to your D&D Beyond account as a one-time thing. This can be done from your account settings page.

Flags and Arguments

Most Avrae commands have additional features that can be unlocked with the use of flags and arguments.

Flags (sometimes called switches) come after basic form of the command, and follow a set format, such as -rr 3 and -t Goblin. Flags are specific to their command.

Commonly used flags for commands will be listed under that command's tutorial block.

Arguments go at the very end of a command, are usually a few letters long, and are mostly universal.

Here are some common arguments:

# adv       Roll with advantage.
!attack longsword adv
!check perception adv

# dis       Roll with disadvantage.
!save wisdom dis
!check arcana dis

To learn about all of the available options for a command, run !help [command].

Basic Character Commands

Ability Checks

# Format: !check <skill/ability/"initiative">
!check arcana
!check wisdom
!check initiative  # Rolls for initiative
!c perc

Saving Throws

# Format: !save <ability/"death">
!save wisdom
!save death        # Rolls a death save.
!s dex

# To reset Avrae's death save counters manually (automatically done when you heal HP):
!game deathsave reset

Attack Rolls

Rolls for both attack and damage at once.

# Format: !attack "weapon"
# If the weapon's name is more than one word, it needs to be in quotes.
!attack longsword
!attack "unarmed strike"
!a halberd

# -rr #              Roll multiple times, such as for Multiattack or Extra Attack.
!attack longsword -rr 2

# -ac #              Specify an AC to hit against. Only rolls for damage on hit.
!attack longsword -ac 14

# -t "combatant"     Targets the specified combatant. Avrae will roll against the target's AC, and
#                    if the attack hits, apply the damage to the target's current HP. Also tracks
#                    length of effects, e.g. "until the end of its next turn." Can be repeated for
#                    multiple targets of the same attack. Mostly used with Avrae's initiative
#                    tracker.
!init attack longsword -t "Goblin 1"

Spellcasting

# Format: !cast "spell"
# If the spell's name is more than one word, it needs to be in quotes.
!cast fireball
!cast "healing word"

# -i           Ignores spell slots and spellbooks, e.g. casting as a ritual or item.
!cast wish -i
# -l #         Specifies the level to cast the spell at.
!cast fireball -l 9

# -rr #        Roll multiple times, such as for a warlock's multiple Eldritch Blasts.
!cast "eldritch blast" -rr 3

# -t "combatant"        Targets the specified combatant. Avrae will have the target make the saving
#                       throw, and if the attack hits, apply the damage to the target's current HP.
#                       Can be repeated for multiple targets of the same attack. Mostly used with
#                       Avrae's initiative tracker.
!init cast fireball -t "Goblin 1" -t "Goblin 2" -t "Goblin 3" -t "Goblin 4"

# -with <int/wis/cha>   Uses a different skill base for DC/AB (will not account for extra bonuses)
!cast "burning hands" -with cha

Resting and Recharging

Take a short or long rest:

!game shortrest
!game longrest

Manually edit your character’s available spell slots:

# Format: !game spellslot <slot level> <+/-><number of slots>
!game spellslot 5 +2
!g ss 5 +2

Initiative and Combat

Once the DM starts the initiative tracker, players can the !init command.

Add your character to the initiative order:

!init join

End your turn and advance to the next combatant:

!init next

List the current order:

!init list

Attacking and Casting

On your turn, you can use special attack and cast commands. They work largely like !attack and !cast, but the -t flag can now be used to target other combatants in initiative, and works with the built-in HP tracking.

# Format: !init attack "attack name" -t "target"
!init attack "longsword +1" -t "Goblin 1" -rr 2

# Format: !init cast "spell name" -t "target"
!init cast "fireball" -t "Goblin 1" -t "Goblin 2" -t "Goblin 3"

Other Actions

Grapple a target or escape a grapple:

!grapple -t "target"
!escape

Shove someone:

!shove -t "target"

Roll a concentration check:

!conc

# -dc #          Set the DC for the check. Returns a simpler "Success!" or "Fail!" dialog.
# -t "target"    Specify who is making the check.
!conc -dc 15 -t "Mind Flayer"

Using Your Reaction

Opportunity attacks:

// Format: !init aoo "attacker name" "attack name" -t "target name"
!init aoo "Dundan Hammerfist" "greataxe" -t "Goblin 1"

Cast a spell as a reaction:

# Format: !init reactcast "caster name" "spell name" -t "target name"
!init reactcast "Dundan Hammerfist" "fireball" -t "Goblin 1" -t "Goblin 2" -t "Goblin 3"

Dungeon Master Reference

Using the Initiative Tracker

Start/end the initiative tracker:

!init begin
!init end

To skip ahead to a turn, use

!init goto <target>

Add a monster to initiative:

# Format: !init madd "monster name"
!init madd "Goblin"

# -n #         Add multiples of the same monster
!init madd "Goblin" -n 4

# -group "Group Name"     Add the monster(s) to the named group. Groups act on the same initiative.
!init madd "Goblin Archer" -group "Goblins"

# -name "name"            Use a custom name for this monster
!init madd "Goblin Berserker" -name "Ungobs the Terminally Stupid"

# -h           Don't hide HP, AC, etc. from players (e.g. for allies)
!init madd "Noble" -h

Modify the HP of combatants in combat:

# Using !init hp
!init hp "combatant" +12         # heal
!init hp "combatant" -5          # damage
!init hp "combatant" set 37      # set current HP
!init hp "combatant" max         # fully heal
!init hp "combatant" max 96      # set max HP

# Using !init opt
!init opt "combatant" -hp +12    # heal
!init opt "combatant" -hp -5     # damage
!init opt "combatant" -hp 37     # set current HP
!init opt "combatant" -max 96    # set max HP

To show the condition of only one player/monster, use:

!init status "name"

Notes may be attached to a player/monster in the list by using:

!init note "name" "note"

Conditions may be attached in a similar way by using:

!init effect "name" "effect name"

To see a monster’s attack list, use

!ma "monster"