Spell Filter - TheComputerGeek2/MagicSpells GitHub Wiki
- The Spell Filter is used to refer to a group of spells. If the filter is empty, all spells pass it.
- The reference of spell tags below refers to a general spell option
tagswhich can be a list of strings (e.g.tags: ["Admin"]). - All spells have predefined tags (e.g. for
.instant.BeamSpell):spell-class:com.nisovin.magicspells.spells.instant.BeamSpell-
spell-package:com.nisovin.magicspells.spells.+instant/targeted/etc. -
Since 4.0 Beta 17:
magicspells:beneficial- for spells configured withbeneficial: true -
Since 4.0 Beta 17:
magicspells:helper-spell- for spells configured withhelper-spell: true
- The filter does not support Expressions from 4.0 Beta 13.
| Option | Description |
|---|---|
spells |
List of spells the filter will include, ignoring other spells. |
denied-spells |
List of spells not included in the filter. |
spell-tags |
List of spell tags the filter will include, ignoring other tags. |
denied-spell-tags |
List of spell tags not included. |
- Follows the format:
"allowedSpellName,!disallowedSpellName,tag:allowedTag,!tag:disallowedTag"(e.g.fire_multi,!fire_water_mix). -
Since 4.0 Beta 13, you may use
#instead oftag:to denote a tag. E.g."allowedSpell,!disallowedSpell,#allowedTag,!#disallowedTag". -
Since 4.0 Beta 14, you may use
*for the entire filter to allow all spells, but an empty string filter can achieve the same effect. - Since 4.0 Beta 17, you can use the new String Spell Filter format instead.
Note
Since 4.0 Beta 17.
Use * to match all spells, or define a Predicate of individual spell names or a group of spells using their tags (prefixed with #). Example:
(#water | #earth | #fire | #air) & !(#novice | #advanced | singular_spell)