avrae.io

Avrae is a Discord bot built to streamline playing D&D over Discord. It combines an advanced dice roller, character sheet integration, and initiative tracking in one bot, so a group can run combat and skill checks without switching between separate tools. It is relevant if you already play D&D in a Discord server and want rolls, sheets, and turn order handled in the same text channel.

Core Features

Advanced Dice Roller

Avrae uses a custom dice parser and is described as one of the most advanced dice rollers on Discord, capable of supporting pretty much every type of roll needed to play D&D. Built-in behavior includes:

• Advantage, disadvantage, and crits
• Keeping, dropping, or rerolling dice as needed
• Exploding dice
• Bounded dice

This matters because common D&D rolls (attack rolls with advantage, Great Weapon Fighting rerolls, exploding damage dice) can be expressed directly rather than resolved by hand.

Character Sheet Integration

Avrae can read character sheets from D&D Beyond, Dicecloud, or a Google Sheet. From those sheets it automatically generates macros to roll attacks, ability checks, and saving throws. A player can then use a command to make a check, save, attack, or cast, and all necessary rolls are resolved automatically.

In practice, this means a player does not need to manually assemble a dice expression for every action — the bot pulls the relevant numbers from the linked sheet.

Initiative Tracking

The initiative tracker is a fast way to track combat in a text channel. It supports:

• Automatic combatant sorting
• HP, AC, resistance, and status effect tracking
• Integration with the character sheet manager and 5e content

That combination lets a DM run a full combat turn order in the same channel where players are already rolling.

How to Add Avrae to a Server

1. Open the invite flow on the Avrae site and select your server from the dropdown menu.
2. When prompted for permissions, ensure Read Messages, Send Messages, Embed Links, and Manage Messages are enabled.
3. Confirm the invite.

The permission set is required for Avrae to read commands, post roll results as embeds, and manage its own messages in the channel.

What to Check Before Using It

• Where your sheet lives. Integration only works with D&D Beyond, Dicecloud, or a Google Sheet — if your table uses a different sheet format, the automatic macro generation will not apply.
• Discord permissions. If the four listed permissions are not granted, the bot may not function correctly in the channel.
• Edition support. The initiative tracker references 5e content, so it is oriented toward 5th edition play.

Avrae is best suited to groups already running D&D in Discord who want dice, sheets, and combat tracking consolidated into one bot rather than spread across multiple tools.

Avrae's dice roller is built on a custom dice parser, and it covers essentially every roll type you need to run D&D over Discord. Advantage, disadvantage, and critical hits are handled automatically, and you can keep, drop, or reroll individual dice. Dice can also explode or be bounded. If your table plays on Discord and you want one bot to handle the full range of D&D rolls, this is the feature to evaluate first.

The core capabilities

Avrae describes its roller as "one of the most advanced dice rollers on Discord," capable of supporting "pretty much every type of roll needed to play D&D." The specific mechanics it lists are:

• Advantage and disadvantage — built in, so you don't need to manually roll twice and compare.
• Critical hits — also built in, which matters for attack rolls and damage.
• Keep, drop, and reroll — you can retain or discard dice from a pool, or reroll them as needed.
• Exploding dice — dice that trigger additional rolls under the conditions you set.
• Bounded dice — dice rolls constrained within a defined range.

That combination is what separates it from a plain 1d20 roller. A standard bot resolves a single expression; Avrae's parser is designed to express the modifiers and edge cases that come up in actual play.

Why the parser matters more than the dice

The value here isn't any single mechanic — it's that the parser can express them together. In practice, a D&D roll is rarely just "roll a d20." It's a d20 with advantage, plus a modifier, with a damage pool that might reroll low dice, and a crit that doubles part of it. A roller that only handles the first part pushes the rest back onto the players.

Because Avrae's parser supports keep/drop/reroll, exploding, and bounded dice alongside advantage and crits, those compound rolls can be expressed rather than assembled by hand. That's the practical difference between "a dice bot" and "a dice roller you don't outgrow."

Where the dice roller connects to the rest of the bot

The roller doesn't operate in isolation. Avrae can read character sheets from D&D Beyond, Dicecloud, or a Google Sheet, and automatically generates macros to roll attacks, ability checks, and saving throws. A player then uses a command to make a check, save, attack, or cast, and all the necessary rolls resolve automatically.

So the advanced dice parser is the engine underneath the sheet integration: when you trigger an attack from your character sheet, the rolls it produces are being resolved by this same roller. The initiative tracker builds on the same foundation — it supports automatic combatant sorting, HP, AC, resistance, and status effect tracking, and integrates with the character sheet manager and 5e content.

What you need to get started

To use any of this, Avrae has to be in your Discord server. The site's connection instructions are:

1. Invite Avrae to your server via the invite link on the site.
2. Select your server in the dropdown menu.
3. Ensure Read Messages, Send Messages, Embed Links, and Manage Messages are enabled.

Those four permissions are what the bot needs to post and manage its messages in your channel. If a roll or tracker command seems to do nothing, missing permissions are the first thing to check.

When this fits your table

Avrae's dice roller is a good fit if you play D&D on Discord and want rolls resolved inside the chat rather than in a separate tool, and if your rolls regularly involve advantage, crits, or keep/drop/reroll decisions that a basic bot can't express. It's also the natural choice if you already keep a character sheet on D&D Beyond, Dicecloud, or Google Sheets, since the sheet integration feeds directly into the roller.

It's less relevant if you play in person or on a virtual tabletop with its own built-in dice, or if your table only ever needs plain unmodified rolls — in that case the advanced parser is capability you won't use.

Avrae's initiative tracker is a combat-management tool that runs inside a Discord text channel. It keeps a live turn order for the encounter, sorts combatants automatically, and tracks the numbers that change during a fight — HP, AC, resistances, and status effects. It also connects to Avrae's character sheet manager and 5e content, so the same bot that rolls your attacks can also run the battle they happen in. It's built for D&D played over Discord, where there's no tabletop to hold tokens or a physical tracker to write on.

What the tracker actually does

The initiative tracker is described as "a fast way to track combat in a text channel." In practice, that means one message or embed in the channel becomes the shared source of truth for the encounter: who is in the fight, whose turn it is, and what condition everyone is in.

Its stated capabilities are:

• Automatic combatant sorting — once initiative is rolled, the tracker orders participants rather than making you maintain a list by hand.
• HP tracking — damage and healing are applied to combatants as the fight progresses.
• AC tracking — armor class is recorded per combatant, so hit or miss can be resolved against a known number.
• Resistance tracking — resistances are tracked, which matters when damage type determines whether a hit is halved.
• Status effect tracking — conditions such as the ones that expire after a set number of rounds can be followed in the same place as the turn order.

Because all of this lives in the text channel, every player sees the same state without anyone asking "whose turn is it?" or "how much HP does that thing have left?"

Why the integration matters more than the tracker alone

A standalone initiative list is just a sorted set of names. The reason Avrae's tracker is useful is that it's wired into the rest of the bot.

Avrae reads character sheets from D&D Beyond, Dicecloud, or a Google Sheet, and from those sheets it automatically generates macros for attacks, ability checks, and saving throws. A player can then run a command to make a check, save, attack, or cast, and the necessary rolls resolve automatically.

The tracker integrates with that same character sheet manager, plus 5e content. The practical result: when a combatant's turn comes up, the rolls that belong to that turn can be produced by the same system that is holding the turn order. You aren't copying numbers between a roller and a tracker.

A concrete example

Say four player characters and three goblins are in a fight in a text channel.

1. Initiative is rolled for everyone in the encounter.
2. The tracker sorts the combatants into turn order automatically, so the sequence is fixed and visible.
3. On a player's turn, they use their character's generated macro to attack. The roll resolves against the target's AC, which the tracker is holding.
4. Damage is applied to the target's HP. If the target has resistance to that damage type, the resistance the tracker records is what determines the final number.
5. If a condition is applied — something that lasts a set number of rounds, for instance — it's tracked alongside the combatant rather than in a separate note.
6. When the round ends, the order is already there for the next round, with no re-sorting needed.

The value shows up in the moments that normally stall a game: checking a defense, remembering a condition, or working out whose turn is next.

What you need before it works

• A Discord server where Avrae has been invited. The site's invite flow asks you to select your server from a dropdown and to ensure that "Read Messages," "Send Messages," "Embed Links," and "Manage Messages" are enabled. Those permissions are what let the bot post and maintain the tracker in the channel.
• A text channel to run combat in — the tracker is designed for text channels, not voice.
• Character sheets, if you want the automatic macro generation. Avrae reads from D&D Beyond, Dicecloud, or a Google Sheet. Without a connected sheet you lose the automatic attack, check, save, and cast rolls, though the tracker itself is still a combat tracker.

Where it fits in a game

Use Avrae's initiative tracker when you're running D&D over Discord and want combat state — order, HP, AC, resistances, and conditions — to live in one place that every player can see. It's most valuable in encounters with several combatants and multiple conditions, where manual tracking gets error-prone.

It's less necessary for a single quick skirmish with one or two combatants, where the overhead of setting up the encounter may exceed the benefit. And if your group plays in person or on a virtual tabletop with its own combat tracker, Avrae's tracker is solving a problem you may already have solved elsewhere.

Avrae reads your character sheet from D&D Beyond, Dicecloud, or a Google Sheet, then automatically generates macros for attacks, ability checks, and saving throws. Once a sheet is connected, you run a command for the check, save, attack, or spell you want, and Avrae resolves every roll involved without you entering the numbers by hand. This works for any D&D game you play over Discord where your sheet lives in one of those three sources.

Supported Sheet Sources

Avrae pulls character data from three places:

• D&D Beyond — the official digital toolset for 5e content.
• Dicecloud — a third-party character sheet service.
• Google Sheets — a sheet you maintain yourself in a specific format Avrae can read.

The source you pick determines where you make edits. If you update your character on D&D Beyond, Avrae sees the change on the next sync rather than you re-entering anything into Discord.

What Avrae Generates From Your Sheet

After reading the sheet, Avrae builds macros for the rolls your character actually makes:

Because these macros come from the sheet, the modifiers reflect your current character rather than a value you typed once and forgot to update.

How a Roll Resolves

1. Your sheet is connected to Avrae.
2. You issue a command for the action — a check, save, attack, or cast.
3. Avrae looks up the relevant modifier or attack entry on the sheet.
4. It rolls the dice and applies the modifier automatically.
5. The result posts in the Discord channel.

The practical effect: instead of rolling a d20 and adding your bonus yourself, you name the action and Avrae returns the finished number. Advantage, disadvantage, and crits are handled by the dice engine, so those cases resolve inside the same command.

Why This Matters at the Table

Manual rolling slows a text channel down — someone rolls, waits, adds a modifier, and posts again. Sheet integration collapses that into one step, and it keeps the math consistent because the modifier comes from the sheet rather than from memory. It also feeds the initiative tracker, which supports automatic combatant sorting along with HP, AC, resistance, and status effect tracking, so combat state and character state stay connected.

Connecting Avrae to Your Server

Before any of this works, Avrae has to be in your server. Invite it through the link on avrae.io, select your server from the dropdown, and enable these permissions:

• Read Messages
• Send Messages
• Embed Links
• Manage Messages

If rolls don't post or commands seem to do nothing, missing permissions are the first thing to check — particularly Send Messages and Embed Links, since results are delivered as embedded messages.

Common Snags

• Sheet not linked. Macros only exist after the sheet source is connected; a fresh Avrae with no sheet has nothing to roll from.
• Stale data. If you edit the sheet, expect Avrae to reflect it on the next sync, not instantly mid-command.
• Wrong source format. A Google Sheet has to match what Avrae expects to read; an arbitrary spreadsheet won't parse.
• Permission gaps. Manage Messages matters for the bot's channel behavior, so don't skip it during setup.

The short version: connect one of the three supported sheets, let Avrae generate the macros, and then run commands instead of doing arithmetic. The setup cost is a one-time invite and link; the payoff is every subsequent roll resolving in a single step.

You connect Avrae by opening its invite link, selecting your server from the dropdown menu, and confirming that four permissions are enabled: Read Messages, Send Messages, Embed Links, and Manage Messages. You need the "Manage Server" permission on that Discord server to add any bot, and Avrae must be allowed to read and post in the channels where you plan to use it. Once invited, Avrae is immediately available to run commands in those channels.

Before You Start

Two conditions determine whether the invite will work:

• Your Discord role. Only members with the Manage Server permission can authorize a bot. If you don't have it, ask a server admin to complete the invite or grant you the role.
• A target server. You must be a member of the server you're adding Avrae to, and it should appear in the invite dropdown.

Step-by-Step: Inviting Avrae

1. Open the invite link. On avrae.io, the "Connect Avrae" section provides the invite. Select it to launch Discord's authorization page.
2. Choose your server. Use the dropdown menu to pick the server you want Avrae in. If a server is missing, you either aren't a member or lack permission to add bots there.
3. Confirm the permissions. Discord lists the permissions Avrae is requesting. The site specifies that Read Messages, Send Messages, Embed Links, and Manage Messages should be enabled. Leave them checked.
4. Authorize. Submit the form. Discord returns you to the server, and Avrae appears in the member list.
5. Verify it works. In a text channel, run a basic command. If Avrae responds, the connection is complete.

What Each Permission Does

If any of these are missing, Avrae may join the server but fail to respond or display results correctly. You can adjust them afterward in Server Settings → Roles by editing Avrae's role, or per-channel in the channel's permission overrides.

After Connecting

Avrae is a Discord bot for playing D&D online, and its main features become usable as soon as it's in the server:

• Advanced dice roller — a custom dice parser that handles advantage, disadvantage, crits, keep/drop/reroll, exploding dice, and bounded dice.
• Character sheet integration — reads sheets from D&D Beyond, Dicecloud, or a Google Sheet, then auto-generates macros for attacks, ability checks, and saving throws.
• Initiative tracking — sorts combatants automatically and tracks HP, AC, resistance, and status effects, tying into the character sheet manager and 5e content.

Common Snags

• Server not in the dropdown. You're not a member, or you lack Manage Server. Have an admin run the invite instead.
• Avrae joins but stays silent. Check that Read Messages and Send Messages are enabled in that specific channel — channel-level overrides can block a bot even when server-level permissions allow it.
• Commands produce plain text instead of formatted cards. Embed Links is likely disabled; re-enable it in Avrae's role permissions.
• Tracker output clutters the channel. Manage Messages lets Avrae clean up after itself, so keep it enabled if you plan to use initiative tracking.