Spell Book Troubleshooter

Spell Book uses the shared troubleshooter from 3DS:ATLAS. See that page for opening the troubleshooter, the report format, settings import/export, and the actor data export option.

Debug section

Spell Book adds two entries to the report’s Debug section:

• CompendiumBrowser Sources (enabled): every enabled Item and Actor compendium pack, read from the system’s packSourceConfiguration setting. Shown only when the active system is the one this integration targets.
• Spell Lists: every spell list Spell Book finds, sorted by name, with its UUID and spell count, followed by the name and UUID of each spell in the list. A spell that fails to resolve appears as ?.

Disabling a source in the Compendium Browser hides any stock spell list whose spells all come from that source, in both the Class Rules picker and the Spell List Manager. Re-enabling the source brings the list back. A class already assigned a now-hidden list shows a “No spells available” notice instead.

When to use

• Bug reports: attach the downloaded report, and actor JSON files if relevant, to a GitHub issue.
• Discord support: copy the report into a support thread.
• Missing spells: check the Spell Lists entries for ?. That points at a compendium that is missing or renamed. Spell Book also logs a warning with the number of entries that failed to resolve.