Spell Book Settings

Spell Book Settings is the per-actor configuration dialog for Spell Book. It sets each spellcasting class’s spell list, cantrip and spell swap rules, ritual casting, preparation bonuses, wizard mechanics, and per-actor overrides of the world rule settings.

The window title reads Spell Book Settings: {actor name}.

Spell Book Settings dialog

Opening the dialog

Spell Book sidebar: the gear button in the Player Spell Book sidebar.
No spell list assigned notice: the notice button on a class tab, which opens the dialog scrolled to that class.
Spellcasting-gain chat card: the Assign Spell List button described below.

Spellcasting-gain notice

When a class or subclass that grants spellcasting is added to a character, or spellcasting is granted on level-up, the module whispers a chat card to you and to the actor’s owners for any affected class with no spell list assigned. The card names the affected classes. You see an Assign Spell List button that opens Class Rules for that character; an owning player sees an Open Spell Book button.

Global fieldset

The top fieldset applies to the whole actor, not a specific class.

Field	Type	Behavior
Rule Set Override	Select: Use Global / Legacy / Modern	Overrides the world Default Spellcasting Rules setting for this actor. `Use Global` inherits the world value. See Ruleset Types and Meanings. Sets the defaults applied when a class is first added to the actor.
Notify on Spell Changes	Checkbox	When on, GMs get a whispered card when this actor saves a change to prepared cantrips or spells, with a warning line for any class over its limit. Inherits the world Notify GM on Spell Changes setting.
Open Details Customization	Button	Opens Details Customization.

Stored on the actor as flags.spell-book.ruleSetOverride and flags.spell-book.notifyGm.

Per-class sections

One fieldset per spellcasting class on the actor, sorted alphabetically and headed by the class icon and name. An actor with no spellcasting classes shows a placeholder message instead.

Core fields

Field	Type	Behavior
Show Cantrips	Checkbox	When off, the cantrip group is hidden in the Spell Book, and the class’s non-granted, non-always-prepared cantrips are removed on save. Disabled when the class has no cantrip scale value.
Force Wizard Mode	Checkbox	Shown for every class. When on, the class is treated as a wizard: spellbook tab, free starting spells, level-up free spells, scroll learning, gold-based copying.
Cantrip Swapping	Select: none / level-up / long-rest	Controls when cantrips may be changed. Disabled when Show Cantrips is off.
Spell Swapping	Select: none / level-up / long-rest	Controls when prepared spells may be changed.
Ritual Casting	Select: none / prepared / always	`prepared` casts only currently prepared rituals; `always` casts any ritual on the list.
Class Spell List	Multi-select journal picker	Required. Journal spell-list pages this class draws spells from. Empty means the tab shows the “no spell list assigned” notice.
Subclass Spell List	Multi-select journal picker	Optional. Journal pages that overlay the class list with subclass-specific spells.
Spell Preparation Bonus	Number	Added to the class’s calculated maximum prepared spells. Negative values reduce the cap.
Cantrip Preparation Bonus	Number	Added to the class’s calculated maximum prepared cantrips. Disabled when Show Cantrips is off.

See installation and settings for defaults and value ranges.

Class and Subclass Spell Lists

Both multi-selects draw from the same pool of journal pages:

The module’s built-in custom spell lists pack
Every other spell-list-type journal compendium
Minus any list hidden through the world Hidden Spell Lists setting
Minus any stock list whose spells all come from a disabled Compendium Browser source

Options are grouped by Class, Subclass, and Other. Selections on either field are merged and de-duplicated by UUID. Lists are created, duplicated, merged, and renamed through the Spell List Manager. See Creating New Spell Lists and Modifying Existing Spell Lists.

Wizard-only fields

Shown when the class is detected as a wizard or Force Wizard Mode is on.

Field	Type	Behavior
Starting Spells	Number	Free spells the wizard begins with at level 1.
Spells Per Level	Number	Free spells granted on each wizard level-up.
Spell Learning Cost Multiplier	Number	Gold pieces per spell level charged to copy a spell into the spellbook. Cantrips are free.
Spell Learning Time Multiplier	Number	Minutes per spell level required to copy a spell. Cantrips take 1 minute.

See Wizard Spellbook Management for how these values feed into the Spellbook tab.

Rule set defaults

The defaults applied when a class is first detected depend on the effective rule set: the world setting, or the actor’s Rule Set Override. See Ruleset Types and Meanings for the per-class defaults.

Saving

The Save button writes one actor update:

Global overrides go to flags.spell-book.ruleSetOverride and flags.spell-book.notifyGm.
Per-class rules merge into flags.spell-book.classRules[<classIdentifier>].
Turning off Show Cantrips deletes the class’s non-granted, non-always-prepared cantrips.
Cached rule set, class data, spell data, and spell manager derivations for the actor are dropped.
Any open Spell Book window for this actor reloads all class tabs.

Prepared spells no longer on a changed spell list are not removed. The dialog closes on submit.