Skip to main content

Character Options

How to import Character Options into a Compendium

Availability

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

BETA ISSUES

Known Issues
  • Spells from features are not currently granted as part of advancements. You will 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.
  • Some class proficiencies are not always parsed out correctly. These should be fixed soon.
  • The current Forgotten Realms and Eberron books have not been checked yet and definitely have parsing failures. If you are desperate for a particular feature please log a report.
  • Species with choices such as the Goliath do not parse correctly yet.
  • Feature Muncher will not pull from shared campaigns.

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.

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

  • Restrict import to specific source book(s)? This will allow you to import material from only specific books. Please note however that DDB lists the first book something appears in as the source, which can mean that many things are in the SRD/Free Rules, or possibly not in the book you expect. Using Category exclusion (below) is normally a lot more effective.
  • Excluded Categories These are the Source categories in DDB, they often contain multiple books. Categories selected here will be excluded from import. The Legacy category is not 2014 content, but content that has been outright replaced, such as that in Monsters of the Multiverse.

Importing Features

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

Character Feature Munch Tab

Always import FEATS first, as these are used by other options.

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

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