User Tools

Site Tools


spellbookspell

Spellbook Spell

Command spell. This spell allows you to create a “spellbook” out of a bookcase block (by default). Any player who right-clicks on that spellbook (bookcase block) will then learn the spell (assuming they have permission).

Usage: While looking at a bookcase block, type /cast spellbook <spellname> [uses]. The uses option is optional, and if left off, will default to the default-uses option in the config, which is -1. A -1 is infinite uses.

Configuration Options

Option Description Default
default-uses How many uses a spellbook has if the uses option is left off. A value of -1 is infinite. -1
destroy-when-used-up Whether to remove the spellbook block (bookcase by default) when all of the uses are gone. false
spellbook-block The block id to use for spellbooks. 47
str-usage Message that appears if the spell is used incorrectly. Usage: /cast spellbook <spell> [uses]
str-no-spell Message that appears if the spell does not exist or if the caster does not know the spell. You do not know a spell by that name.
str-cant-teach Message that appears if the caster does not have permission to teach the spell. You can't create a spellbook with that spell.
str-no-target Message that appears if the caster does not target a spellbook block. You must target a bookcase to create a spellbook.
str-has-spellbook Message that appears if the targeted spellbook block already has a spellbook. That bookcase already has a spellbook.
str-cant-destroy Message that appears if a player attempts to destroy a spellbook. You cannot destroy a bookcase with a spellbook.
str-cant-learn Message that appears if a player right-clicks on a spellbook but does not have the permission to learn the spell. You cannot learn the spell in this spellbook.
str-already-known Message that appears if a player right-clicks on a spellbook but already knows the spell. You already know the %s spell.
str-learned Message that appears when a player learns a spell from a spellbook. You have learned the %s spell!

Example

spellbook:
    spell-class: ".command.SpellbookSpell"
    name: spellbook
    description: Create a spellbook that teaches a spell.
    default-uses: -1
    destroy-when-used-up: false
    spellbook-block: 47
    str-use: "Usage: /cast spellbook <spell> [uses]"
    str-cast-self: You have created a spellbook with the %s spell.
    str-no-spell: You do not know a spell by that name.
    str-cant-teach: You can't create a spellbook with that spell.
    str-no-target: You must target a bookcase to create a spellbook.
    str-has-spellbook: That bookcase already has a spellbook.
    str-cant-destroy: You cannot destroy a bookcase with a spellbook.
    str-cant-learn: You cannot learn the spell in this spellbook.
    str-already-known: You already know the %s spell.
    str-learned: You have learned the %s spell!
spellbookspell.txt · Last modified: 2013/07/24 10:45 by rurikar