查看“MagicSpells/卷轴”的源代码

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

用法：手握一本书与笔（<code>minecraft:written_book</code>），输入<code>/cast tome <魔法名> [使用次数]</code>。不论书中写了哪些内容，都可以正常使用。
==设置==
{| class="wikitable" width="100%"
|-
!width="10%"|选项!!解释!!width="25%"|默认值
|-
|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.
|}
==举例==
 <nowiki>
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.
</nowiki>
==高级==
MagicSpells是通过物品上一行Lore来识别卷轴的。这行Lore被设定为黑色并附有“Magic”效果所以玩家看不到。文本如下：
 <nowiki>
&0&kMS$:tome:spell,uses
</nowiki>
卷轴魔法在默认的情况下名字是<code>tome</code>，上述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>