DM Quick Start

Get from install to “spells appear in a player’s Spell Book” in five steps.

Requirements: Foundry VTT 14+, dnd5e 5.3.0+.

---

1. Install

Install the module through the Foundry setup screen or via manifest URL. See Installation and Settings for details.

Once enabled in your world, Spell Book adds:

• A Spell Book button on each actor sheet.
• A Spell List Manager button in the footer of the Compendium sidebar tab (GM only).

---

2. Open the Spell List Manager

Open the Compendium sidebar tab and click Spell List Manager in the footer.

The manager is a draggable window with a detach button in its header. Detaching pops the manager into a standalone OS window, and dialogs opened from the manager follow it.

On first open the module indexes every compendium spell, and a progress toast ticks as the fetch completes. This is a one-time cost per session.

Full walkthrough: Spell List Manager Interface Overview.

---

3. Make lists available to players

Important

Spells do not auto-populate on character sheets. You must make a list available to each spellcasting class using one of the two options below, or player spell books will appear empty.

Option A: Add to Spell Registry (stock lists only)

Select a list in the Spell List Manager content panel. In the toolbar that appears above the list, tick Add to Spell Registry. This:

• Adds the list’s UUID to the REGISTRY_ENABLED_LISTS world setting.
• Calls dnd5e.registry.spellLists.register(uuid) immediately. Newly added spells show their class label on item sheets without a reload.

Disabling the toggle removes the UUID from the setting. It cannot undo contributions already pushed to the registry, and a world reload clears those. A notification explains this when you disable a list.

Option A only registers the list with the system for spell-label display on item sheets; it does not populate the player spell book. To populate spell books, use Option B.

Option B: Assign per class via Spell Book Settings

Open Spell Book Settings using the cog icon in the Spell Book sidebar (GM only). For each character, select the spell list for each class:

• Class Spell List. The class’s primary list.
• Subclass Spell List. The subclass list (optional).

This writes the list to the actor’s class rules and is the only path that populates the player spell book.

• Create lists: Creating New Spell Lists
• Modify existing lists: Modifying Existing Spell Lists
• Assign lists to classes: Class Rules

---

4. Review global settings (optional)

Open Game Settings > Configure Settings > Spell Book. You do not need to change anything to get started. A few worth knowing:

• Notify GM on Spell Changes. Whispers you a card listing the cantrips and spells a player added or removed each time they save their preparation. Over-limit classes add a warning to that card.
• Default Spellcasting Rules. Choose Legacy Rules or Modern Rules.
• Consume Scrolls When Learning
• Deduct Spell Learning Costs

Full reference: Installation and Settings.

---

5. Players open their Spell Book

Players click the Spell Book button on their character sheet. Their spells come from the list assigned via Spell Book Settings for their class (Option B above).

If a player’s book is empty, confirm their class has a spell list assigned via Spell Book Settings (the cog icon in the Spell Book sidebar). The Add to Spell Registry toggle (Option A) only affects spell labels on item sheets and does not populate the spell book.

When a character gains a spellcasting class with no list assigned, a whispered card reaches you and the character’s owners with a button to assign the list.

---

Spell copy approval

With GM Approval for Spell Copying enabled, a player’s attempt to copy a spell into a wizard spellbook is stored on the character as a pending request instead of being applied.

A dialog then prompts you, naming the character, the spell, the gold cost and the copying time. Approving copies the spell and advances world time by the copying duration, while checking Skip Time approves the copy without that advance. Denying clears the request.

Either outcome is whispered to the player who made the request, and their open Spell Book reloads. A character can hold one pending request at a time.

A request made while no GM is connected stays on the character and is surfaced to the next GM who connects.

---

Troubleshooting

If something looks wrong, use the 3DS:ATLAS Troubleshooter to generate a diagnostic report.

Programmatic access to spell data, list registration, and actor Spell Book state is documented in the API Reference.