Imbue Spell - TheComputerGeek2/MagicSpells GitHub Wiki

Source Code

spell-class: ".command.ImbueSpell"

Description:

This spell imbues the handheld item with the passed spell, making it a temporary cast item of that spell, one that can be dropped and given to other players without them needing permission to cast the spell. You can pass the spell to imbue using the cast command or subspell args. If allow-specify-uses is set to true or the player has the magicspells.advanced.imbue permission, you can also optionally pass the positive integer number of uses this may have. If none are passed, default-uses are used for that amount.

Configuration:

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

Option Description Type Default Supports expressions
allowed-items Allowed items a spell can be imbued to. Magic Item String List false
max-uses This helps clip passed uses down to a max value. Integer 10 true
default-uses If no uses are passed with spell cast arguments, this is how many are used. Integer 5 true
str-usage Sent if no spell cast arguments are passed. Rich Text "Usage: /cast imbue <spell> [uses]" true
str-item-name Defines what to rename the item to. Rich Text true
str-item-lore Defines what to set the lore of the item to. Rich Text "Imbued: %s" true
str-cant-imbue-item Rich Text "You can't imbue that item." true
str-cant-imbue-spell Rich Text "You can't imbue that spell." true
consume-item Defines whether to remove the item once its uses are depleted. Boolean false false
left-click-cast Defines whether to allow left-click cast. Boolean true false
right-click-cast Defines whether to allow right-click cast. Boolean false false
allow-specify-uses Defines whether to allow the passing of uses with spell cast arguments. It will otherwise always be allowed if the player has the magicspells.advanced.imbue permission. If set to false, it will always imbue with default-uses instead. Boolean true true
require-teach-perm Defines whether teach permissions for the passed spell are required to imbue their handheld item with that spell. Boolean true true
charge-reagents-for-spell-per-use Defines whether reagents of the passed spell are charged per use. Boolean true true

Additional Placeholders:

  • str-item-name/lore:
    • %s: Spell name.
    • %u: Uses left.
⚠️ **GitHub.com Fallback** ⚠️