SpellbookSpell - TheComputerGeek2/MagicSpells GitHub Wiki

Source Code

spell-class: ".command.SpellbookSpell"

Spell Effect Positions:

  • delayed - Plays the effect on the player who used the SpellBook.

Description:

This spell creates a SpellBook block at the block the caster is looking at which teaches players which right-click a specific spell. You can pass a spell to be bound to the block using the cast command or subspell args. You can also optionally pass the number of uses this SpellBook provides. If none are passed, default-uses are used for that amount. Uses may be a negative number to specify infinite uses.

A created SpellBook block can only be destroyed by opped players or players with the magicspells.advanced.spellbook permission (nobody has it by default).

Configuration:

Since 4.0 Beta 13 some of these options support dynamic values through numeric or string expressions.

Option Description Type Default Supports expressions
spellbook-block Block type required for this spell to bind it to. String "bookshelf" false
default-uses If no uses are passed with spell cast arguments, this is the amount used. Integer -1 false
destroy-when-used-up Defines whether to destroy the SpellBook block (set to an air block) when uses are depleted. Boolean false false
str-usage Sent if no spell cast arguments are passed. Rich Text "Usage: /cast spellbook <spell> [uses]" true
str-no-spell Rich Text "You do not know a spell by that name." true
str-learned Rich Text "You have learned the %s spell!" true
str-no-target Rich Text "You must target a bookcase to create a spellbook." true
str-cant-teach Rich Text "You can't create a spellbook with that spell." true
str-cant-learn Rich Text "You cannot learn the spell in this spellbook." true
str-learn-error Rich Text true
str-cant-destroy Rich Text "You cannot destroy a bookcase with a spellbook." true
str-has-spellbook Rich Text "That bookcase already has a spellbook." true
str-already-known Rich Text "You already know the %s spell." true

Additional Placeholders:

  • str-cast-self, str-cant-learn, str-already-known, and str-learned:
    • %s: Spell name.

Note

Anyone can edit the wiki so if you feel like you need to edit or add something, or if you find some mistakes, please do help us out. We would appreciate it! ❤️

⚠️ **GitHub.com Fallback** ⚠️