MagicSpells/卷轴

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

用法：手握一张纸后输入/cast scroll <魔法名> [使用次数]

设置

选项	解释	默认值
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	How many uses a scroll has if the uses isn't specified in the command.	5
max-uses	一个卷轴可以使用的最大次数.	10
item-id	卷轴材质物品ID.	339
right-click-cast	是否使用右键施法.	true
left-click-cast	是否使用左键施法.	false
remove-scroll-when-depleted	Whether to remove the scroll from the player's inventory when the charges run out.	true
charge-reagents-for-spell-per-charge	If this is true, the reagents for each use of the spell will be charged up-front when the scroll is created.	false
require-teach-perm	Whether to require the teach permission for a spell to create a scroll with that spell.	true
require-scroll-cast-perm-on-use	If this is true, the player using a scroll must have the magicspells.cast.scroll node.	true
predefined-scrolls [v2.11]	See below.	空
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	The name the scroll item is given. Use %s for spell name and %u for uses remaining.	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次的闪现技能： 每个预定义卷轴必须指定一个数据值，技能真实名称和使用次数（可选项，如果不填则为默认使用次数）

    predefined-scrolls:
        - 1 blink 10
        - 2 leap 15
        - 3 combust

举例

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.