Spellcasting System Workflow

This guide explains the current spellcasting workflow and what is already available in the app.

What Is Available Now

• spell creation and editing
• spell browsing and filtering
• spell deletion (with permissions)
• class spell list assignment workflows (data/API support)
• spell and power selection integration for special inventory items (Spell Scroll, Power Crystal)

Spell Authoring Workflow

1. Create a new spell.
2. Fill out core fields (name, level, school, range, duration, description).
3. Configure components (V/S/M), ritual, concentration, and attack/save metadata.
4. Save changes.

The spell editor also supports temporary effect trigger integration where configured.

Upcast Scaling Expressions

Spell and power cards support expression placeholders in these metadata fields:

• target count
• range
• area of effect

Use {...} expressions with parser variables such as slot and spell_mod (for spell cards):

• Up to {1 + slot} targets
• {30 + slot * 30} ft
• {10 + slot * 5} ft radius

At runtime, card metadata and per-target damage roll count both use the scaled target value.

Spell Search and Filtering

Spell queries support:

• name search
• level filter
• school filter
• ritual filter
• concentration filter
• source filter

Results are source-aware and paginated.

Class Spell Lists

Class spell list operations are supported by API and form workflows:

• search all spells
• add/remove spells in a class list
• persist changes in bulk

Inventory Integration

Spell Scroll and Power Crystal item flows use compendium searches.

• users choose a spell or power during item creation flow
• rarity and related metadata are computed for scrolls
• selected content is linked for quick hover-card lookup

Current Limitations

Some spellcasting features are still in progress:

• full class spellcasting table builder UI is not fully enabled

Use the current workflow for spell authoring and source-aware search while these features continue to expand.