Modifying Existing Spell Lists
Selecting a list
Section titled “Selecting a list”- Open the Spell List Manager from the Compendium tab footer.
- Locate the list in the sidebar. Hovering a row shows a tooltip with its full name, source pack, and spell count.
- Click the list to load it.
Every list loads into the split view: Available Spells on the left, Current List on the right. There is no Edit button; edits are accepted immediately and held as pending changes until you click Save.
Sidebar folders:
| Folder | Description |
|---|---|
| Player Spell Books | Actor-owned learned-spell journals |
| Custom Spell Lists | GM-created lists (kind: 'custom') |
| Merged Spell Lists | Lists built from two or more sources (kind: 'merged') |
| Modified Spell Lists | Auto-created duplicates of standard lists (kind: 'duplicate') |
| Spell Lists | System- or module-provided stock lists |
| Hidden Spell Lists | Lists whose UUID is in the Hidden Spell Lists setting |
Editing behavior by list type
Section titled “Editing behavior by list type”Standard lists
Section titled “Standard lists”- Click the stock list in the sidebar.
- Add or remove spells in the split view.
- Click Save.
Saving a stock list for the first time duplicates it. The module creates a copy under Modified Spell Lists, stamps it with a reference back to the original, hides the original from the Spell Lists folder, and writes the pending edits to the duplicate. Spells added this way carry the class label on item sheets without a reload.
The sidebar re-selects the duplicate after saving and resets the filters. Editing the original stock list again routes to the same duplicate.
Custom, merged, and modified lists
Section titled “Custom, merged, and modified lists”Edits apply directly to the document. There is no duplication step.
Actor Spellbooks
Section titled “Actor Spellbooks”Actor spellbook rows are selectable in the Spell List Manager and load into the same split-view editor as any other list. Adding, removing, and saving spells work the same way as a stock or custom list. The Rename button and the sidebar Hide toggle do not appear on actor-owned rows.
Actor spellbook journals live in the Actor Spellbooks folder of the module’s custom pack and are matched by an actor flag rather than by display name. A journal stranded at the root of the pack is re-filed on world load.
Header buttons
Section titled “Header buttons”| Icon | Action | Shown When |
|---|---|---|
| Checkbox | Add to Spell Registry | Always |
| Pen | Rename | List carries a kind flag (not on plain stock lists or actor-owned lists) |
| User | Open Actor | Actor-owned list |
| Scroll | Open Class | Class/subclass item is findable in a pack |
| Sync | Restore | Modified duplicate (has an original list to restore from) |
| Trash | Delete | Always |
| Floppy | Save | Always |
Adding spells
Section titled “Adding spells”- Click the + icon on an available-spell row.
- Drag a row from Available Spells onto Current List.
The add guard only rejects the exact same UUID. Two copies of the same spell from different packs both add; remove the redundant entry manually.
Removing spells
Section titled “Removing spells”- Click the trash icon on a current-list row.
- Drag a row from Current List onto Available Spells.
Saving
Section titled “Saving”Changes live in memory until you click Save, and closing the list or switching selection without saving discards pending edits. Stock lists duplicate on save as described above.
Bulk editing
Section titled “Bulk editing”- Click the Selection Mode toggle (checkmark) in the top-right of the footer.
- Click spell rows to flag them. Shift-click selects a range.
- Click Bulk Save in the footer to apply every queued add and remove at once.
- Exit selection mode with Cancel Selection.
Selection mode replaces single-row buttons with selection affordances on both panels, and the footer shows a live add/remove counter.
Bulk Save opens a confirmation dialog showing the add and remove counts. Confirming stages the changes the same as single-row edits. The header Save button still writes them to the document.
Comparing spells
Section titled “Comparing spells”When Compare is enabled in Details Customization, every spell row shows a balance-scale icon. Clicking it toggles the spell’s membership in the comparison set. Once two or more spells are queued, the Spell Comparison dialog opens. It has no cap and widens as spells are added. If the Spell List Manager is detached, the comparison dialog opens in the same detached window.
Restoring a modified list
Section titled “Restoring a modified list”The Restore icon shows on any modified duplicate.
- Select the modified list.
- Click Restore (sync).
- Confirm the prompt.
The duplicate’s spell list is overwritten with the source list’s current spells. Local edits are discarded, and the duplicate’s recorded source state updates to match.
Hiding vs deleting
Section titled “Hiding vs deleting”Every non-actor list row in the sidebar has an eye icon. Clicking it moves the row to the Hidden Spell Lists folder without touching the document. Click the eye-slash icon in the Hidden Spell Lists folder to restore.
Stock lists are hidden automatically the first time you save edits to them.
Delete
Section titled “Delete”Clicking Delete opens a confirmation dialog naming the list before it is removed. The list is removed permanently from the custom pack. For modified duplicates, deletion also restores the original stock list to the Spell Lists folder.
Deletion is irreversible. Prefer Hide for temporary removal.
Patterns
Section titled “Patterns”Class-specific tweaks
Section titled “Class-specific tweaks”- Select the stock class list.
- Add or remove spells, then Save. The module duplicates it into Modified Spell Lists, hides the original, and registers the duplicate.
- Assign the modified list to affected characters in Spell Book Settings, or rely on the registry registration.
Restore the original stock list at any time by deleting the duplicate.
Subclass additions
Section titled “Subclass additions”Subclass assignment is explicit. Create a dedicated subclass list with the Subclass Spell List checkbox in Create, then in each character’s Spell Book Settings set:
- Class Spell List to the base class list.
- Subclass Spell List to the new subclass list.
Conditional availability
Section titled “Conditional availability”Maintain a separate list for each condition and swap which is assigned in Spell Book Settings as conditions change. Avoid editing a single live list mid-session.
Testing changes
Section titled “Testing changes”- Assign the modified list to a test character in Spell Book Settings.
- Open the Spell Book on that character.
- Verify visible, learnable, and prepared spells match expectations.
- If a spell was added and the class label is not showing on its item sheet yet, confirm the list appears in the Modified Spell Lists folder and is registry-enabled.