Dragon Disco

Dragon Disco is a free, browser-based encounter builder for tabletop RPG game masters. Build and balance encounters with live XP and difficulty calculations, manage your monster database, export initiative commands to Avrae, and sync tokens to Owlbear Rodeo — no account or sign-in required.

Yes, completely free. If you find it helpful, you can optionally support development on Ko-fi or Buy Me a Coffee, but it is never required.

No account or sign-in needed. Your data lives in your browser's local storage. Use Export/Import to back up or move data between devices.

Dragon Disco is primarily a client-side app. All encounter and settings data is stored locally in your browser (LocalStorage/IndexedDB) — nothing is stored on Dragon Disco's servers. Export your data routinely to avoid loss if you clear browser storage or switch devices.

Join the Discord or email contact@dragondisco.com.

Donations are optional but appreciated! You can support development on Ko-fi or Buy Me a Coffee.

1. Open the Builder tab. Add your party and any enemies you want to test — difficulty and XP update live.
2. Populate your Monster Database (recommended). Go to Settings > Monster Database and import from the 5e SRD (JSON/CSV) or add entries manually. The database powers autocomplete, CR/HP/Type lookups, and faster encounter building.
3. Add your PCs. Enter each character's level and optional AC/HP. Party XP thresholds update automatically for 2024 encounter math.
4. Build and export. Use the Builder's export tools to generate Avrae commands or mirror enemies to Owlbear Rodeo. The Encounter Table lets you roll and export weighted random encounters.

Go to Settings > Monster Database and import from the 5e SRD (JSON or CSV), a Google Sheet, or add monsters manually. Fields like CR, Type, Size, HP, and URLs power autocomplete and lookups — the more data you have, the faster encounter building becomes.

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.

Go to Settings > Export to download a backup of all your data. Import it on any device to restore. Export regularly — Dragon Disco is not responsible for data lost if you clear browser storage.

Add PCs and monsters, adjust counts, and see real-time difficulty and XP. From there you can export initiative and drop commands for Avrae, or mirror token data to Owlbear Rodeo.

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 let you keep a library of weighted encounters with notes. Roll, preview, and export to Avrae quickly during play — great for random encounter tables keyed to a region or dungeon level.

Yes. Most fields can be edited in place. Press Enter to commit, or click away to cancel. For monster names, type part of the name and autocomplete will use your database to fill CR/Type fast.

By default, Dragon Disco generates copyable initiative commands you can paste directly into Discord — no token needed. For automatic sync, store your Avrae API Token in Settings > Avrae Integration and optionally enable Auto-Sync. With Auto-Sync enabled, you can use our companion Avrae Workshop alias to start combat with a single command — no copy+paste required. You can also access data synced to your Avrae User Variables (UVARs) and create your own custom aliases.

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 unchanged.

If you omit # and there are duplicates, numbering is appended automatically and may not be in sync with what Avrae expects.

Your Avrae API token is sensitive. Anyone who obtains it could act as you on Discord. Only enter it in a trusted browser on a device you control. Dragon Disco stores it in your browser's local storage only — the same way avrae.io does. It is sent to avrae.io with every request as required for authentication. Never store it on shared or public machines.

Dragon Disco works without automatic syncing via copy+paste, with no API token required. Connecting your token is your choice — and your responsibility.

Re-check your API token in Settings > Avrae Integration. If Auto-Sync is on, try a manual Sync to surface the specific error.

Add the custom extension in Owlbear Rodeo using this manifest URL:

https://dragondisco.com/owlbear/manifest.json

Then open Dragon Disco Token Importer in Owlbear and keep this Dragon Disco tab open while editing enemies — tokens update automatically.

Note: You may need to disable your browser's popup blocker for https://www.owlbear.rodeo/.

Data note: The Owlbear extension communicates with www.owlbear.rodeo and shares token and combat data with other instances of the extension in the same room, via Owlbear Rodeo's infrastructure.

When connected to the Dragon Disco Avrae Workshop alias, the Owlbear extension displays live combat data synced from Avrae: initiative order, round number, HP, conditions, and active effects for every combatant. HP bars and condition icons are overlaid directly on map tokens. Players in the same Owlbear scene can view the combat state; the GM controls what information is visible to them.

Requires an Avrae API Token and the Dragon Disco Avrae Workshop alias. One-time setup:

1. Enter your Avrae API Token in Settings > Avrae Integration and click Export to Avrae.
2. Enter your Avrae API Token in the Owlbear extension Settings tab.
3. Enable Show Combat Tab in the extension settings.

During combat:

• Use !disco eot instead of !i next to advance turns and automatically sync combat state.
• Use !disco sync to manually push the current state at any time.
• Use !disco end to end combat and clear the display in Owlbear.

Confirm you added the exact manifest URL https://dragondisco.com/owlbear/manifest.json in Owlbear Rodeo's extension settings, and that this Dragon Disco tab is open in the same browser.

Confirm your Avrae API Token is set in the Owlbear extension Settings tab and that Show Combat Tab is enabled. Use !disco sync to push state manually and check for errors in Discord. If you recently changed your Avrae account, update your token in both places.

• Avrae (avrae.io): Your API token is sent to avrae.io with every request as required for authentication. Sync features send encounter data to your Avrae User Variables (UVARs) on avrae.io.
• Owlbear Rodeo (owlbear.rodeo): The Dragon Disco extension communicates with www.owlbear.rodeo and shares token and combat data with other extension instances in the same room.
• Character sheet imports: Fetching character sheets from D&D Beyond or Dicecloud may route through a Dragon Disco CORS relay. No data is collected or stored, but the character sheet URL and ID pass through Dragon Disco's server.
• Token images: Token images may load through the third-party image proxy images.weserv.nl, which receives the original image URL.
• Google Sheets: The Google Sheets integration accesses your sheets via Google's APIs. See the full details in Legal.

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