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

__TOC__
基础魔法。卷轴魔法允许玩家创立一个直接释放技能的卷轴给其他玩家/自己使用。

用法：手握一张纸后输入<code>/cast scroll <魔法名> [使用次数]</code>
==设置==
{| class="wikitable" width="100%"
|-
!width="10%"|选项!!解释!!width="25%"|默认值
|-
|cast-for-free||如果设置为 true, 使用卷轴将不会消耗所需的施法材料. 如果设置为 false, 在使用卷轴前会消耗所需的施法材料.||true
|-
|ignore-cast-perm||如果设置为 false, 玩家使用卷轴施法必须要有 magicspells.cast.<spell>  权限来使用. 如果设置为 true, 可以忽略权限施法.||false
|-
|bypass-normal-checks||如果设置为 true, normal casting checks will be bypassed. 这包括施法材料, 冷却, 施法次数, 禁止魔法的区域和其他约束条件.||false
|-
|default-uses||默认卷轴可使用次数.||5
|-
|max-uses||一个卷轴可以使用的最大次数.||10
|-
|item-id||卷轴材质物品ID.||339
|-
|right-click-cast||是否使用右键施法.||true
|-
|left-click-cast||是否使用左键施法.||false
|-
|remove-scroll-when-depleted||是否在可使用次数耗尽后移除玩家背包内的卷轴.||true
|-
|charge-reagents-for-spell-per-charge||如果设置为 true, the reagents for each use of the spell will be charged up-front when the scroll is created.||false
|-
|require-teach-perm||是否需要传授魔法的权限来创建卷轴.||true
|-
|require-scroll-cast-perm-on-use||如果设置为 true, 使用卷轴的玩家必须要有 magicspells.cast.scroll 权限.||true
|-
|predefined-scrolls [v2.11]||如下所示.||空
|-
|str-scroll-over||The text that appears in chat when a scroll is selected in the player's hotbar.||Spell Scroll: %s (%u uses remaining)
|-
|str-scroll-name||卷轴物品名. 使用 %s 代表魔法名,用 %u 代表可使用次数.||Magic Scroll: %s
|-
|str-scroll-subtext||The sub text on the scroll item. Use %s for spell name and %u for uses remaining.||Uses remaining: %u
|-
|str-usage||Usage text when the spell is used incorrectly.||You must hold a single blank paper and type /cast scroll <spell> <uses>
|-
|str-no-spell||Text that appears if the spell is unknown to the player.||You do not know a spell by that name.
|-
|str-cant-teach||Text that appears if require-teach-perm is true and the player doesn't have the required teach permission.||You cannot create a scroll with that spell.
|-
|str-on-use||Text that appears when a scroll is used.||Spell Scroll: %s used. %u uses remaining.
|-
|str-use-fail||Text that appears when unable to use a scroll.||Unable to use this scroll right now.
|}
==预定义卷轴==
预定义卷轴可以方便的由别的插件来定义好卷轴以供MagicSpells使用。它需要你对一张纸设置一个关联的卷轴和物品数据值。举例，你拥有一个数据值为1的纸将它变为能使用10次的闪现技能：
每个预定义卷轴必须指定一个数据值，技能真实名称和使用次数（可选项，如果不填则为默认使用次数）
 <nowiki>
    predefined-scrolls:
        - 1 blink 10
        - 2 leap 15
        - 3 combust
</nowiki>
==举例==
 <nowiki>
scroll:
    spell-class: ".command.ScrollSpell"
    name: scroll
    description: Create a limited use spell scroll.
    cast-for-free: true
    default-uses: 5
    max-uses: 10
    item-id: 339
    right-click-cast: true
    left-click-cast: false
    ignore-cast-perm: false
    remove-scroll-when-depleted: true
    charge-reagents-for-spell-per-charge: false
    require-teach-perm: true
    require-scroll-cast-perm-on-use: true
    str-scroll-name: "Magic Scroll: %s"
    str-scroll-subtext: "Uses remaining: %u"
    str-scroll-over: "Spell Scroll: %s (%u uses remaining)"
    str-usage: |
        You must hold a single blank paper 
        and type /cast scroll <spell> <uses>.
    str-no-spell: You do not know a spell by that name.
    str-cant-teach: You cannot create a tome with that spell.
    str-cast-self: You have created a spell scroll for %s.
    str-on-use: "Spell Scroll: %s used. %u uses remaining."
    str-use-fail: Unable to use this scroll right now.
</nowiki>