MagicSpells/卷轴

基础魔法。卷轴魔法能够让你创建一个技能卷轴来教会别的玩家。

用法：手握一本书与笔（minecraft:written_book），输入/cast tome <魔法名> [使用次数]。不论书中写了哪些内容，都可以正常使用。

设置

选项	解释	默认值
consume-book	Whether to remove the book from the player's inventory when all the tome uses are gone.	false
allow-overwrite	Whether a tome can be overwritten as a different tome.	false
default-uses	The number of uses a tome has if an amount isn't specified. A value of -1 means infinite uses.	-1
max-uses	The maximum number of uses allowed on a tome.	5
require-teach-perm	Whether the casting player (the one making the tome) needs the teach permission for the spell being placed in the tome.	true
str-usage	The message that appears when using the spell incorrectly.	Usage: While holding a book, /cast tome <spell> [uses]
str-no-spell	The message that appears when trying to use an invalid spell.	You do not know a spell with that name.
str-cant-teach	The message that appears if the caster does not have the permission for the spell they're trying to use, and the require-teach-perm option is set to true.	You cannot create a tome with that spell.
str-no-book	The message that appears if the caster is not holding a written book.	You must be holding a book.
str-already-has-spell	The message that appears if the book already has a spell assigned.	That book already contains a spell.
str-already-known	The message that appears if a player tries to use a tome but already has the spell it contains.	You already know the %s spell.
str-cant-learn	The message that appears if a player tries to use a tome but does not have the learn permission for the spell it contains.	You cannot learn the spell in this tome.
str-learned	The message that appears if a player successfully learns a spell from a tome.	You have learned the %s spell.

举例

tome:
    spell-class: ".command.TomeSpell"
    name: tome
    spell-icon: book
    description: Create a tome that teaches a spell.
    cancel-read-on-learn: true
    consume-book: true
    allow-overwrite: false
    max-uses: -1
    default-uses: -1
    require-teach-perm: true
    str-usage: "Usage: While holding a book, /cast tome <spell>"
    str-no-spell: You do not know a spell with that name.
    str-cant-teach: You cannot create a tome with that spell.
    str-no-book: You must be holding a book.
    str-already-has-spell: That book already contains a spell.
    str-already-known: You already know the %s spell.
    str-cant-learn: You cannot learn the spell in this tome.
    str-learned: You have learned the %s spell.
    str-cast-self: You have created a spell tome.

高级

MagicSpells是通过物品上一行Lore来识别卷轴的。这行Lore被设定为黑色并附有“Magic”效果所以玩家看不到。文本如下：

&0&kMS$:tome:spell,uses

卷轴魔法在默认的情况下名字是tome，上述tome的位置为配置文件里卷轴魔法的真实名称。上述spell的位置为魔法的真实名称。上述uses的位置为剩余的使用次数。你可以通过任何别的方法来给物品添加Lore使Magicspells识别它为卷轴。举例，使用RecipeManager你可以这样来创建卷轴：

<nowiki>

COMBINE

redstone + glowstone_dust + book

= written_book @bookitem title 愚蠢的瞬移技能 @bookitem author 我是作者 @itemlore &0&kMS$:tome:blink,1 </wiki>