Ruleset Types and What They Mean

Spell Book defines class-specific defaults for spell swapping, cantrip swapping, and ritual casting through two rule sets. You select the active rule set globally, and each actor can override it through Spell Book Settings.

Spell Book does not block spell preparation. A player keeps full control over what they prepare. The Notify GM on Spell Changes setting whispers you a card each time a player saves a change to their prepared cantrips or spells.

---

Rule Sets

The Default Spellcasting Rules setting (spellcastingRuleSet) sets the global rule set to legacy or modern.

The active rule set determines which class defaults apply when a new spellcasting class is first initialized on an actor. Per-class overrides already stored on the actor are preserved, and changing the setting does not rewrite them.

Legacy (2014)

Applies the 2014 D&D 5e rules:

• No class can swap cantrips.
• Paladins and Rangers do not display cantrips.
• Wizard ritual-casts from the spellbook.
• Cleric, Druid, and Bard have prepared-only ritual casting.
• Bard, Sorcerer, Warlock, and Ranger swap spells on level up.

Modern (2024)

Applies the 2024 D&D 5e rules:

• Most classes swap cantrips on level up.
• Wizard swaps cantrips on long rest.
• Paladin and Ranger do not display cantrips and cannot swap cantrips.
• Cleric, Druid, and Bard have no ritual casting.
• Wizard ritual-casts from the spellbook.
• Ranger swaps spells on long rest.

Class Defaults by Rule Set

Class	Rule Set	Spell Swap	Cantrip Swap	Ritual Casting	Show Cantrips
Wizard	Legacy	Long Rest	None	Always	Yes
Wizard	Modern	Long Rest	Long Rest	Always	Yes
Cleric	Legacy	Long Rest	None	Prepared	Yes
Cleric	Modern	Long Rest	Level Up	None	Yes
Druid	Legacy	Long Rest	None	Prepared	Yes
Druid	Modern	Long Rest	Level Up	None	Yes
Paladin	Legacy	Long Rest	None	None	No
Paladin	Modern	Long Rest	None	None	No
Ranger	Legacy	Level Up	None	None	No
Ranger	Modern	Long Rest	None	None	No
Bard	Legacy	Level Up	None	Prepared	Yes
Bard	Modern	Level Up	Level Up	None	Yes
Sorcerer	Legacy	Level Up	None	None	Yes
Sorcerer	Modern	Level Up	Level Up	None	Yes
Warlock	Legacy	Level Up	None	None	Yes
Warlock	Modern	Level Up	Level Up	None	Yes
Artificer	Legacy	Long Rest	None	None	Yes
Artificer	Modern	Long Rest	Level Up	None	Yes

Per-Actor Rule Set Override

Each character can override the global rule set through Spell Book Settings using the Rule Set Override dropdown:

Value	Effect
Use Global	Follows the world-level spellcastingRuleSet value
Legacy	Applies Legacy defaults for this actor’s class initialization
Modern	Applies Modern defaults for this actor’s class initialization

The override is stored as the ruleSetOverride actor flag (null, "legacy", or "modern"). Per-class rule fields saved in Spell Book Settings take precedence over the rule set defaults.

---

Notify GM on Spell Changes

The world setting notifyGmOnSpellChanges controls two things. It shows a toast on the player’s screen when they exceed a cantrip or spell preparation maximum. It also sends a whispered chat card to all GMs each time the player saves a change to their prepared cantrips or spells. The card lists each removed and added spell. A class that is over its cantrip or spell limit adds a warning line to the same card.

• When on, the player sees a toast when a max is exceeded, and you receive a whispered card on every save.
• When off, no toast is shown and no card is whispered.

Per-Actor Override

The Notify on Spell Changes checkbox in Spell Book Settings is a plain boolean. It defaults to the current world setting value, and saving writes an explicit true or false to the notifyGm actor flag. There is no “Use Global” third state.

---

Swap Modes

Spell swapping and cantrip swapping are configured independently per class. Both use the same three modes:

Mode	Value	When Swapping Is Allowed
None	none	Cannot swap
Level Up	levelUp	Only when the class gains a level
Long Rest	longRest	After completing a long rest

---

Ritual Casting Modes

Ritual casting is configured per class:

Mode	Value	Behavior
None	none	No ritual casting
Prepared	prepared	Ritual-casts only currently prepared ritual spells
Always	always	Ritual-casts any ritual spell available to the class

Wizard-Specific Ritual Behavior

When a wizard class has ritualCasting = always, ritual spells in the wizard’s spellbook are castable as rituals without being prepared. The wizard ritual pool is tracked on the wizardRitualCasting actor flag.

---

Wizard Defaults

Wizard-specific values are seeded from WIZARD_DEFAULTS:

Field	Meaning
startingSpells	Free spells added to the spellbook at character creation
spellsPerLevel	Free spells added to the spellbook on level up
spellLearningCostMultiplier	GP per spell level to copy a spell into the spellbook
spellLearningTimeMultiplier	Minutes per spell level to copy a spell into the spellbook

You can customize all four values per wizard class through Spell Book Settings. For defaults, see Installation and Settings.

---

Preparation Bonuses

You can grant extra preparation slots per class through Spell Book Settings:

• spellPreparationBonus grants extra leveled spell preparation slots.
• cantripPreparationBonus grants extra cantrip preparation slots.

Each value stacks additively on top of the class’s calculated maximum and clamps to the range -20..20. For defaults, see Installation and Settings.

---

Configuration Summary

Setting	Scope	Where
Default Spellcasting Rules	World	Module settings
Notify GM on Spell Changes	World	Module settings
Rule Set Override	Actor	Spell Book Settings
Notify on Spell Changes	Actor	Spell Book Settings
Cantrip Swapping	Per-class	Spell Book Settings
Spell Swapping	Per-class	Spell Book Settings
Ritual Casting	Per-class	Spell Book Settings
Show Cantrips	Per-class	Spell Book Settings
Force Wizard Mode	Per-class	Spell Book Settings
Class Spell List	Per-class	Spell Book Settings
Subclass Spell List	Per-class	Spell Book Settings
Preparation Bonuses	Per-class	Spell Book Settings
Wizard Defaults	Per-class	Spell Book Settings