Encounter Builder

Difficulty: —

Player Characters

Avatar	Name	Gender	Level	Species	Classes	Size	PP	Hit Points	AC	Resistances	Immunities	Effects	Notes	Party

NPCs & Monsters

Token	#	Name	CR	Size	Type	Subtype	Source	Statblock	HP	Total HP	Display Name	Init Args	Init Effects

Avrae

Auto-Sync Avrae

Encounter Name Global Init Args

Add Player Characters to Initiative
Add NPCs & Monsters to Initiative

Other

Owlbear Rodeo

How to connect the Dragon Disco Owlbear Rodeo extension

In Owlbear Rodeo, open Extensions > Add Custom.
Paste the manifest URL to add this tool: https://dragondisco.com/owlbear/manifest.json
Open the extension called Dragon Disco.
Keep this page open while you edit the NPCs/Monsters. The extension updates automatically.
NOTE: you may need to disable your browser's popup blocker for https://www.owlbear.rodeo/

Avrae Combat Sync

How to set up Avrae Combat Sync

Sync live combat data from Avrae: HP, initiative order, conditions, and active effects. Requires the Dragon Disco Avrae Workshop alias and an Avrae API Token.

Just enter your Avrae API token in your Dragon Disco Owlbear Rodeo extension settings. After that you can sync the combat information from the combat tab of the extension.

During combat: use !disco eot instead of !i next to advance turns and auto-sync. Use !disco sync to push state manually, and !disco end to end combat.

Encounter Table

Dice Rolls

Encounter	Wgt.	%	Creature Type / CR	Total XP	PCs	Other Parties	Notes

About Encounter Difficulty

XP Budgets

The game defines XP budgets per character at each level for three difficulty bands: Low, Moderate, and High. Multiplying these per-character values by the number of characters produces the party’s XP thresholds for that encounter. A creature’s XP cost is summed to determine the encounter’s total XP.

Difficulty is read by comparing that total to the party thresholds: totals at or below the Low threshold are Low; totals above Low and at or below the Moderate threshold are Moderate; totals above Moderate and at or below the High threshold are High. Totals above the High threshold exceed these official categories.

Low. An encounter of low difficulty is likely to have one or two scary moments for the players, but their characters should emerge victorious with no casualties. One or more of them might need to use healing resources, however. As a rough guideline, a single monster generally presents a low-difficulty challenge for a party of four characters whose level equals the monster’s CR.

Moderate. Absent healing and other resources, an encounter of moderate difficulty could go badly for the adventurers. Weaker characters might get taken out of the fight, and there’s a slim chance that one or more characters might die.

High. A high-difficulty encounter could be lethal for one or more characters. To survive it, the characters will need smart tactics, quick thinking, and maybe even a little luck.

Extreme and Absurd are not official encounter difficulties. “Extreme” is roughly the total XP budget for an entire adventuring day for a character of a particular level; “Absurd” exceeds that.

Many Creatures

The more creatures in an encounter, the higher the risk that a lucky streak on their part could deal more damage to the characters than you expect. If your encounter includes more than two creatures per character, include fragile creatures that can be defeated quickly. This guideline is especially important for characters of level 1 or 2.

Based on guidance from the 2024 Dungeon Master's Guide ( Basic Rules, SRD 5.2.1 PDF (pg. 202-203)).
Portions of this content are derived from the D&D 5e System Reference Document (SRD 5.2.1) by Wizards of the Coast and are licensed under the Creative Commons Attribution 4.0 International (CC BY 4.0) license.

Settings

Avrae Integration

Optional settings to directly integrate Dragon Disco with Avrae. Allows automatic syncing of encounter data via Avrae User Variables (UVARs), which can be used with Avrae aliases.

Add your Avrae API Token to enable one-click exports, auto-sync, and combat tracking. Data is synced via Avrae User Variables (UVARs) automatically — no manual setup required.

Avrae API Token

Important Security & Privacy Information

Your Avrae API token is sensitive. Only enter it in a trusted browser on a device you control. Anyone who obtains this token could act as you and may gain access to your Discord account. Never store your token (or any other sensitive information) on shared or public machines.

Dragon Disco works without automatic Avrae syncing via copy+paste without the need for an Avrae API Token. If you do connect, your Avrae API Token is stored only in your browser’s local storage (that’s also how avrae.io keeps it). It’s your choice—and your responsibility—if you store it here.

If you do decide to enable direct syncing, you can take advantage of our companion Avrae Workshop alias. With it you can start combat with a single command, no copy+paste required!

How to get your Avrae API Token

Dragon Disco needs your token to sync data via Avrae User Variables (UVARs).

Open avrae.io and sign in.
Press F12 to open your browser’s DevTools.
Go to the Application tab (Google Chrome) or the Storage tab (Firefox).
Under Local Storage, select https://avrae.io.
Find the key avrae-token and copy its Value.
Paste that value into the Avrae API Token field above.

Character Sheet API Keys

Optional keys to import character sheets. Key is necessary for Dicecloud v1, may or may not be necessary for Dicecloud v2.

Dicecloud v1 API Key: can be acquired here.

Dicecloud v2 API Key

Dicecloud v1 API Key Dicecloud v2 API Key

Security note: Keys are stored only in your browser’s local storage, like the Avrae settings above. Don’t use on shared machines.

Monster Database

You can manually add entries or import from JSON/CSV (or a Google Sheet). This database powers autocomplete and encounter lookups.

Filter Monsters

Monster Name	CR	Creature Type	Subtype	Size	Hit Dice	HP	Source	Statblock	Image	Token	ID

Monster Sources

Configure mapping from short source codes to alternate sources, human-friendly names and URL templates.

Templates support tags: {name}, {id}, {source}, {alt_source}.
Templates support stackable text transforms: .lower(), .upper(), .title(), .replace("text to replace", "replacement"), .remove("text1", "text2", ...).
.remove() deletes all occurrences of each argument. It also supports a wildcard *

If a template references {alt_source} and it resolves empty, it falls back to {source}.

Examples:
https://example.com/stat/{name.lower().replace(" ", "_")}
https://img.example/{source}/{name.title()}
https://img.example/{name.remove("Red","(*)").lower().replace(" ", "_")}