Skip to main content

Using Avrae

Avrae is the Discord bot we use for dice rolls, character sheets, spells, resources, combat tracking and an impressive number of tiny conveniences that nobody remembers until they need them.

If you've just arrived and this page looks like somebody has handed you the operating manual for an airship:

You do not need to learn all of this before playing.

Really.

Learn how to make a check. Learn !qstat. Steal everything else from this page as required.

Cheatsheet

(attack)-> !a <weapon> 
(Skill check)-> !c <skill>
(Save)-> !s <save>
(Cast a spell)-> !cast <spell>
(Look up spell)-> !spell <spell>
(Look up class feature)-> !classfeat <class feature>
(Feat)-> !feat <feat>
(Long rest)-> !g lr
(Change hp)-> !g hp <number>
(Temp hp)-> !g thp <number>

First Make Sure You Are The Right Person

Avrae can hold several of your characters.

This is wonderful right up until your wizard attempts an Athletics check using your barbarian's sheet.

Check your currently active character with:

!char

You can also use the Macguffins server alias:

!ch

which helps with switching characters based on the channel you're using.

If Avrae ever gives you numbers that make absolutely no sense, checking the active character is a very good first step.

Checks & Saves

  • Make sure you have the right character loaded (use !char to check)
  • Use !save Dexterity or !s Strength to make a saving throw.
  • Use !check Athletics or !c Intelligence to make a skill check.
  • To any check or save, you can add:
    • advantage
    • disadvantage
    • -b 5 (bonus to d20)

There are also Server Snippets for common effects such as Bless and Guidance, which are considerably less annoying than remembering the dice yourself.

More on those shortly.

Combat

Attacking Things

Outside initiative, the basic attack/action command is: !a <attack> For example: !a Longsword, !a Eldritch Blast, !a Bite

The attack name generally comes from your character sheet.

If Avrae finds several similarly named options, it may ask you to choose one.

You can also attach arguments and snippets: !a Greatsword bless or !a Longsword rage

We'll explain snippets properly before you begin attaching random words to attacks and hoping for the best.

Avrae's Automated Combat

(http://avrae.io/cheatsheets/player) (Start with !i begin)

  • To enter combat, use !i cadd (stands for "initiative, character-add")
  • To attack in combat, use !i a Target Weapon (remember with "I attack Target with Weapon")
  • To any attack, you can add any of the things from the checks and saves section (adv, dis, etc) as well as:
    • -d "1d6 [piercing]" (extra damage)
  • To make attacks of opportunity, use !i aoo YourName Target Weapon
    • The requirement of your own name is because a single discord user could be running multiple combatants.

Spells

  • To cast a spell, use !cast "Magic Missile" Quotation marks are useful for spell names containing several words.
  • To cast a spell in combat at a target, use !i cast "Fire Bolt" -t Target
    • -t is a tag that indicates your target. You can add multiple by doing -t Target1 -t Target2 -t Target3, as in the case of AoE spells.
  • Sometimes, more than one option will show up for your desired spell. Pick one by following the prompt if this happens.

Rules & Lookup

A lot of 5e rules can be accessed through !rule, !class, !classfeat, !race, !monster or !condition. Check them out!

HP, Spell Slots & Resting

Avrae can track most of your basic character resources.

HP

  • You may see: !g hp
  • For more precise changes use !g hp mod -5 which causes you to lose 5 HP.
  • Meanwhile !g hp mod 5 heals 5 HP.
  • !g hp set 20 Set HP directly to 20.
  • !g hp max Return to maximum HP.
  • Macguffins also has the easier !hp server alias.

Temporary HP

  • Use !g thp 5 for 5 temporary HP.

Spell Slots

  • Macguffins provides !ss for spell-slot management.

Resting

  • Avrae itself supports !g sr and !g lr for short and long rests.
  • Macguffins also has !rest with the related aliases:
    • !hd 
    • !sr 
    • !lr 

These help reset the appropriate resources and, where relevant, spend Hit Dice.

!qstat: Our Favourite Little Status Line

If there is one Macguffins-specific Avrae command worth learning early, it is probably !qstat

It produces a compact status line containing useful information such as:

  • HP
  • AC
  • spell slots
  • class resources
  • custom counters

This is particularly useful in PbP combat because your DM can quickly see the numbers that matter without opening your entire character sheet.

For help type !qstat ?

Changing Your Displayed AC

Temporary AC changes can be reflected in !qstat.

  • Add to your normal AC using !qstat ac +2
  • Subtract from it using !qstat ac -1
  • Set a fixed AC using !qstat ac 21
  • Reset back to your normal base value using !qstat ac
  • You can even make little personal shortcuts. For example !alias shieldon qstat ac +2 and !alias shieldoff qstat ac

You are also allowed to simply remember that the spell "Shield" gives you +5 AC.

Adding a Custom Counter

If your character already has an Avrae custom counter, !qstat can display it.

For example !qstat add :crossed_swords: Fighting Spirit

The counter name needs to match the existing counter name.

This is particularly handy for characters with resources that don't otherwise appear nicely in the default output.

Timelines: The Multiverse of Hit Points

Macguffins characters sometimes participate in more than one mechanical activity at once.

For example:

  • You're halfway through a Quest;
  • Your Arena match starts;
  • Arena-you gets horribly mauled;
  • Quest-you would quite reasonably like to object to suddenly losing 63 HP in another dimension.

This is what timelines are for.

Creating Timelines

Create your normal Quest state !qt new "Main"

Create an Arena state !qt new "Arena"

Switching Between Them

Before acting in the Arena type !qt "Arena"

Your HP, resources and other tracked information now belong to that timeline.

When returning to your Quest type !qt "Main" and you're back to your Quest state.

A simple example. You begin with:

  • Main — Quest resources
  • Arena — Arena resources

Before your Arena turn type !qt "Arena" You get hit. Spend spell slots. Rage. Regret your positioning.

Later, back in the Quest you type !qt "Main" and your Quest resources are restored to the state stored on that timeline.

Get into the habit of checking which timeline you're on before changing resources.

Your DM will appreciate it.

Future-you will appreciate it.

Present-you may continue to forget occasionally and that's okay.

Back to top