Skip to contents

Query list of all Dungeons & Dragons spells based on partial string matches between user inputs and the relevant column of the spell information data table. Currently supports users querying the spell list by spell name, which class lists allow the spell, spell's level, the school of magic the spell belongs in, whether or not the spell can be cast as a ritual, and the time it takes to cast the spell. All character arguments are case-insensitive (note that the ritual argument expects a logical). Any argument set to `NULL` (the default) will not be used to include/exclude spells from the returned set of spells

Usage

spell_list(
  name = NULL,
  class = NULL,
  level = NULL,
  school = NULL,
  ritual = NULL,
  cast_time = NULL
)

Arguments

name

(character) text to look for in spell names

class

(character) character class(es) with the spell(s) on their list

level

(character) "cantrip" and/or the minimum required spell slot level

school

(character) school(s) of magic within which the spell belongs (e.g., 'evocation', 'necromancy', etc.)

ritual

(logical) whether the spell can be cast as a ritual

cast_time

(character) either the phase of a turn needed to cast the spell or the in-game time required (e.g., "reaction", "1 minute", etc.)

Value

(dataframe) 10 columns of information with one row per spell(s) that fit(s) the user-specified criteria. If no spells fit the criteria, returns a message to that effect instead of a data object

Examples

# Search for evocation spells with 'fire' in the name that a wizard can cast
spell_list(name = "fire", class = "wizard", school = "evocation")
#>               spell_name                                         spell_source
#> 1              Fire Bolt Player's Handbook.241, System Reference Document.144
#> 2               Fireball Player's Handbook.241, System Reference Document.144
#> 3 Delayed Blast Fireball Player's Handbook.230, System Reference Document.133
#> 4            Fire Shield Player's Handbook.241, System Reference Document.144
#> 5           Wall of Fire Player's Handbook.285, System Reference Document.190
#>                                                                                                            pc_class
#> 1                                                                                       artificer, sorcerer, wizard
#> 2                   sorcerer, wizard, artificer: artillerist, cleric: light, warlock: fiend, warlock: genie efreeti
#> 3                                                                                                  sorcerer, wizard
#> 4      druid, sorcerer, wizard, artificer: armorer, artificer: battle smith, warlock: fiend, warlock: genie efreeti
#> 5 druid, sorcerer, wizard, artificer: artillerist, cleric: forge, cleric: light, warlock: celestial, warlock: fiend
#>   spell_level spell_school ritual_cast casting_time    range
#> 1     cantrip    evocation       FALSE     1 action 120 feet
#> 2     level 3    evocation       FALSE     1 action 150 feet
#> 3     level 7    evocation       FALSE     1 action 150 feet
#> 4     level 4    evocation       FALSE     1 action     self
#> 5     level 4    evocation       FALSE     1 action 120 feet
#>                                      components                      duration
#> 1                                          V, S                 instantaneous
#> 2 V, S, M (a tiny ball of bat guano and sulfur)                 instantaneous
#> 3 V, S, M (a tiny ball of bat guano and sulfur) concentration, up to 1 minute
#> 4   V, S, M (a bit of phosphorous or a firefly)                    10 minutes
#> 5         V, S, M (a small piece of phosphorus) concentration, up to 1 minute