FAQ
General
Section titled “General”What is Spell Book?
Section titled “What is Spell Book?”Spell Book replaces the system’s spell preparation list with a dedicated window. It handles preparation, multiclass casting, wizard spellbooks, loadouts, and party coordination.
What systems does Spell Book support?
Section titled “What systems does Spell Book support?”Only the D&D Fifth Edition system. See Installation and Settings for the minimum version and required modules.
How do I open Spell Book?
Section titled “How do I open Spell Book?”- Click the Spell Book button on a character sheet.
- Run the Spell Book - Quick Access macro with a token selected.
Does Spell Book ship with macros?
Section titled “Does Spell Book ship with macros?”Yes. The Spell Book Macros compendium holds five script macros, kept up to date when a GM loads the world. See Built-in macros.
Spell lists and class configuration
Section titled “Spell lists and class configuration”My class tab is empty. What do I do?
Section titled “My class tab is empty. What do I do?”Open Spell Book Settings on the actor and assign a Class Spell List. When a spellcasting class on the actor has no list, you and the actor’s owners get a whispered card with a button to fix it.
Subclass spells are not showing up.
Section titled “Subclass spells are not showing up.”Set a Subclass Spell List in Spell Book Settings. Its spells are merged into that class’s tab. Spell Book does not mark them always prepared.
Why did some spell lists disappear from the picker and the Spell List Manager?
Section titled “Why did some spell lists disappear from the picker and the Spell List Manager?”A stock list is hidden when every spell on it comes from a Compendium Browser source you disabled. Re-enable the source to restore it. A list already assigned to a class stays selectable with a “source disabled” suffix.
I edited a stock spell list. Where did the original go?
Section titled “I edited a stock spell list. Where did the original go?”Saving edits to a stock list creates a modified copy and moves the original to the Hidden Spell Lists folder. Unhide it there, or delete the modified copy. See Modifying Existing Spell Lists.
After modifying a list, the “Classes” label on a spell is not right.
Section titled “After modifying a list, the “Classes” label on a spell is not right.”Spells removed from a list keep their old class label until the world reloads. The system’s spell list registry has no way to remove entries. Added spells update immediately.
Why do some spells appear multiple times?
Section titled “Why do some spells appear multiple times?”Several compendiums ship the same spell, and Spell Book shows each copy. Run debugSpell('spell name') to see which packs a name comes from.
How do I find spells that are not in any list?
Section titled “How do I find spells that are not in any list?”Run the Spell Book - Spells Not In Lists macro.
Spell preparation
Section titled “Spell preparation”Can a player exceed their spell or cantrip maximum?
Section titled “Can a player exceed their spell or cantrip maximum?”Yes. Preparation is never blocked. With notifications on for the actor, the player sees a toast when going over the limit, and you get a whispered card on save. See Notify GM on Spell Changes.
”Notify GM” does not fire for some players.
Section titled “”Notify GM” does not fire for some players.”The actor’s Notify on Spell Changes checkbox in Spell Book Settings overrides the world Notify GM on Spell Changes setting. Once an actor’s Spell Book Settings are saved, that actor keeps its own value. Check the checkbox on that actor.
Loadouts
Section titled “Loadouts”Do I need to save preparation before saving a loadout?
Section titled “Do I need to save preparation before saving a loadout?”No. A loadout captures the checkboxes as they currently stand on the active class tab. Applying a loadout saves preparation for that class immediately. See Spell Loadouts.
Wizard features
Section titled “Wizard features”Can Wizards learn spells from scrolls?
Section titled “Can Wizards learn spells from scrolls?”Yes. A scroll copy costs nothing unless Charge Cost for Scroll Copying is enabled. Currency is deducted only while Deduct Spell Learning Costs is also enabled. Consume Scrolls When Learning controls whether the scroll is used up. See Wizard Spellbook Management.
What are Legacy and Modern rule sets?
Section titled “What are Legacy and Modern rule sets?”See Ruleset Types and What They Mean.
Compatibility and integration
Section titled “Compatibility and integration”Which modules does Spell Book integrate with?
Section titled “Which modules does Spell Book integrate with?”Tidy 5e Sheet, Cauldron of Plentiful Resources, Peddler, and Calendaria. See Module Integrations.
Interface
Section titled “Interface”How do I change the Spell Book’s theme, including the parchment look?
Section titled “How do I change the Spell Book’s theme, including the parchment look?”Theming is handled by 3DS:ATLAS.
I moved the Spell Book to a second monitor and child dialogs open on the primary monitor.
Section titled “I moved the Spell Book to a second monitor and child dialogs open on the primary monitor.”Detach the Spell Book window with its own detach button. Dialogs opened from a detached Spell Book open in the same window.
Troubleshooting
Section titled “Troubleshooting”My spells are not showing up
Section titled “My spells are not showing up”- Check that the character has the correct spellcasting classes on their sheet.
- Open Spell Book Settings and confirm a Class Spell List is assigned, plus a Subclass Spell List if needed.
- Verify the lists exist in the Spell List Manager.
- If spells were recently added to a compendium, reload Foundry.
Which client does GM-side work run on?
Section titled “Which client does GM-side work run on?”The primary GM chosen by 3DS:ATLAS. Copy approval, the downtime note, the missing spell list notice, and the Peddler trade listener run only on that client.
How do I report a bug?
Section titled “How do I report a bug?”- Open the 3DS:ATLAS troubleshooter and export a report.
- Open an issue on GitHub or post in the Discord support channel.
- Attach the report and describe the steps to reproduce the issue.
Data and storage
Section titled “Data and storage”Where is Spell Book data stored?
Section titled “Where is Spell Book data stored?”- Preparation state and loadouts are flags on each actor.
- Custom and modified spell lists and wizard spellbooks are journals in the Custom Spell Lists compendium.
- Spell notes are in the User Spell Data compendium.
- Favorites use the character’s system Favorites.
What happens if I uninstall Spell Book?
Section titled “What happens if I uninstall Spell Book?”Module flags stay on actor documents and do nothing. Run the Spell Book - Flag Purge macro before uninstalling to remove them.