• 欢迎来到Minecraft插件百科！
  • 对百科编辑一脸懵逼？帮助:快速入门带您快速熟悉百科编辑！
  • 因近日遭受攻击，百科现已限制编辑，有意编辑请加入插件百科企鹅群：223812289

Magic/Custom Spells：修订间差异

来自Minecraft插件百科
跳转到导航 跳转到搜索
 
（未显示同一用户的32个中间版本）
第8行： 第8行：


在阅读了以下教程后，有些网页工具就显得非常有用了:
在阅读了以下教程后，有些网页工具就显得非常有用了:
* [http://reference.elmakers.com/ 参考指南] 深入所有细节，列出了所有参数、行为、效果以及其他本指南中提到的 [http://mine.elmakers.com/legacy/reference/ Legacy version] 1.13-版本专用
* [http://reference.elmakers.com/ 参考指南] 此链接列出了所有参数、行为、效果以及其他本指南中提到的内容
* [http://mine.elmakers.com/#spells Default survival spell list] 查看更高级的内置生存服技能的相关信息，并且把游戏中的关键词转化为相应内容以查到正确的配置
** [http://mine.elmakers.com/legacy/reference/ Legacy version] 1.13-版本专用
* [http://mine.elmakers.com/#spells 默认生存服法术列表] 查看更高级的内置生存服技能的相关信息，并且把游戏中的关键词转化为相应内容以查到正确的配置


== 教学 ==
== 教学 ==
第15行： 第16行：
本教程将由魔法导弹技能开始学习，逐步拨云见日地了解它的组成
本教程将由魔法导弹技能开始学习，逐步拨云见日地了解它的组成


== Spell Anatomy ==
== 分析法术 ==


There are 5 main sections to most spells, which we will cover one at a time:
多数法术有五个主要部分，我们每次讨论一个：


* '''Base Properties''': Basic properties of a spell, such as its icon, SP cost and earn amount, and other information that can't be changed by upgrades, wands or /cast parameters.
* '''Base Properties''': 基础的法术设置，比如图标、SP消耗和SP获取量，以及一些法杖升级或使用/cast parameters无法更改的内容
* '''Actions''': Modern spells use the [[Actions|action system]], which lets you build your own custom behavior for spells based on atomic building block actions.
* '''Actions''': 现在大部分法术使用 [[Magic/Actions|行为系统]], 可以让你灵活地自定义法术的行为，实现你所想的效果
* '''Effects''': These are the visual effects used by a spell, most often something that happens on cast.
* '''Effects''': 有多种施法时产生的视觉效果，一般由施法多个过程触发
* '''Parameters''': Actions can have parameters that change their behavior. Parameters can be changed by spell upgrades, wand overrides or /cast parameters, which makes it easy to test spell tweaks directly in-game.
* '''Parameters''': 行为需要参数来改变它们的视觉效果。参数可以作为进阶法术、法杖或使用/cast parameters时的必备部分，更加直接和方便地测试法术的效果。译者注：参数包含如技能伤害、范围、时效等内容
* '''Costs''': Spells can have casting costs, most often mana, but items, currency and health may be used as well.
* '''Costs''': 法术需要一些消耗才能释放，大多数情况消耗法力，当然物品、金钱和生命值也是可以作为消耗的


== Base Properties ==
== 基础配置 ==


Let's take a look at Magic Missile, [https://github.com/elBukkit/MagicPlugin/blob/master/Magic/src/main/resources/defaults/spells/missile.yml the configuration of which can be found here].
拿Magic Missile【魔法导弹】技能举例, [https://github.com/elBukkit/MagicPlugin/blob/master/Magic/src/main/resources/defaults/spells/missile.yml 它的配置文件在这].


<pre class="">missile:</pre>
<pre class="">missile:</pre>
This is the spell's &quot;key&quot; name. This is what is used when referencing this spell in configs, with the /cast command or /wand commands.
这是技能的 &quot关键&quot; 名。当使用/cast命令或/wand命令时，显示的技能名就是这个，支持非英文


<pre class="">    icon: diamond_axe:160
<pre class="">    icon: diamond_axe:160
     icon_disabled: diamond_hoe:160
     icon_disabled: diamond_hoe:160
     icon_url: http://textures.minecraft.net/texture/2ba95570c7b712713632d4c0d2fc66906613d3850a596a0267c6d763fe741ac</pre>
     icon_url: http://textures.minecraft.net/texture/2ba95570c7b712713632d4c0d2fc66906613d3850a596a0267c6d763fe741ac</pre>
The icon for a spell is the item that will be used to represent it in-game. This can be on a wand, in a shop, as an item, etc.
上述三个分别是：图标、不可用图标（如缺少法力、冷却未到）、图标URL。技能的图标，表现为在游戏中它显示成什么，通常在法杖、商店中作为物品时显示为这里设置的图标


Magic can be configured to use icons from a resource pack (the default), vanilla items, or textured player skulls. If &quot;url''icons''enabled&quot; is set to true in config.yml, spells will use the '''icon_url''' property to create a player skull with a custom texture.
Magic可以使用资源包里的图标(默认技能使用的图标就是),当然原版物品、玩家头颅也可以。如果config.yml的 &quoturl_icons_enabled&quot;设置为true，技能将会使用'''icon_url''' 以通过自定义材质创建玩家头颅作为图标。


Otherwise, spells use the '''icon''' property as their icon. When a spell is not available to cast (out of mana, on cooldown, no permission) the '''icon_disabled''' property is used. (Skull-based icons do not support a disabled icon). In the official Magic resource packs, the disabled icon for each spell is identical to the normal icon, but with a red &quot;no&quot; sign overlayed.
如果不这样设置,那么技能将会采用'''icon'''属性中的内容作为图标。当一个技能暂不可用时 (法力不足、处于冷却、没有权限) ，则会采用 '''icon_disabled''' 属性中的内容作为图标 (头颅图标不支持icon_disabled)。
 
在官方提供的资源包中，每一个技能的不可用图标会和正常图标相同，但是会多一个红色的 &quot;no&quot; 标志覆盖在上面


<pre class="">    upgrade_required_path: beginner
<pre class="">    upgrade_required_path: beginner
     upgrade_required_casts: 40</pre>
     upgrade_required_casts: 40</pre>
Spells can have upgrades. Upgrade spells are defined using the pipe character |, so &quot;missile|2&quot; is Magic Missile Level 2. Spell upgrades inherit from the previous level, meaning they have all of the same properties unless overridden. For example, as [https://github.com/elBukkit/MagicPlugin/blob/master/Magic/src/main/resources/examples/survival/spells/missile.yml#L108 Magic Missile] levels up its range and damage increase.
法术是可以进阶的，进阶法术可通过间隔符号&quot;|&quot;定义,这样的话 &quot;missile|2&quot;就代表着第二级别的 Magic Missile【魔法导弹】 Level 2。


These properties define how upgrading works- in this case for Magic Missile to upgrade, you must be on the &quot;Beginner&quot; path and have cast the spell successfully 40 times.
法术的继承是根据上一级来的，这意味着未覆盖的设置将继承上一级的设置（比如二级技能只是参数里面的伤害和一级不一样，只写了damage的参数，其余继承一级技能的所有设置）
 
举例说明，请查阅[https://github.com/elBukkit/MagicPlugin/blob/master/Magic/src/main/resources/examples/survival/spells/missile.yml#L108 Magic Missile【魔法导弹】] ，二级的魔法导弹会提高射程和伤害
 
这些设置决定了进阶这一功能如何运作，恰如魔法导弹的进阶，你必须处于&quot;Beginner&quot;【初学者】 熟练度并且成功释放法术40次


<pre class="">    category: combat</pre>
<pre class="">    category: combat</pre>
Spells can have categories, this is mainly used for organization in spell books and the /spells command.
技能可以设置类别，主要用于技能书的管理，或用于/spells 命令


<pre class="">    worth: 150
<pre class="">    worth: 150
     earns_sp: 8
     earns_sp: 8
     earns_cooldown: 10000</pre>
     earns_cooldown: 10000</pre>
These define how [[SpellPoints|Spell Points]] work for this spells. The '''worth''' properties is the cost of the spell in spell points. (Or currency, depending on spellshop configuration).
这些设置项决定了 [[Magic/Spell Points|技能点]] 在此技能的运作方式。
'''worth''' 属性指此法术技能点 is the cost of the spell in spell points. (或金钱数, 需要有技能商店的设置)


The '''earns_sp''' property defines the ''maximum'' amount of SP this spell will earn. When a spell earns SP, it goes on cooldown for some amount of time. During this time, the amount of SP you earn for additional successful casts is reduced. This is to prevent players grinding their way through levels quicky.
'''earns_sp''' 属性决定了释放这一法术可获得的技能点 ''最大值'' 。当一个技能被释放时，玩家获得技能点，技能则会进入一段时间的冷却，在这段时间内，法术成功释放时额外获得的技能点数量将会有所削减。这个机制可以防止玩家反复释放技能刷技能点。


The '''earns_cooldown''' property defines how long the SP earn cooldown lasts for this spell. Note that this is not a hard cooldown, the spell can still earn SP, it is just reduced proportionally to how long it has been since the spell last earned SP.
'''earns_cooldown''' 属性决定了技能点的获取冷却持续多久。注意，这并不是严格的冷却时间，在冷却时间内仍然可以获得技能点，但是会根据上次获得技能点的时间成比例减少。


For example, the first time you cast Magic Missile, it will earn 8 SP. If you cast it again 5 seconds later (half of the 10-second cooldown) it will only earl 4 SP.
例如，首次使用Magic Missile【魔法导弹】,将可以获得8技能点，如果在五秒后使用 (假定这个技能自身的冷却是10秒) ，就只会获得4技能点


Magic Missile is the first spell a player will get on the default wand, so as a manner of tutorial its SP cooldown is greatly reduced. The default value for all other spells is 15 minutes.
Magic Missile 【魔法导弹】也是玩家的默认法杖上自带的第一个法术,作为一个默认的教学类技能，它的技能点获取冷却其实是相当短的，其他的法术默认设置都是15分钟


As Magic Missile levels up, its SP cooldown increases until it is on par with other spells.
当Magic Missile【魔法导弹】升级时,它的技能点冷却就和其他法术相同了（其实说的还是插件默认给的配置，可以忽略）


=== In-Game Text ===
=== 游戏内文本 ===


To make localization easier, Magic tries to put all in-game text in messages.yml. Each spell's name and description can be found under [https://github.com/elBukkit/MagicPlugin/blob/master/Magic/src/main/resources/examples/survival/messages/spells.yml#L1 the &quot;spells&quot; section].
如需本地化游戏文本, 可通过messages.yml修改全部的游戏内文本。每一个技能的名字和描述都可以在[https://github.com/elBukkit/MagicPlugin/blob/master/Magic/src/main/resources/examples/survival/messages/spells.yml#L1 &quot;spells&quot; 部分]被找到


However, for convenience you may also put a '''name''' and '''description''' property in a spell's base properties.
不管怎样,处于方便起见你也可以在技能的基础配置里设置 '''name'''【名字】 和 '''description'''【描述】


=== Spell Classses ===
=== class【法术类】 ===


Some older spells, such as [https://github.com/elBukkit/MagicPlugin/blob/master/Magic/src/main/resources/examples/survival/spells/superblob.yml#L10 SuperBlob], use a class property like this:
一些老的法术,如[https://github.com/elBukkit/MagicPlugin/blob/master/Magic/src/main/resources/examples/survival/spells/superblob.yml#L10 SuperBlob【超级气泡】],这一技能就使用了如此一个技能类属性:


<pre class="">superblob:
<pre class="">superblob:
     class: ConstructSpell</pre>
     class: ConstructSpell</pre>
These spells predate the action system, and cannot use actions or have an '''actions''' section.
这些法术早于action【行为】系统，所以这类技能不能使用'''actions'''【行为】部分


The behavior of these spells is completely hard-coded. Each spell has its own class, which can be seen [https://github.com/elBukkit/MagicPlugin/tree/master/Magic/src/main/java/com/elmakers/mine/bukkit/spell/builtin here in the source code].
这些发射的表现形式完全硬代码写死。每一个技能都拥有它独立的类，请查阅[https://github.com/elBukkit/MagicPlugin/tree/master/Magic/src/main/java/com/elmakers/mine/bukkit/spell/builtin 此处提供的源代码]


It is not recommended to use these if you can avoid it since they are not as customizable as action-based spells. However, some spells like engineering magic have not been converted (yet) and use ConstructSpell, for instance.
如果可以避免，则不建议使用这类法术，最好还是使用基于'''actions'''【行为】编写的技能(即现在通行的常用技能)。无论如何，一些技能（如工程魔法）还尚未换用新模式。


== Actions ==
== Actions【行为】 ==


Most spells now use the [[Action System|Actions]]. The '''actions''' section is used to define what actions a spell will perform when cast.
大多数的技能现在都在使用[[Magic/Actions|Actions]]【行为】系统。'''actions''' 部分用于决定一个技能释放时的各种表现形式，是技能的核心部分


Let's look at Magic Missile again:
再来回顾一下 Magic Missile【魔法导弹】:


<pre class="">    actions:
<pre class="">    actions:
第96行： 第104行：
           - class: BreakBlock
           - class: BreakBlock
             ignore_result: true</pre>
             ignore_result: true</pre>
There can be multiple sections of actions, but most spells will have only '''cast''', the actions performed when this spell is cast.
行为可以有多个组成部分，但大部分技能只会有一个 '''cast'''部分,这些行为将在法术释放时得以执行


Actions are often a hierarchy, meaning one action may have &quot;child&quot; actions that it is responsible for running under certain conditions.
行为通常是一个层次化的结构，这意味着一个行为可能有&quot;child&quot;【子行为】，这就可以在特定条件下运行这一层次下的子行为


Each action must have at least a '''class''' property, this defines what action it is. Classes can be found on the [[Actions|Actions]] page, or you can look at [https://github.com/elBukkit/MagicPlugin/tree/master/Magic/src/main/java/com/elmakers/mine/bukkit/action/builtin the source code here].
每一个行为都至少需要有一个'''class''' 【类】属性,类决定了行为会如何运作。类可以在 [[Magic/Actions|行为]] 页面找到,或者你也可以查阅[https://github.com/elBukkit/MagicPlugin/tree/master/Magic/src/main/java/com/elmakers/mine/bukkit/action/builtin 此处提供的源代码]


Note that when referring to the source code, the &quot;Action&quot; part of the class name may be omitted when you use it in a spell configuration.
请注意：当引用源代码时，使用技能配置，&quot;Action&quot;【行为】部分的类名可能被遗漏


Many spells in the builtin configs start off with the &quot;CustomProjectile&quot; action. This action creates a virtual projectile (not a vanilla snowball, arrow, etc) with some extremely customizable behavior.
许多技能的内部配置都是以 &quot;CustomProjectile&quot;【自定义投掷物】开端（就和Mythicmobs的Projectile类似）。这个行为会创建一个虚拟的投掷物而非原版的雪球、箭矢等，通过自定义这个虚拟的投掷物以实现一些灵活的自定义效果。


When the projectile hits a target (either block or entity) it will run it's '''actions''' list.
注：如果说MM的投掷物技能必须要有一个载体如雪球，Magic则不需要，这个投掷物可以通过效果赋予它视觉上的感官而无需依托一个原版投掷物载体。


In this case, when Magic Missile hits it will perform the Damage action and the BreakBlock action. Both are performed no matter the target, but if hitting a block Damage will do nothing, if hitting an entity BreakBlock will do nothing.
当此投掷物击中一个目标时（既可以是方块也可以是实体），将会运行行为列表上的行为


=== Action Parameters ===
在这种情况下，当魔法导弹命中时会执行伤害行为和方块破坏行为。无论目标是什么，这两个行为都会被执行。但如果击中了方块，那么伤害行为就无效，如果击中了实体，那么方块破坏的行为就无效


Every action has some parameters that can change its behavior. These parameters can be put in two places: As properties directly on an action in the '''actions''' list, or as common shared parameters in the '''parameters''' section (see below).
=== 行为参数 ===


In this case, the BreakBlock action has '''ignore_result''' set to true.
每个行为都有一些参数可供修改其表现形式。这些参数可以放到两个地方：直接作为行为列表中的一种属性；或者和其他共享性的参数一样，写在parameters【参数】部分即可（详情见下文）


Every action returns a result, generally success, fail or no_target. For a spell to count as a successful cast, at least one action must return success. This is the only way for it to earn SP, or have the cast count towards the spell upgrade counter.
在此情况下,BreakBlock【方块破坏】行为如有'''ignore_result'''，则会被设置为true


In the case of Magic Missile, breaking blocks is more of a secondary cosmetic effect, and does not count towards earning SP. You must hit and damage an entity for Magic Missile to count as a success.
每个行为都会转向一个结果，通常结果分为：成功、失败或无目标。若要将一个法术算作成功释放，则至少需要有一个最终转向成功的行为。这是唯一能够获得技能点的方法，否则就需要有法术进阶将施法次数计入其中


And so, &quot;ignore_result: true&quot; on the BreakBlock action says to ignore the result of that action, meaning that Damage is the only action that matters for the overall result of the spell.
拿Magic Missile【魔法导弹】举例,破坏方块更多的是一种次要的装饰效果，且不会计入获得技能点。必须通过魔法导弹击中且对实体造成伤害才算做成功计数。


== Effects ==
因此,如果法术有 BreakBlock 行为，&quot;ignore_result: true&quot; 则表示着忽略此行为的结果，这意味着造成伤害是唯一影响法术整体效果的行为


The '''effects''' section defines the visual effects that a spell will use. Spells should generally at least have a '''cast''' effects section so that something visual happens when the spell is cast. Generally some particle FX and a sound are good to make a spell feel meaningful.
== Effects【效果】 ==


Let's look at Magic Missile:
'''effects''' 【效果】部分决定了一个法术将会使用什么样的虚拟效果（譬如说闪电没有实质性伤害和点燃）。通常来说，法术至少要有一个 '''cast'''的效果部分作为技能释放时的效果。给法术添加一些粒子效果和音效通常会让法术变得更加有趣。
 
来再回顾一下Magic Missile【魔法导弹】:


<pre class="">        cast:
<pre class="">        cast:
第141行： 第151行：
             updateLocations: false
             updateLocations: false
             updateDirections: false</pre>
             updateDirections: false</pre>
The '''cast''' section will run when the spell is cast. Each section is really a list, so you can run multiple different effects on cast. Each section in the list can have a few properties:
这里的'''cast'''部分将会在法术释放时运行。每个部分都是一个列表，藉此可以运行多个不同的效果。每一个部分都有一些设置项:


* '''class''': The class of effect. This is sort of outdated and can mostly be ignored and omitted. '''EffectSingle''' means to run a single effect, but most effects in Magic now defer to EffectLib. Other options are EffectRing, EffectTrail and EffectTransform but they are rarely used.
* '''class''': 效果所属的类。可能略微有些过时，可以忽略（译者注：我不认为这个东西可以随便忽略）。'''EffectSingle'''表示只运行一个简单的效果，但如今Magic大部分的效果都依赖于Effeclib。其他的设置为：EffectRing, EffectTrail 以及EffectTransform，但它们很少见也不常用。
* '''sound''': A sound effect to play, which can be a custom sound from a resource pack (such as with &quot;magic.zap''crack&quot; here or a builtin vanilla sound, using its [https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html Sound enum]. **sound''pitch** and '''sound_volume''' can also be used to modify the sound.
* '''sound''': 播放的音效，这个音效可以是资源包中的自定义音效(譬如 &quot;magic.zap_crack&quot;)或原版内置的音效,这里有[https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html 原版音效枚举]
* '''location''': Where the effect should play. This can be '''origin''' (the caster), '''target''' or '''both'''.
**sound_pitch** 和 '''sound_volume''' 分别指音调和音量,译者注：似乎原版音效的音调只能在0.0-2.0之间
* '''color_override''': Wands have personalized colors which can be used by spells. The '''color_override''' property tells the effectlib effects to use the wand color as one if its parameters (usually ''color'', which is how the color of most effectlib effects is controlled). This only works with the redstone and mob_spell particles.
* '''location''': 效果在什么地方播放。这里可以填写 '''origin''' (施法者), '''target'''(目标)或'''both'''(两者)
* '''effectlib''': Magic is deeply integrated with [https://dev.bukkit.org/projects/effectlib EffectLib] and most spells use an effectlib effect. See [https://github.com/elBukkit/MagicPlugin/wiki/EffectLibParameters here for details] on configuring effectlib effects.
* '''color_override''': 通过技能可使法杖拥有个性化颜色。'''color_override'''属性会指示Effectlib使用和参数相同的颜色 (通常来说''color''【颜色】是大部分Effectlib的效果被控制的方式)。此项仅对redstone【红石】和mob_spell【气泡】粒子有效（这两个粒子可采用多种颜色）
* '''effectlib''': Magic和 [https://dev.bukkit.org/projects/effectlib EffectLib]密切相关，大多数法术都在使用Effectlib效果。详见[https://github.com/elBukkit/MagicPlugin/wiki/EffectLibParameters 此处查看]更多有关Effectlib的配置效果


Magic Missile also has a &quot;tick&quot; effect list:
Magic Missile【魔法导弹】也有一个 &quot;tick&quot; 【刻】效果列表:


<pre class="">        tick:
<pre class="">        tick:
         - particle: redstone
         - particle: redstone
           location: target </pre>
           location: target </pre>
In this case you can see that '''class''' has been omitted, EffectSingle will be used as the default class.
在这里可以看出'''class'''可被忽略不写, EffectSingle【单一效果】 将会使用默认类的效果


The '''tick''' effect list is a special set of effects used by the CustomProjectile action. These effects will be shown on every server tick while the projectile is running. They may be shown multiple times per tick, depending on the projectile velocity and configuration, so it's best not to put anything too complex in here.
'''tick''' 效果列表是CustomProjectile使用的一系列特殊的效果。这些效果将在投掷物运动的每服务器tick被触发显现出来（说白了其实和Mythicmobs的投掷物tick类似）。根据投掷物的速度等设置，每tick可以显示多次效果，所以不适宜在这里写太过于复杂的内容。


In this case, we are showing a single '''particle''', whose names come from [https://github.com/Slikey/EffectLib/blob/master/src/main/java/de/slikey/effectlib/util/ParticleEffect.java the EffectLib particle enum].
对于我们现在讨论的这个法术，它只使用了一个简单的'''particle'''【粒子】, 粒子列表可在此处[https://github.com/Slikey/EffectLib/blob/master/src/main/java/de/slikey/effectlib/util/ParticleEffect.java Effectlib粒子枚举]找到


Magic Missile has several other effect blocks, too many to list here. It has special effects for headshots, hitting blocks, etc. If you're curious, take a look at [the configs].(https://github.com/elBukkit/MagicPlugin/blob/master/Magic/src/main/resources/examples/survival/spells/missile.yml#L18).
Magic Missile【魔法导弹】也有一些对方块起效的效果，受限于篇幅不在此处列举。对于爆头、击中方块等也有特殊效果，如果对此感兴趣，可以查阅详细配置(https://github.com/elBukkit/MagicPlugin/blob/master/Magic/src/main/resources/examples/survival/spells/missile.yml#L18)


== Parameters ==
== Parameters【参数】 ==


Spells have several base parameters that can be seen here: [[SpellParameters]]
法术有一些基本参数，请在此处查阅:[[Magic/SpellParameters|法术参数]]（译者注：这些基本参数不受parameters层次管辖，如category description等都是基本参数，不是这一节的重点）


Each action also has its own parameters, which can be seen on the [[Actions|Actions]] page, though it is not completely up to date. Action parameters can also be found [https://github.com/elBukkit/MagicPlugin/blob/master/Magic/src/main/java/com/elmakers/mine/bukkit/action/builtin/CustomProjectileAction.java#L226 in the source code] of each action, by searching for the &quot;prepare&quot; method and looking at what it reads out of its configuration.
每个行为都有它自己特定的参数，具体请查阅[[Magic/Actions|行为]] ,可能没法和插件最新版本完全同步。也可以在 [https://github.com/elBukkit/MagicPlugin/blob/master/Magic/src/main/java/com/elmakers/mine/bukkit/action/builtin/CustomProjectileAction.java#L226 源代码]处找到每个行为对应的参数,通过搜索更好的&quot;prepare&quot; 参数模式以获取它从其配置中读取的内容


Parameters in the '''parameters''' section affect all actions in the spell.
在 '''parameters''' 【参数】层次下的这些参数会影响该法术的全部行为，其设定具有全局性。


Let's look at Magic Missile (TODO: Flesh this out)
再来看看Magic Missile 【魔法导弹】法术：


<pre class="">    parameters:
<pre class="">    parameters:
         allow_max_range: true
         allow_max_range: true #允许最大距离
         velocity: 200
         velocity: 200 #速度
         range: 24
         range: 24 #距离
         hitbox: true
         hitbox: true #碰撞箱
         target_type: Damageable
         target_type: Damageable #目标类型
         player_damage: 2
         player_damage: 2 #对玩家伤害
         entity_damage: 4
         entity_damage: 4 #对实体伤害
         target_breakables: 1
         target_breakables: 1 #目标损害量
         cooldown: 1000
         cooldown: 1000 #冷却
         reorient: false
         reorient: false #重新强制目标面向特定方向
         destructible: solid
         destructible: solid #可破坏
         destructible_durability: 50
         destructible_durability: 50 #可破坏的耐久度
         break_durability: 2
         break_durability: 2 #损坏的耐久度
         undo: 10000</pre>
         undo: 10000 #撤销时间</pre>
=== Headshots ===
=== Headshots【爆头】 ===


The CustomProjectile action can detect when you hit an entity in the head. In this case, it may run a separate set of '''headshot''' actions, or in some cases (like Magic Missile) just use some extra parameters:
CustomProjectile【自定义投掷物】行为会检测法术是否击中实体头部 ,并且可以运行一组独立的'''headshot'''【爆头】行为；对于某些法术 (例如 Magic Missile【魔法导弹】)还可以使用一些额外的参数:


<pre class="">    headshot_parameters:
<pre class="">    headshot_parameters:
       damage_multiplier: 1.5</pre>
       damage_multiplier: 1.5</pre>
So a headshot with Magic Missile multiplies the damage done by 150%.
如此一来，魔法导弹爆头将造成1.5倍伤害


== Costs ==
== Costs【消耗】 ==


Costs are lists of costs required to cast the spell. It is most often just mana, like this:
法术的消耗，在此列表上的一些消耗物将在施法时被消耗，通常来说使用的消耗物是法力，如:


<pre class="">    costs:
<pre class="">    costs:
         mana: 15</pre>
         mana: 15</pre>
== Requirements ==


Spells can have requirements assigned to them, which much be met in order for the player to purchase and use them. This can be used to create reasearch or teching paths, requiring players to have a certain class, skill, spell, etc, before they can purchase the spell.
== Requirements【需求】 ==
 
为了限制玩家购买或使用，法术可以有指定的要求。可以设定一些索引或技术途径，要求玩家必须拥有某项class, skill, spell（这里的class和skill是SkillAPI插件的内容）等才可以购买法术


Right now the current requirements are supported:
当前支持的一些需求:


* Type: skillapi
* Type: skillapi
** skill - Requires the player to have the specified SkillAPI skill
** skill - 需要玩家拥有某个SkillAPI的技能
** class - Requires the player to have the specified SkillAPI class
** class - 需要玩家拥有某个SkillAPI的class


Here is an example requirement block, which might appear in a spell, Selector or other config. It requires the player to have the skillapi skill '''enchanting'''
此处展示了一个需求示例,可能在法术、选择器或其他配置中出现。需要玩家获得Skillapi的技能'''enchanting'''


<syntaxhighlight lang="yaml">    requirements:
<syntaxhighlight lang="yaml">    requirements:
         -  type: skillapi
         -  type: skillapi
         -  skill: enchanting</syntaxhighlight>
         -  skill: enchanting</syntaxhighlight>
'''type''' specifies the type of requirement<br />
'''type''' 指定需求的类型<br />
'''skill''' further specifies that a skill from skillAPI is required, and what that skill is
'''skill''' 进一步指定要求SkillAPI提供技能,并指定此技能到底是什么

2021年8月28日 (六) 15:11的最新版本

插件自定义法术

Magic的法术可以非常复杂，从零开始可能很困难,所以如果默认的内部法术里面有类似于你心中理想的法术，可以试试在此基础上修改修改

Magic的法术类似于脚本事件，可以包含十分复杂的规则、行为和逻辑，借此制作高度自由化的视觉以及游戏体验

工具和参考

在阅读了以下教程后，有些网页工具就显得非常有用了:

  • 参考指南 此链接列出了所有参数、行为、效果以及其他本指南中提到的内容
  • 默认生存服法术列表 查看更高级的内置生存服技能的相关信息，并且把游戏中的关键词转化为相应内容以查到正确的配置

教学

本教程将由魔法导弹技能开始学习，逐步拨云见日地了解它的组成

分析法术

多数法术有五个主要部分，我们每次讨论一个：

  • Base Properties: 基础的法术设置，比如图标、SP消耗和SP获取量，以及一些法杖升级或使用/cast parameters无法更改的内容
  • Actions: 现在大部分法术使用 行为系统, 可以让你灵活地自定义法术的行为，实现你所想的效果
  • Effects: 有多种施法时产生的视觉效果，一般由施法多个过程触发
  • Parameters: 行为需要参数来改变它们的视觉效果。参数可以作为进阶法术、法杖或使用/cast parameters时的必备部分，更加直接和方便地测试法术的效果。译者注：参数包含如技能伤害、范围、时效等内容
  • Costs: 法术需要一些消耗才能释放，大多数情况消耗法力，当然物品、金钱和生命值也是可以作为消耗的

基础配置

拿Magic Missile【魔法导弹】技能举例, 它的配置文件在这. 

missile:

这是技能的 &quot关键" 名。当使用/cast命令或/wand命令时，显示的技能名就是这个，支持非英文 

    icon: diamond_axe:160
    icon_disabled: diamond_hoe:160
    icon_url: http://textures.minecraft.net/texture/2ba95570c7b712713632d4c0d2fc66906613d3850a596a0267c6d763fe741ac

上述三个分别是：图标、不可用图标（如缺少法力、冷却未到）、图标URL。技能的图标，表现为在游戏中它显示成什么，通常在法杖、商店中作为物品时显示为这里设置的图标

Magic可以使用资源包里的图标(默认技能使用的图标就是),当然原版物品、玩家头颅也可以。如果config.yml的 &quoturl_icons_enabled"设置为true，技能将会使用icon_url 以通过自定义材质创建玩家头颅作为图标。

如果不这样设置,那么技能将会采用icon属性中的内容作为图标。当一个技能暂不可用时 (法力不足、处于冷却、没有权限) ，则会采用 icon_disabled 属性中的内容作为图标 (头颅图标不支持icon_disabled)。

在官方提供的资源包中，每一个技能的不可用图标会和正常图标相同，但是会多一个红色的 "no" 标志覆盖在上面 

    upgrade_required_path: beginner
    upgrade_required_casts: 40

法术是可以进阶的，进阶法术可通过间隔符号"|"定义,这样的话 "missile|2"就代表着第二级别的 Magic Missile【魔法导弹】 Level 2。

法术的继承是根据上一级来的，这意味着未覆盖的设置将继承上一级的设置（比如二级技能只是参数里面的伤害和一级不一样，只写了damage的参数，其余继承一级技能的所有设置）

举例说明，请查阅Magic Missile【魔法导弹】 ，二级的魔法导弹会提高射程和伤害

这些设置决定了进阶这一功能如何运作，恰如魔法导弹的进阶，你必须处于"Beginner"【初学者】 熟练度并且成功释放法术40次 

    category: combat

技能可以设置类别，主要用于技能书的管理，或用于/spells 命令 

    worth: 150
    earns_sp: 8
    earns_cooldown: 10000

这些设置项决定了 技能点 在此技能的运作方式。 worth 属性指此法术技能点 is the cost of the spell in spell points. (或金钱数, 需要有技能商店的设置)

earns_sp 属性决定了释放这一法术可获得的技能点 最大值 。当一个技能被释放时，玩家获得技能点，技能则会进入一段时间的冷却，在这段时间内，法术成功释放时额外获得的技能点数量将会有所削减。这个机制可以防止玩家反复释放技能刷技能点。

earns_cooldown 属性决定了技能点的获取冷却持续多久。注意，这并不是严格的冷却时间，在冷却时间内仍然可以获得技能点，但是会根据上次获得技能点的时间成比例减少。

例如，首次使用Magic Missile【魔法导弹】,将可以获得8技能点，如果在五秒后使用 (假定这个技能自身的冷却是10秒) ，就只会获得4技能点

Magic Missile 【魔法导弹】也是玩家的默认法杖上自带的第一个法术,作为一个默认的教学类技能，它的技能点获取冷却其实是相当短的，其他的法术默认设置都是15分钟

当Magic Missile【魔法导弹】升级时,它的技能点冷却就和其他法术相同了（其实说的还是插件默认给的配置，可以忽略）

游戏内文本

如需本地化游戏文本, 可通过messages.yml修改全部的游戏内文本。每一个技能的名字和描述都可以在"spells" 部分被找到

不管怎样,处于方便起见你也可以在技能的基础配置里设置 name【名字】 和 description【描述】

class【法术类】

一些老的法术,如SuperBlob【超级气泡】,这一技能就使用了如此一个技能类属性: 

superblob:
    class: ConstructSpell

这些法术早于action【行为】系统，所以这类技能不能使用actions【行为】部分

这些发射的表现形式完全硬代码写死。每一个技能都拥有它独立的类，请查阅此处提供的源代码

如果可以避免，则不建议使用这类法术，最好还是使用基于actions【行为】编写的技能(即现在通行的常用技能)。无论如何，一些技能（如工程魔法）还尚未换用新模式。

Actions【行为】

大多数的技能现在都在使用Actions【行为】系统。actions 部分用于决定一个技能释放时的各种表现形式，是技能的核心部分

再来回顾一下 Magic Missile【魔法导弹】: 

    actions:
        cast:
        - class: CustomProjectile
          actions:
          - class: Damage
          - class: BreakBlock
            ignore_result: true

行为可以有多个组成部分，但大部分技能只会有一个 cast部分,这些行为将在法术释放时得以执行

行为通常是一个层次化的结构，这意味着一个行为可能有"child"【子行为】，这就可以在特定条件下运行这一层次下的子行为

每一个行为都至少需要有一个class 【类】属性,类决定了行为会如何运作。类可以在 行为 页面找到,或者你也可以查阅此处提供的源代码

请注意：当引用源代码时，使用技能配置，"Action"【行为】部分的类名可能被遗漏

许多技能的内部配置都是以 "CustomProjectile"【自定义投掷物】开端（就和Mythicmobs的Projectile类似）。这个行为会创建一个虚拟的投掷物而非原版的雪球、箭矢等，通过自定义这个虚拟的投掷物以实现一些灵活的自定义效果。

注：如果说MM的投掷物技能必须要有一个载体如雪球，Magic则不需要，这个投掷物可以通过效果赋予它视觉上的感官而无需依托一个原版投掷物载体。

当此投掷物击中一个目标时（既可以是方块也可以是实体），将会运行行为列表上的行为

在这种情况下，当魔法导弹命中时会执行伤害行为和方块破坏行为。无论目标是什么，这两个行为都会被执行。但如果击中了方块，那么伤害行为就无效，如果击中了实体，那么方块破坏的行为就无效

行为参数

每个行为都有一些参数可供修改其表现形式。这些参数可以放到两个地方：直接作为行为列表中的一种属性；或者和其他共享性的参数一样，写在parameters【参数】部分即可（详情见下文）

在此情况下,BreakBlock【方块破坏】行为如有ignore_result，则会被设置为true

每个行为都会转向一个结果，通常结果分为：成功、失败或无目标。若要将一个法术算作成功释放，则至少需要有一个最终转向成功的行为。这是唯一能够获得技能点的方法，否则就需要有法术进阶将施法次数计入其中

拿Magic Missile【魔法导弹】举例,破坏方块更多的是一种次要的装饰效果，且不会计入获得技能点。必须通过魔法导弹击中且对实体造成伤害才算做成功计数。

因此,如果法术有 BreakBlock 行为，"ignore_result: true" 则表示着忽略此行为的结果，这意味着造成伤害是唯一影响法术整体效果的行为

Effects【效果】

effects 【效果】部分决定了一个法术将会使用什么样的虚拟效果（譬如说闪电没有实质性伤害和点燃）。通常来说，法术至少要有一个 cast的效果部分作为技能释放时的效果。给法术添加一些粒子效果和音效通常会让法术变得更加有趣。

来再回顾一下Magic Missile【魔法导弹】: 

        cast:
        -  class: EffectSingle
           sound: magic.zap_crack
           location: origin
           color_override: color
           effectlib:
             class: ConeEffect
             iterations: 10
             particle: redstone
             lengthGrow: 0.1
             radiusGrow: 0.003
             updateLocations: false
             updateDirections: false

这里的cast部分将会在法术释放时运行。每个部分都是一个列表，藉此可以运行多个不同的效果。每一个部分都有一些设置项:

  • class: 效果所属的类。可能略微有些过时，可以忽略（译者注：我不认为这个东西可以随便忽略）。EffectSingle表示只运行一个简单的效果，但如今Magic大部分的效果都依赖于Effeclib。其他的设置为：EffectRing, EffectTrail 以及EffectTransform，但它们很少见也不常用。
  • sound: 播放的音效，这个音效可以是资源包中的自定义音效(譬如 "magic.zap_crack")或原版内置的音效,这里有原版音效枚举
    • sound_pitch** 和 sound_volume 分别指音调和音量,译者注：似乎原版音效的音调只能在0.0-2.0之间
  • location: 效果在什么地方播放。这里可以填写 origin (施法者), target(目标)或both(两者)
  • color_override: 通过技能可使法杖拥有个性化颜色。color_override属性会指示Effectlib使用和参数相同的颜色 (通常来说color【颜色】是大部分Effectlib的效果被控制的方式)。此项仅对redstone【红石】和mob_spell【气泡】粒子有效（这两个粒子可采用多种颜色）
  • effectlib: Magic和 EffectLib密切相关，大多数法术都在使用Effectlib效果。详见此处查看更多有关Effectlib的配置效果

Magic Missile【魔法导弹】也有一个 "tick" 【刻】效果列表: 

        tick:
        - particle: redstone
          location: target

在这里可以看出class可被忽略不写, EffectSingle【单一效果】 将会使用默认类的效果

tick 效果列表是CustomProjectile使用的一系列特殊的效果。这些效果将在投掷物运动的每服务器tick被触发显现出来（说白了其实和Mythicmobs的投掷物tick类似）。根据投掷物的速度等设置，每tick可以显示多次效果，所以不适宜在这里写太过于复杂的内容。

对于我们现在讨论的这个法术，它只使用了一个简单的particle【粒子】, 粒子列表可在此处Effectlib粒子枚举找到

Magic Missile【魔法导弹】也有一些对方块起效的效果，受限于篇幅不在此处列举。对于爆头、击中方块等也有特殊效果，如果对此感兴趣，可以查阅详细配置(https://github.com/elBukkit/MagicPlugin/blob/master/Magic/src/main/resources/examples/survival/spells/missile.yml#L18)

Parameters【参数】

法术有一些基本参数，请在此处查阅:法术参数（译者注：这些基本参数不受parameters层次管辖，如category description等都是基本参数，不是这一节的重点）

每个行为都有它自己特定的参数，具体请查阅行为 ,可能没法和插件最新版本完全同步。也可以在 源代码处找到每个行为对应的参数,通过搜索更好的"prepare" 参数模式以获取它从其配置中读取的内容

在 parameters 【参数】层次下的这些参数会影响该法术的全部行为，其设定具有全局性。

再来看看Magic Missile 【魔法导弹】法术： 

    parameters:
        allow_max_range: true #允许最大距离
        velocity: 200 #速度
        range: 24 #距离
        hitbox: true #碰撞箱
        target_type: Damageable #目标类型
        player_damage: 2 #对玩家伤害
        entity_damage: 4 #对实体伤害
        target_breakables: 1 #目标损害量
        cooldown: 1000 #冷却
        reorient: false  #重新强制目标面向特定方向
        destructible: solid #可破坏
        destructible_durability: 50 #可破坏的耐久度
        break_durability: 2 #损坏的耐久度
        undo: 10000 #撤销时间

Headshots【爆头】

CustomProjectile【自定义投掷物】行为会检测法术是否击中实体头部 ,并且可以运行一组独立的headshot【爆头】行为；对于某些法术 (例如 Magic Missile【魔法导弹】)还可以使用一些额外的参数: 

    headshot_parameters:
      damage_multiplier: 1.5

如此一来，魔法导弹爆头将造成1.5倍伤害

Costs【消耗】

法术的消耗，在此列表上的一些消耗物将在施法时被消耗，通常来说使用的消耗物是法力，如: 

    costs:
        mana: 15

Requirements【需求】

为了限制玩家购买或使用，法术可以有指定的要求。可以设定一些索引或技术途径，要求玩家必须拥有某项class, skill, spell（这里的class和skill是SkillAPI插件的内容）等才可以购买法术

当前支持的一些需求:

  • Type: skillapi
    • skill - 需要玩家拥有某个SkillAPI的技能
    • class - 需要玩家拥有某个SkillAPI的class

此处展示了一个需求示例,可能在法术、选择器或其他配置中出现。需要玩家获得Skillapi的技能enchanting 

    requirements:
        -  type: skillapi
        -  skill: enchanting

type 指定需求的类型
skill 进一步指定要求SkillAPI提供技能,并指定此技能到底是什么

取自“https://mineplugin.org/index.php?title=Magic/Custom_Spells&oldid=15889”