Skip to main content

Feats, Backgrounds, Classes, Species

How to import Character Options into a Compendium

Availability​

This feature is available to Undying and God tier Patreon supporters.

KNOWN ISSUES​

Known Issues
  • Spells from features are not always granted as part of advancements. You may need to add them manually for now.
  • Third party subclasses and classes have not been thoroughly tested. You can let me know of broken features on discord and I will get them fixed.
  • If you wish to pull content from a shared campaign, your mule character must be part of that campaign when you run the muncher. It won't add to the campaign used in the module settings.

Prerequisites​

Ensure you have done the initial setup and imported Spells and Items.

If you haven't imported Spells and Items first, they won't be usable by these options.

When importing character options, always import Feats first.

Open the DDB Muncher​

On the right hand side of Foundry click the Compendium section (looks like a book with a world on it). Then click DDB Muncher.

Muncher Location

The Muncher will check that it can authenticate you to D&D Beyond, sometimes this screen won't open, see the FAQ for a fix.

General Settings​

Muncher Settings

  • Update Existing Things? If checked DDB Importer will update any existing items already imported, otherwise it will just create missing items.
  • Faster Updates? This option will make updates faster, but it will delete your existing compendium items rather than updating them. Useful if you have not made any changes.
  • Use inbuilt icons? This will add icons to imported things (monster features, items, spells), from a built in dictionary. Highly recommended.
  • Use SRD icons? This will use icons from the SRD Compendiums. This can add a considerable time to your import. Some people have problems with this feature.
  • Cauldron of Plentiful Resources automation? This will replace effects with those from the popular Cauldron of Plentiful Resources module. This is a high automation module that is often not compatible with the latest Foundry or D&D system version. Please read about it and understand what it does before you install and enable this module.
  • Legacy postfix? Adds (Legacy) to the end of Legacy monsters, spells and items.
  • Add DDB Snippets to Activities? Adds D&D Beyond's short snippet to newly imported activity cards. Re-import to add or remove snippets.

Character Settings​

DDB Importer currently uses the settings set up when you import a character. Adjust these on the Character import screen.

Filtering Scope/Sources​

You can filter the scope of the content imported using the Settings -> Sources tab:

Muncher Sources

  • Included Flavour Profiles (Categories) These are the Source categories in DDB, they often contain multiple books. Categories selected here will be included.

See Filtering Sources for more about categories and the Sources and Cache window.

Importing Features​

Click on the Munch -> Characters -> Settings tab and you should see a screen like this:

Character Feature Munch Tab

To import character features and classes you need to sacrifice a character (a "mule") to the Old Gods. Paste its D&D Beyond URL into the URL box.

danger

The mule character will be wiped and left in an empty state. Please don't use a beloved character.

If you wish to import content from a Shared Campaign, make sure the mule character is part of that campaign before you munch.

  • Include Homebrew? Also fetch homebrew content you have access to on D&D Beyond, alongside official sources.
  • Homebrew only? Skip official sources entirely and munch only your homebrew content.
  • Import Optional Class Features? Include optional class features (e.g. those from Tasha's Cauldron of Everything), filtered by your selected sources.
  • Don't grab existing things? Species, subclasses, feats and backgrounds already in your compendiums are hidden from the pickers and skipped, so only missing content is fetched.

Then use the Feats, Backgrounds, Species and Classes tabs, in that order. Always import FEATS first, as these are used by other options.

Each tab has a Rules Version toggle, and only content matching the selected rules version (2014 or 2024) is imported.

Character Class Munch Tab

  • Species Optionally select specific species to munch. Leave the picker empty to import all species of the selected rules version from your enabled sources.
  • Classes Select at least one class to munch, or click Select Core Classes. Optionally pick specific subclasses for each class. Leave a class's subclass picker empty to import all its subclasses.

If the species or subclasses you expect are not listed, make sure you have the correct source categories enabled in Settings.

Please note this takes a LONG time and you should keep the browser window in focus.

danger

It's strongly recommended that you import only 1 or 2 source categories at a time.