Dragon Disco

Encounter Builder

Difficulty: —

Player Characters

Avatar	Name	Level	Species	Classes	PP	Hit Points	AC	Resistances	Immunities	Notes

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

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.

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 exporting of encounter data to an Avrae GVAR, which can be integrated with Avrae aliases.

Add your Avrae API Token and a GVAR ID to enable one-click exports and auto-sync. PCs and enemies are exported as JSON along with formatted initiative commands. You can access this data in any custom Avrae alias.

Avrae API Token GVAR ID

IMPORTANT: 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 directly write to an Avrae Global Variable (GVAR).

Open avrae.io and sign in.
Press F12 to open your browser’s DevTools.
Go to the Application tab.
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; Dragon Disco will use it from your browser.

How to get a GVAR ID

Open the Avrae GVAR dashboard.
Scroll to the bottom and click Create New GVAR.
Put any text in the Value field (it cannot be empty), then click "Done".
Copy the GVAR ID shown for the new entry.
Paste that ID into the GVAR ID field above.

Dragon Disco will write encounter exports to this GVAR in JSON to use in custom aliases.

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 some basic (stackable) text transformations: .lower(), .upper(), .title(), .replace("text to replace", "replacement").

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()}

About & Documentation

About Dragon Disco

Dragon Disco is a fast, client-side encounter assistant for 5e that plugs into tools you already use. Your data lives in your browser; nothing is stored on our servers. Use Export/Import to back up or move between devices.

Contact

Questions, feedback, or bug reports? Email contact@dragondisco.com.

Getting Started

1) Open the Builder

Go to the Builder tab. Add your party and any enemies you want to test. You’ll see difficulty and XP update live.

2) Import or Add Monsters (Recommended)

Dragon Disco works best when your Monster Database is populated. Import from the 5e SRD (JSON/CSV) or add your own entries in Settings → Monster Database. The database powers autocomplete, CR/HP/Type lookups, and faster encounter building.

3) Add PCs

Enter each character’s level (and optional AC/HP). Party thresholds update automatically for 2024 encounter math.

4) Build & Export

Use the Builder’s export tools to generate Avrae commands or mirror enemies to Owlbear Rodeo. You can also use the Encounter Table for weighted random encounters and one-click exports.

Core Features

Encounter Builder

Add PCs and monsters, adjust counts, and see real-time difficulty. Export initiative and drop commands for Avrae, or mirror to Owlbear.

Avrae: Initiative Name Replacements

You can customize names that appear in Avrae using tokens in the Display Name field:

# – sequential number for duplicates (e.g., Goblin # → Goblin 1, 2, …)
%I% – initials from the monster name (e.g., “Ice Mephit” → IM)
%T% – creature type; %ST% – subtype; %ST-T% – subtype or type if no subtype
%FW%/%LW% – first/last word; %FI%/%LI% – first/last initial
%DFW%/%DLW% – drop first/last word
%S% – size
%TAG% – auto initials of the final rendered name (also usable in Init Effects)
Special: set Display Name to * to use the original name.

If you do not include # and there are duplicates, numbering is appended automatically and may not be correctly in sync with what is expected by Avrae.

Note: The Display Name field in the Enemies table controls both the names used in Avrae initiative commands and the token name labels in Owlbear Rodeo.

Encounter Tables

Keep a library of weighted encounters with notes. Roll, preview, and export quickly during play.

Monster Database

Import SRD or custom data (JSON/CSV/Sheets) or add manually. Fields like CR, Type, Size, HP, and URLs power autocomplete and lookups. The more data you have, the faster encounter building becomes.

Custom Monsters

For custom monsters, Dragon Disco works best when those monsters also exist in Avrae. Create them with Bestiary Builder, export to JSON and import here, then import the bestiary into Avrae (!help bestiary) so names match and initiative commands work as expected.

Avrae Integration

By default, Dragon Disco generates copyable initiative commands, which you can then paste them into Avrae. If you prefer direct sync, store your Avrae API Token and an Encounter GVAR in Settings and (optionally) enable Auto-Sync to push updates automatically. With this enabled, you can take advantage of our companion Avrae Workshop alias, which allows you to start combat with a single command. No copy+pase required! You can also access the data stored in your Avrae GVAR and create your own custom aliases.

Owlbear Rodeo

Add the custom extension in Owlbear Rodeo with this manifest URL: https://dragondisco.com/owlbear/manifest.json. Then open Dragon Disco Token Importer in Owlbear and keep this page open while editing monsters—tokens update automatically.

Settings & Data

Configure themes, integrations, and data. Everything is stored locally in your browser; use Export/Import to back up regularly.

Tips & Shortcuts

Quick Add

Type part of a monster name; autocomplete uses your database to fill CR/Type fast.

Inline Editing

Most fields can be edited in place; press Enter to commit or click away to cancel.

Troubleshooting

Owlbear extension isn’t connecting

Confirm you added the exact manifest URL https://dragondisco.com/owlbear/manifest.json and that this page is open.

Avrae export failed

Check your API key and GVAR in Settings. If Auto-Sync is on, try a manual export to see any errors.

Import issues

Make sure your JSON/CSV follows the expected fields. You can always add or fix entries manually after import.

Privacy & Data

Dragon Disco is a static, client-side app; we don’t host your content. Your data is stored locally (e.g., LocalStorage/IndexedDB). Export your data routinely to avoid loss if you clear your browser storage or switch devices.

Legal & Acknowledgments

This page explains disclaimers, privacy, licensing, trademarks, and attributions used by Dragon Disco.

Warranty, Liability & Use

General Disclaimer

Dragon Disco is provided on an “AS IS” and “AS AVAILABLE” basis, without warranties of any kind—express, implied, or statutory—including but not limited to implied warranties of merchantability, fitness for a particular purpose, title, and non-infringement. You assume all risk for your use of the site and any outputs or data produced by it.

Limitation of Liability

To the maximum extent permitted by law, the authors and contributors will not be liable for any indirect, incidental, special, consequential, exemplary, or punitive damages, or for any loss of data, revenue, or profits, arising from or related to your use of Dragon Disco—even if advised of the possibility of such damages.

Terms of Use

Dragon Disco lets you import, edit, and export data on your device. You’re responsible for ensuring you have the rights to any content you use. Exports to Avrae, Owlbear Rodeo, or other services are governed by those services’ terms and privacy policies; inclusion here is for interoperability and does not imply endorsement.

Data Storage & Backups

Data is stored only in your browser. We can’t restore it if it’s lost (e.g., clearing storage, private browsing, different device/profile). Use Export regularly to make your own backups.

Security Disclosure

If you discover a security issue, please email dragondisco@katzeye.me. Don’t publicly disclose until we’ve had a chance to address it.

Age

Dragon Disco is not directed to children under 13. By using the site you represent you’re 13+ (or the minimum age in your region).

Trademarks & Attribution

Dragon Disco is an independent tool and is not affiliated with, associated with, authorized by, endorsed by, or in any way officially connected with Wizards of the Coast, Owlbear Rodeo, or any other party. All trademarks, service marks, and trade names remain the property of their respective owners and are used here for identification and descriptive purposes only. Marks are used solely to indicate compatibility or interoperability (nominative fair use) and do not imply endorsement.

Dungeons & Dragons and D&D are trademarks of Wizards of the Coast LLC.
D&D Beyond and Avrae are properties/trademarks of Wizards of the Coast LLC.
Owlbear Rodeo is a trademark of Owlbear Rodeo.

SRD (Creative Commons)

Portions of this site may integrate and/or adapt content from, and/or optionally import content based on, the System Reference Document versions 5.1, 5.2.1, and/or future versions published by Wizards of the Coast under the Creative Commons Attribution 4.0 International License (CC BY 4.0). Changes have been made, and use of SRD content does not imply endorsement by Wizards of the Coast. For reference, see the SRD page on D&D Beyond.

This work includes material from the System Reference Document 5.2.1 (“SRD 5.2.1”) by Wizards of the Coast LLC, available at https://www.dndbeyond.com/srd. The SRD 5.2.1 is licensed under the Creative Commons Attribution 4.0 International License, available at https://creativecommons.org/licenses/by/4.0/legalcode.

This work includes material taken from the System Reference Document 5.1 (“SRD 5.1”) by Wizards of the Coast LLC and available at https://dnd.wizards.com/resources/systems-reference-document. The SRD 5.1 is licensed under the Creative Commons Attribution 4.0 International License available at https://creativecommons.org/licenses/by/4.0/legalcode.

Avrae

Avrae is open-source software. Dragon Disco does not include Avrae source code; references to Avrae are descriptive for interoperability (e.g., “Export to Avrae”) and do not imply endorsement. “Avrae” is a property of Wizards of the Coast LLC.

Owlbear Rodeo

Dragon Disco may format data for use with Owlbear Rodeo. “Owlbear Rodeo” and related marks are the property of their respective owners. Any use is descriptive and does not imply endorsement. For extensions and API information, see the Owlbear Rodeo documentation.

Tabler Icons (MIT License)

Show MIT License

              MIT License
              Copyright (c) 2018-2025 Tabler

              Permission is hereby granted, free of charge, to any person obtaining a copy
              of this software and associated documentation files (the “Software”), to deal
              in the Software without restriction, including without limitation the rights
              to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
              copies of the Software, and to permit persons to whom the Software is
              furnished to do so, subject to the following conditions:

              The above copyright notice and this permission notice shall be included in
              all copies or substantial portions of the Software.

              THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
              IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
              FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
              AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
              LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
              OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
              THE SOFTWARE.

Copyright Concerns & Takedown

For copyright concerns, email dragondisco@katzeye.me with the URL, a description of the material, and proof of ownership. We’ll review and respond promptly.

Privacy & Data Collection

Dragon Disco is a static, client-side application with no server-side account system. App data (such as your configuration, tables, or encounters) is stored locally in your browser (e.g., LocalStorage/IndexedDB) and remains under your control. Clearing your browser storage or using a different browser/device may remove or isolate that data. Import/export features operate on your device; data is only shared when you explicitly choose to export or paste it elsewhere. This site itself does not transmit your app data to the authors.

Standard logs and analytics may be collected.

Project Status & Donations

If you find Dragon Disco helpful, you can support development on Ko-fi: ko-fi.com/lyrakatz. Donations are optional but appreciated!