D&D Beyond Importer

Import your dndbeyond.com characters into Foundry Virtual Tabletop.

This module:

Import your DDB characters into Foundry, and sync changes back!
Import a characters extras such as Wildshapes or beast companions.
Bulk import spells.
Bulk import items.
Patreon supporters can bulk import monsters.
Can bulk import simple class, race and feat descriptions.
When you import a Cleric or Druid it will import all your spells.*

In addition you can:

Use the built in dictionary to get a large icon coverage during import.
Use supplied SRD items where available.
Choose to use matching SRD icons.
Apply effects from DAE or DAE SRD.
Attempt to auto-generate effects for items.

Examples

What's the catch?

Calls to dndbeyond are proxied to provide authentication and to bypass CORS checks.

The proxy calls dndbeyond with your credentials to fetch your data.

To get all your spells and do bulk importing you need to set the Cobalt Cookie setting to the value of your D&DBeyond CobaltSession cookie. See my helper Chrome extension to help.

Do NOT give your cookie to other people, this is like handing out a password to your dndbeyond account.

We do not store your cobalt cookie on the server.

To logout/invalidate these credentials log out of your D&DBeyond Session.

Notes

You CAN use this alongside the vtta-dndbeyond extension.

Support

Where can you support me? See my Patreon.

You can log bugs here, or mention them in the Discord channel.

Pre-requisites and recommendations

I'd recommend installing:

Magic Items for attaching spells to magic items
DAE or Skill Customization for D&D5E for skill bonuses

SRD Import Notes

Some detail will be lost:

Any auto configuration of Magic Item spells
Any custom damage modifications from things like Fighting Styles and Improved Divine Smite

Some details are updated, if applicable:

number of uses
quantity of items
attuned status
equipped status
resource tracking
spell preparation status
proficiency

Configuration

Avatar upload directory

Sets the icon directory where you are storing your avatar image uploads. It's relative to the Foundry /Data directory, please do not add a leading or trailing slash to this path.

Examples:

img/uploads references to [Foundry]/Data/img/uploads
uploads references to [Foundry]/Data/uploads
`` references to [Foundry]/Data - not recommended

FAQ

Why do my compendium features not get updated on import?

This is a different feature to vtta-dndbeyond, use the bulk import tool to import features, spells and items.

The import buttons are greyed out!

They require the cobalt token setting to be set. Remember don't share this token with anyone, it can be used to access your DDB account.

Clerics and Druids don't get their un-prepared spells

You need to have the cobalt token set to get these spells.

Known Issues

Magic Items don't have spells attached

When you use the Magic Items module and Munch Items the spells are not attached to the Item. This is a tricky issue and parsing these things out of the item text takes time as they are not exposed as an attached object to the item.

laquasicinque/ddb-importer