[SCT]MagicSpells魔法咏唱WIKI/指南—引进/汉化

作者: 炫宙菌

时间: 2020-12-26 03:18:24 版块: 翻译&Wiki;

翻译作品发布
译文题目:	魔法咏唱 WIKI/指南
原文题目:	Magicspells WIKI
译文地址:	https://www.mcbbs.net/thread-1146171-1-1.html
原文地址:	https://github.com/TheComputerGeek2/MagicSpells/wiki
最后更新:	2021-02-01

本帖最后由炫宙菌于 2021-5-23 12:31 编辑

MagicSpells

WIKI翻译 · 插件指南

前言

原WIKI界面: 点击跳转

站内搬运帖: 点击跳转

旧版搬运帖: 点击跳转

插件Github: 点击跳转

本WIKI适用于Magicspells全版本,部分内容在4.0+移除。

请点击页首菜单浏览不同界面。

全文皆由 @炫宙菌一人负责。

在此感谢 @SHEEP_REALMS (提供某个译名帮助) @黑 (提供插件原理指导) 以及几位帮助者，

此项工作文本量巨大且难度不小，如果对插件没有理解的情况下是很困难的。

个人一些见解和经验已经嵌入WIKI当中了(部分WIKI的笔误已标出)

目前已经翻译了插件WIKI的大部分内容,这些内容帖内有提供Docx文件,

均为本人手动一词一句手翻,受限于个人水平可能有些许谬误。

原WIKI中Spell List部分的全部技能是单独成页的，为了方便起见把同类技能归档到一个楼层。

按下Ctrl+F键可以开启页面搜索，通过关键词找到你想要的设置。

耗时数周，只为了让论坛的各位更好地了解插件，做出卓越超凡的技能。

如有错误请私信/帖内回复指出,我会尽己所能注明并且评分。

字数统计:

使用须知

MagicSpells简称MS；

本帖提及的法术、技能、仙术等词汇指的是一个东西；魔力、法力指的也是一个。

此WIKI中如有翻译者未能确认的功能,则用[?]标出,问号越多代表疑惑越大。

如有需要保留原文参考的部分，则用斜体标出。

每一个章节都有对应的Word(docx)文档版本,如有需要请页末自取。

如有错别字,请指出或忽略。

“||”是行内的分割号，用以区分指令和注解

<>为必填项，[]为选填项，()为注释项

对于某些无技术含量的高度重复内容,则翻译第一条，已经指名且保留理解的可能。

Home/Main Page

主页内容

欢迎来到 MagicSpells W iki!
在一个玩家释放法术之前，他们得先知道法术。这里提供了几个玩家学习法术的方法 :
· 使用命令教会： /c teach
· 从一本技能书架( spellbook) 里学会
· 从一本技能书( tome) 里学会
· 通过 grant 权限获取
· 在商店里买
· 编辑后台的 plugins\MagicSpells\spellbooks\UUID.yml 文件
· 获得通配符权限如 "*" ，将会给玩家使用的权力
一旦一个玩家已经学会了一个法术，他们就有能力释放了，使用 /cast 法术名可指令释放，或者在技能已经绑定在物品上的情况下释放。如果施法物品拥有多个技能，可以右键来切换法术，左键释放（默认设置如此）
如果玩家未拥有法术所需的材料 ( 消耗物 ) ，或者刚刚释放完，则法术不能被释放，除非玩家拥有足够的材料或冷却已结束
如果法力系统已启用，则玩家可以使用 /mana 命令来查看自己的法力值。法力值也是可以配置的，能够作为经验条展示

下载遇到问题? 直接下载

回复:

炫宙菌

本帖最后由炫宙菌于 2021-5-2 00:23 编辑

General Spells

通用类法术

Arrow Spell 箭矢法术
警告 !! 此法术已经废弃且从 Beta5 开始和 Bow Spell 弓法术合并 常规法术 。这是一种 用于作用于 弓的法术 ，当箭击中一个实体或地面时， 将会让bow-name设置的弓名释放一个箭矢法术 。弓名区分大小写 。

可配置项目 :

设置项	描述	默认值	建议
bow-name	能够释放箭矢法术的弓名		不填
spell-on-hit-entity	当箭矢击中一个实体时释放哪一法术?		请填写法术的真名而非使用名
spell-on-hit-ground	当箭矢击中地面时释放哪一法术?		请填写法术的真名而非使用名
use-bow-force	是否把弓的力度作为法术的强度衡量标准?	true

举例 :

arrow:

spell-class: ".ArrowSpell"

bow-name: " 毁灭之弓 "

spell-on-hit-entity: explode

spell-on-hit-ground: explode

use-bow-force: true

Bow Spell 弓法术
常规法术 , 当设定名字的弓射出箭时触发一个法术 , 弓名区分大小写

可配置项目 :

设置项	Description	默认值	建议
bow-name	作用的弓名		不填
spell	射出箭时触发什么法术?		填写真名而非使用名
use-bow-force	是否把弓的力度作为法术的强度衡量标准?	true

在 beta 5 版本后的 magicspells 才具备以下设置。截至 2020/4/3 ，上面的设置项还未完全更新完。编辑者只是想把这一技能举例放 wiki 上以便查阅。

翻译者在部分设置内容后加注 , 来源于个人经验总结 , 这是原 WIKI 所没有的内容。

举例 :

bow:

spell-class: ".BowSpell" # 技能的归属类型

bow-names: # 以下名字的弓能够触发这一法术 , 建议把这几行全删了

- "Bow Of Volley"

- "Bow Of Volley2"

cooldown: 1 # 冷却时间 , 秒

cancel-shot: false # 是否能取消射击 ?

use-bow-force: true # 是否启用弓力度

cancel-shot-on-fail: false # 施法失败是否撤销技能 ?

str-modifier-failed: " 你未满足施法条件 !" # 条件不满足的提示消息

minimum-force: 0.5 # 最小力度

spell: EFF_ARROW # 使用时触发哪一技能 ? 这也是你已经写好的技能才有效

spell-on-hit-ground: ARROW_GROUND # 射中地面时触发哪一技能 ?

spell-on-hit-entity: ARROW_ENTITY # 射中实体时触发哪一技能 ?

modifiers: # 技能所需条件

- sneaking required # 必须要潜行射击

target-modifiers: # 目标所需条件

- entitytype pig required # 目标种类必须是猪

location-modifiers: # 位置所需条件

- inblock grass_block required 必须在草方块里面

EFF_ARROW: # 弓技能的本体里有写这个技能 , 作为它技能体系的一部分

spell-class: ".instant.DummySpell"

effects: # 效果 , 以下的层次名可以随便取 , 建议英文、数字和下划线组成

eff1:

position: caster # 以施法者为效果的位置

effect: effectlib

effectlib:

particle: REDSTONE # 这里是红石粉末效果

particleSize: 0.8 # 粒子大小

color: ffff00 # 颜色 , 仅对某些可配置颜色的粒子有用

iterations: 20 # 重复次数

period: 3 # 时效

radius: 1.25 # 范围

particles: 40 # 粒子数目

visibleRange: 60 # 可见范围

ARROW_ENTITY:

spell-class: ".targeted.DummySpell"

effects:

eff1:

position: target

effect: effectlibentity

effectlib:

particle: REDSTONE

particleSize: 0.8

color: 00ff00

iterations: 20

period: 3

radius: 1.25

particles: 40

visibleRange: 60

ARROW_GROUND:

spell-class: ".targeted.DummySpell"

effects:

eff1:

position: target

effect: effectlib

effectlib:

particle: REDSTONE

particleSize: 0.8

color: 00ffff

iterations: 20

period: 3

radius: 1.25

particles: 40

visibleRange: 60

Buff Spell Configuration
BUFF 类技能的配置 :

设置项	描述	变量类型	默认值
can-cast-with-item 手持释放	此技能是否可以在手持物品时释放	布尔型	true
can-cast-by-command 指令释放开启	是否可以用/cast 技能名 \|\|指令释放?设置为true将不能用/cast	布尔型	true
targeted 目标法术	是否把此法术作为一个目标法术(是则将遵循 Targeted Spell Configuration 的设置) 如果你的MS版本低于4.0，此选项将无法锁定除玩家之外的其他实体	布尔型	false
toggle 停止	是否可以在激活状态下停止释放。冷却只会在持续阶段结束后计算	布尔型	true
use-cost 消耗	BUFF激活所用的消耗物。The cost will be charged on the interval defined with the option below. 可用消耗物类型: health生命, mana法力, hunger饥饿, experience经验, levels等级, durability耐久, money钱 (必须有前置插件Vault),或物品种类(ID)。所有列表里的物品必须指定数量，或者默认为1，不同消耗品之间需要用空格隔开。	字符串	null
use-cost-interval 消耗间隔	在use-cost设置项内的消耗间隔	整数	0
num-uses 起效次数	法术失效前的起效次数	整数	0
duration 起效时间	以秒为单位控制技能失效前的使用时间。设置为0代表使用时间不受限制	单精度浮点	0
power-affects-duration 强度对时间的影响	法术强度是否影响法术起效时间	布尔型	true
cancel-on-give-damage 致伤取消	当施法者对其他实体造成伤害是否取消BUFF技能	布尔型	false
cancel-on-take-damage 受伤取消	当施法者受到伤害是否取消BUFF技能	布尔型	false
cancel-on-death 死亡撤销	当施法者狗带时是否取消BUFF技能	布尔型	false
cancel-on-teleport 传送撤销	如果服务器把施法者传送走是否撤销技能	布尔型	false
cancel-on-change-world 跨世界撤销	如果施法者传送到其他世界走是否撤销技能	布尔型	false
cancel-on-spell-cast 同时撤销	如果施法者又放了技能是否撤销此技能	布尔型	false
cancel-on-logout 登出撤销	施法者离开服务器是否撤销技能	布尔型	false
spell-on-use-increment 附带法术	当BUFF法术使用时将会触发的另一法术。即便把 num-uses设置为0也会触发一次	字符串	null
spell-on-cost	当buff法术尝试消耗时将触发的法术	字符串	null

Dummy Spell 虚拟技能
这类技能没有设置项的限制、没有专门的设置项 ， 可用于各种各样的技能体系中。 例如使用 instantdummyspell 来改变 变量

变量举例 :

variablechangedummyspell:

spell-class: ".instant.DummySpell"

variable-mods-cast: # 对变量的处理

- variable +1

这样改变变量很方便，因为它对玩家或者周边事物没有什么影响，藉此可以优化你的法术构造，让它更加简单易懂。

种类举例 :

instantdummyspell:

spell-class: ".instant.DummySpell"

buffdummyspell:

spell-class: ".buff.DummySpell"

duration: 20

targeteddummyspell1:

spell-class: ".targeted.DummySpell"

External Command Spell 外部命令类技能

可以让技能执行指令。可以指定 caster 施法者 , targeted player 目标玩家或 console 控制台执行指令。最多支持 10 个自定义的参数供指令使用。

Spell Options 法术设置项

设置项	描述	默认值
can-cast-with-item	可以手持物品施法	true
can-cast-by-command	可以用 /cast 命令施法	true
command-to-execute 命令列表	执行的命令列表，忽略指令的第一个斜杠可用参数请看这里
command-to-execute-later 延迟触发	和 command-to-execute类似但是这里的命令将会在延迟后触发延迟请在command-delay里设置。出于某些原因, 参数 %var 和 %playervar 不能在这里使用
command-delay 延迟时间	以ticks为单位计算延迟执行指令的时间	0
temporary-permissions 暂时权限	一个可供短期提供权限的列表，如若玩家没有执行某些指令的权限就可以用这个功能暂时充当一下。当然使用temporary-op选项会更简便一些。
temporary-op 暂时OP	一目了然。这一操作近似瞬间发生，所以你不必担心玩家在被赋予暂时OP权限时使用其他指令干坏事	false
require-player-target	需要玩家目标	false
block-chat-output 公屏静默	设为true将会阻止聊天框输出指令内容	false
str-blocked-output 屏蔽输出文本	当 bloc k -chat-output设为true时发送给玩家的自定义字符串
execute-as-target-instead 以目标代替执行	如果require-player-target设置为true则以目标玩家身份执行命令	false
execute-on-console-instead 以后台代替执行	同上，但是是后台	false
str-cant-use-command 无法使用提示	玩家没有权限执行指令时的提示消息(字符串)	&4You don't have permission to do that.
do-variable-replacement 变量替代	你可以使用%var 或 %playervar参数运用在指令里	false
use-target-variables-instead 使用目标参数替代	如果do-variable-replacement 和 require-player-target设置为true, 则会分析目标玩家的%var变量参数并取代施法者的	false

参数

你设置的命令中可以使用以下参数来丰富某些内容

变量	描述
%a	施法者的用户名
%t	如果require-player-target设置为true,会填写目标玩家的用户名
%1-%9	Index参数。输入指令/c extCmdSpell hi there 将会用 %1 取代 "hi" ；用 %2 取代 "there". 相当于执行命令中空格后内容的描述符号
%var:varName%	需要do-variable-replacement设置为true. p layerstring变量只可以在此参数中被插件成功解析。插件将会把varName填充为变量值。在变量名后添加 :(英文冒号 ) 来指定变量所用的小数的位数(小数点后精确值)。假如varName数值是10.51。如果没有指定则会被分析为 "10.51"。设置为1将会分析为 "10.5", 0则会成 "10". 如果require-player-target 和 use-target-variables-instead都设置为true , 则将会使用目标玩家的变量
%playervar:playerName:varName:0%	需要do-variable-replacement设置为true。和上面参数设置类似但是它不支持全局变量 ( 或上文提到的playerstring变量).你可以借助ExternalCommandSpell 最后两个设置项来用目标玩家的用户名实现此功能
%arg:(index):defaultValue%

举例

console: # 以控制台身份，发出指令 /say 施法者执行了一个外部命令 !

spell-class: ".ExternalCommandSpell"

execute-on-console-instead: true

command-to-execute: ["say %a 执行了一个外部命令 !"]

version: # 以暂时 OP 身份，发出指令查看 MS 及其效果库的版本

spell-class: ".ExternalCommandSpell"

temporary-op: true

command-to-execute: [version MagicSpells]

command-delay: 20

command-to-execute-later: [version Effectlib]

maxhp:

# 设置最大生命值 :

# /c maxhp ( 数值 )

spell-class: ".ExternalCommandSpell"

temporary-op: true

command-to-execute: ["c modifyvariable meta_max_health %a =%1"]

tpToBed: # 回到床上

spell-class: ".ExternalCommandSpell"

incantations: ["/home bed"]

temporary-op: true

do-variable-replacement: true

command-to-execute: ["minecraft:teleport %a %var:meta_bed_location_x:0% %var:meta_bed_location_y:0% %var:meta_bed_location_z:0%"]

str-cast-self: " 回到了床的位置 . 如果啥也没发生 , 只能说明你没有床或者后台出错了 ."

Instant Spell 瞬发法术
Instant Spell 设置 :

设置项	描述	变量类型	默认值
can-cast-with-item	是否可以手持物品施法	布尔型	true
can-cast-by-command	是否可以/c 指令施法	布尔型	true

Location Spell 位置法术
描述 :

位置法术可以在一个确定的位置释放另一个法术。并非使用施法者的位置或他们所盯着的位置，此法术总会在指定位置释放而不能重定向

可配置项目 :

设置项	描述	默认值
location 位置	法术将会在此位置释放，请遵守此格式：世界名,x,y,z,yaw偏航角,pitch俯仰角	world,0,0,0
spell 法术	将会释放的法术

举例 :

location:

spell-class: ".LocationSpell"

location: world,0,0,0

spell: blink

Menu Spell 菜单法术
可以打开 GUI 的一个法术
配置 :

设置项	描述	默认值
title 标题	菜单的标题。支持参数变量。	"Window Title + (internalName)"
delay 延迟	以tick计算延迟打开菜单。当你使用菜单技能链接技能时，请至少设置值为1	0
require-entity-target 需要实体目标	设置为true则会设定实体以释放技能	false
require-location-target 需要位置目标	设置为true则会设定坐标以释放技能	false
target-opens-menu-instead 让目标打开菜单	设置为true则会让目标实体打开菜单而不是使用者,还需要require-entity-target 设置为true	false
bypass-normal-cast	设置为false则会正常检查消耗物/条件/提示消息/冷却也就是说默认菜单技能是不需要检测这些东西的	true
filler 填充	用途填充空槽位的物品，请参照魔法物品格式	null
stay-open-non-option 保持开启	设置为true则会在空槽位被点击时仍然保持菜单开启。	false
min-rows 最小行	设置为true，将会创建并填充预定行数的菜单。为false，行数将依据已填充的物品位置确立其行数。	false
options 选项	可开启Option configuration设置，名字可以随意

Option configuration 选项设置 :

设置项	描述
slot 槽位	放置物品的槽位。如果两个物品有同样的槽位，后一个将覆盖前一个。modifiers条件可以被用于控制槽位并且根据条件显示特定物品。
slots 槽位	放置物品的槽位。和上面的一样。如果都填了内容, slot里的内容则会被忽略
item 物品	展示用的魔法物品。可以用遵从魔法物品格式的字符串形式或设置部分。自定义物品名称和lore都支持变量参数。
items	展示用的魔法物品的清单。遵从魔法物品格式以随机选择一个物品。同理如果这里设置了内容那么上面的就会取消。
quantity 数量	指定物品的数量，可以是一个变量名。
modifiers 条件	设置条件以决定是否在槽位内显示物品。
spell 法术	左键后将释放法术
spell-right 右键法术	右键后将释放法术
spell-middle 中键法术	中键后将释放法术
spell-sneak-left 潜行左键法术	一目了然
spell-sneak-right 潜行右键法术	一目了然
power 强度	法术强度
stay-open 保持开启	当菜单内物品被点击时是否还开启菜单。如果物品附带一个成功释放的法术，菜单将会重新开启(刷新)。如果没有成功释放也不会关闭菜单。

举例 :

Menu:

spell-class: ".MenuSpell"

cooldown: 2

bypass-normal-cast: false

options: # 你可以设置多个选项

option1: # 名字随便取

slot: 0 # 首个槽位，请在 0 到 53 的自然数里写一个

item: stone

quantity: 64

stay-open: false

option2:

slot: 1

item: stone

quantity: 32

stay-open: true # 选定时保持开启菜单

CoordsMenu: # 一个简单的使用条件变量的菜单法术的例子

spell-class: ".MenuSpell"

cast-item: compass

title: "&4 这个 GUI 可以显示你的状态 !"

options:

coordinates:

slot: 1

item: # 在本例中，item选项作为一个配置部分

type: compass

lore:

- "&9 你现在位于 ..."

- "&cX: &4%var:meta_location_x:0% &cY: &4%var:meta_location_y:0% &cZ: &4%var:meta_location_z:0%"

stay-open: true

bedcordinates:

slot: 7

item:

type: bed

lore:

- "&9 你的床现在在 ..."

- "&cX: &4%var:meta_bed_location_x:0% &cY: &4%var:meta_bed_location_y:0% &cZ: &4%var:meta_bed_location_z:0%"

stay-open: true

MultiSpell 多重法术

多重法术可以用来组合多个法术形成一个新法术，这样你就可以同时用不止一个法术了，或者在几个法术里面随机触发一个。

可配置项目 :

设置项	描述	默认值
cast-random-spell-instead 使用随机法术	是否使用列表内的随机一个法术，否的话则是使用列表内全部法术。	false
enable-custom-spell-cast-chance 开启自定义概率法术	是否在法术后带一个权重（和概率类似不过可以总量可以自定义） (例如: 火球术:2 ) 而不是在所有法术里随机加权选择(乱选)	false
enable-individual-chances 开启单独概率	设置为true , 则每个法术都将被单独处理，这意味着随机概率将会被分开计算，并且可能对每个将释放的法术都会计算。设置为false , 概率将会一起计算，所以只有一个法术将会被释放。	false
spells 法术	多重法术的列表。默认地，法术将会同时释放，但你可以使用使用特殊的“DELAY #”延迟伪法术来增加法术间的延迟。（见下文）	空

Delays 延迟 :
你可以把延迟安插在法术之间，只需要使用 “DELAY #” 来伪造法术 ( 把延迟也视作一个法术 ) , 这里的 # 单位是服务器 ticks( 正常情况下 1 秒 =20ticks) 。这么做只是简单地延迟了法术的释放，并不能保持多重法术中法术的具体组成状态 ( 比如粒子效果并不能延缓抛出 ) 。如果玩家移动或转向，那么被延迟的法术将会重新按照它真正开始时的状态计算，而不是保持第一个法术释放的状态来。举例说明：两个对着准星位置发射火球的技能合并为一个多重法术，延迟为 20ticks ，那么，玩家第一颗火球会正常发射，然后玩家把准星从正东转向正西，第二颗火球就会朝着正西发射 ( 这两个火球技能完全一样 ) 。

举例 : 延迟技能

froghop: # 蛙跳 , 大概用途就是连续冲刺跳三次

spell-class: ".MultiSpell"

spells:

- froghop_leap1

- DELAY 12 #( 约等待 0.6 秒 )

- froghop_leap2

- DELAY 16 #( 约等待 0.8 秒 )

- froghop_leap3

froghop_leap1: # 蛙跳 1

spell-class: ".instant.LeapSpell"

forward-velocity: 2

upward-velocity: 2

froghop_leap2: # 蛙跳 2

spell-class: ".instant.LeapSpell"

forward-velocity: 4

upward-velocity: 4

froghop_leap3: # 蛙跳 3

spell-class: ".instant.LeapSpell"

forward-velocity: 6

upward-velocity: 6

Example: 使用 随机法术

coinflip:

spell-class: ".MultiSpell"

cast-random-spell-instead: true

spells:

- coinflip_heads(mode=hard)

- coinflip_tails(mode=hard)

coinflip_heads:

spell-class: ".instant.DummySpell"

str-cast-self: "硬币正面朝上!"

coinflip_tails:

spell-class: ".instant.DummySpell"

str-cast-self: "硬币背面朝上 !"

Example: 开启自定义概率法术

rigged_coinflip:

spell-class: ".MultiSpell"

cast-random-spell-instead: true

enable-custom-spell-cast-chance: true

spells:

- rigged_coinflip_heads(mode=hard):1 # 概率为十一分之一

- rigged_coinflip_tails(mode=hard):10 # 概率为十一分之十

rigged_coinflip_heads:

spell-class: ".instant.DummySpell"

str-cast-self: " 硬币正面朝上 !"

rigged_coinflip_tails:

spell-class: ".instant.DummySpell"

str-cast-self: " 硬币背面朝上 !"

Example: 开启单独概率

flowergarden:

spell-class: ".MultiSpell"

cast-random-spell-instead: true

enable-individual-chances: true

str-cast-self: "----------"

spells:

- flower1(mode=hard):75 #(75%的几率被施放，不论其他两个法术触发概率如何 )

- flower2(mode=hard):50 #(50%的几率被施放，不论其他两个法术触发概率如何 )

- flower3(mode=hard):25 #(25%的几率被施放，不论其他两个法术触发概率如何 )

flower1: # 有 75% 概率触发 flower1

spell-class: ".instant.DummySpell"

str-cast-self: " 玫瑰绽放 !"

flower2: # 有 50% 概率触发 flower2

spell-class: ".instant.DummySpell"

str-cast-self: " 紫罗兰盛开 !"

flower3: # 有 25% 概率触发 flower3

spell-class: ".instant.DummySpell"

str-cast-self: " 牵牛花开花 !"

Offhand Cooldown Spell 副手冷却法术
描述 :

显示玩家的副手槽中堆叠的物品物品附带的的法术冷却时间

可配置项目 :

设置项	描述	默认值
item 物品	放在副手槽显示冷却的物品	stone
spell 法术	显示冷却的法术

举例 :

offhandcooldown:

spell-class: ".OffhandCooldownSpell"

item: stone

spell: prayer

Permission Spell 权限法术
描述 :

临时给使用者一个权限

可配置项目 :

设置项	描述	默认值
duration 时效	以ticks为单位，玩家将会获得权限多久	0
permission-nodes 权限	给使用者的暂时权限,多个权限请换行

举例 :

permission:

spell-class: ".PermissionSpell"

duration: 100

permission-nodes:

- magicspells.grant.*

PassiveSpell 被动法术
描述 :

被动法术和其他法术不同，它们不可以用命令释放或用物品或点击或作为多重技能的组成部分。相反地，被动法术有时被视为很有用的法术，并且它们只能在触发器中的监听内容被触发时才能成功释放。只有这样，被动法术才会继续处理子法术。

根据触发器的指定设置，子法法可以只作用于触发它们的实体。譬如说，无论何时施法者受到攻击，一个 takedamage 类法术将会触发，可连接撕裂法术以反击攻击者。

可配置项目 :

设置项	描述	默认值
chance 概率	被动法术触发其子法术的概率	100
delay 延迟	以ticks为单位控制被动法术释放前的延迟。特例：resourcepack触发器需要这个值为0(同步执行)或者大于0(此时被动法术监听的内容不能被撤销)。	-1
ignore-cancelled 忽略撤销	即使触发器被撤销了,如果使用了其他插件，被动法术的子法术依旧会启用。	true
cast-without-target 无需目标	允许被动法术对一个不存在的目标起效。	false
send-failure-messages 发送失败提示消息	如果施法失败了,插件会发送一条提示消息及原因给玩家。	false
cancel-default-action 取消默认行为	取消激活被动咒语的事件。举例说明,取消一个takedamage触发器将会只抵消伤害。	false
require-cancelled-event 需要撤销事件	如果启用，必须禁用触发器，因为被动法术触发其子法术需要这样。 If enabled the trigger must be cancelled for the passive spell to cast its subspells.	false
cancel-default-action-when-cast-fails 当施法失败时撤销默认行为	即便被动法术失败了也撤销事件。	false
triggers 触发器	一系列与被动技能联系的触发器。	空
spells 法术	按照顺序将会触发的法术。 DELAY (延迟) 不能像在多重法术里那种方式被指定 ,但是你可以使用[Cast Modes]法术模式	空

触发器 :

TriggerVar ( 触发器变量 ) 后面紧跟的字符串需要用空格分隔。一些监听项有着额外的数据，在这都可自定义。

监听项	描述	是否可撤销
takedamage 受伤	当一个实体受到伤害时触发。触发器变量可以不填,但是它可以识别一系列的伤害原因 (请点击超链接)或物品(可以使用自定义名字,用\|分隔)	True
givedamage 致伤	当一个实体对其他实体造成伤害时触发触发器变量可以不填。但是它可以识别一系列的物品(可以使用自定义名字,用\|分隔)	True
fataldamage 致命伤	当一个实体受到致命伤时触发。	True
kill 击杀	当一个实体击杀其他实体时触发。触发器变量仅可以识别这里的生物类型。	False
death 死亡	当一个实体歇菜时触发。	False
respawn 复活	检测到玩家复活事件时触发。	False
join 加入	检测到玩家登入事件时触发。	False
jump 跳跃	检测到玩家“跳跃”时触发。(这里监听的疑似是统计数据里的跳跃次数的变动).	False
quit 退出	检测到玩家退出时触发很不幸，这个事件不能撤销。	False
hitarrow 射箭	当玩家拉弓射中一个实体时触发。触发器变量必须是一个弓或者用“\|”分隔的多个弓。	True
misarrow 闪避箭矢	当玩家从一个弓射出来的箭旁闪过时触发。触发器变量必须是一个弓或者用“\|”分隔的多个弓。	False
blockbreak 破坏方块	当玩家打破一个方块时触发. 触发器变量可以是空，这样不管破坏什么方块都可以。否则，你就需要指定一个方块列表来限制侦听器	True
blockplace 放置方块	当玩家放置一个方块时触发. 触发器变量可以是空，这样不管放置什么方块都可以。否则，你就需要指定一个方块列表来限制侦听器	True
rightclickitem 右键物品	当玩家右键一个方块或手持一个物品时触发. 触发器变量可以指定物品列表，列表中物品自定义名可用“\|”分隔 Fires whenever a player right clicks a block or airwhile holding an item .	True
rightclickblocktype 右键方块类型	当玩家右键一个指定的方块类型时触发。触发器变量可以监听一系列方块(列表)。	True
rightclickblockcoord 右键方块位置	当右键特定位置的方块时触发。触发器变量可以识别多个坐标。格式为世界名,x,y,z, ,多个坐标间请用“;”符号连接。	True
leftclickblocktype 左键方块类型	当玩家左键一个指定的方块类型时触发。触发器变量可以监听一系列方块(列表)。	True
leftclickblockcoord 左键方块位置	当左键特定位置的方块时触发。触发器变量可以识别多个坐标。格式为世界名,x,y,z, ,多个坐标间请用“;”符号连接。	True
rightclickentity 右键实体	当右键特定位置的方块时触发。触发器变量可以监听一系列方块 (列表)。	True
spellcast 法术释放	当一个法术被“释放”时触发,但不是“被触发” "casted" . 触发器变量可以是一系列可用技能作为白名单。	True
spellcasted 法术被释放	当一个法术被“被释放” "casted" 时触发,但不是“触发”. 触发器变量可以是一系列可用技能作为白名单。	False
spelltarget 法术锁定	当一个实体用法术锁定目标时触发。触发器变量可以是一系列可用技能作为白名单。	True
spelltargeted 法术被锁定	当一个实体音被法术为锁定目标时触发。触发器变量可以是一系列可用技能作为白名单。	True
startsprint 开始疾跑	当一个玩家开始冲刺时触发。这一事件可被撤销,但只会在服务器层面发生 but this only happens on the server side. 使用meta变量来衡量饥饿值 to mess with food ，而不是阻止玩家疾跑。	False
stopsprint 停止疾跑	当一个玩家停止冲刺时触发。这一事件不可被撤销, 但只会在服务器层面发生 but this only happens on the server side. 这个没有解决方法(如何让一个玩家保持疾跑?似乎服务端办不到这样,但是可以让玩家不疾跑)。	False
startsneak 开始潜行	当一个玩家开始潜行时触发。这一事件可被撤销, 但只会在服务器层面发生。	False
stopsneak 停止潜行	当一个玩家停止潜行时触发。这一事件可被撤销, 但只会在服务器层面发生。	False
startswim 开始游泳	当一个玩家开始游泳时触发。	True
stopswim 停止游泳	当一个玩家停止游泳时触发。	True
startfly 开始飞行	如果玩家可以飞行，那么在他开始飞行时（双空格跳跃）触发。	True
stopfly 停止飞行	如果玩家可以飞行，那么在他停止飞行时（双空格跳跃）触发。	True
hotbarselect 热键选定	当玩家选定一个与触发器变量符合的特定物品时触发。	True
hotbardeselect 热键非选定	当玩家不选定一个与触发器变量符合的特定物品时触发。	True
dropitem 丢弃物品	当玩家尝试丢弃与触发器变量符合的特定物品时触发，物品之间请用英文逗号隔开，并遵循此格式。此列表留空以适应任何一个物品，即丢弃任何物品都触发。	True
pickupitem 捡起物品	当玩家尝试丢弃与触发器变量列表相符的物品时触发 (可以使用自定义名字，请用“\|”隔开)。此列表留空以适应任何一个物品，即捡起任何物品都触发。	True
craft 合成	当玩家尝试合成与触发器变量列表相符的物品时触发，多个物品用英文逗号隔开并符合此格式。此列表留空以适应任何一个物品	True
fish 钓鱼	当玩家吊起鱼事件发生时触发触发器变量可以依次限制条件 fish, ground, fail, 或实体类型	True
shoot 射击	当一个实体拉弓射箭时触发	True
teleport 传送	当玩家传送时触发。触发器变量可以作为白名单指定一些原因 teleport causes .	True
buff 效果	此事件用以确认被动法术列表中指定的buff法术在可能的情况下对所有实体始终有效	False
ticks	当所有实体占用tick达到触发器变量数值时触发。 Fires for all entities on interval specified with *TriggerVar* (server ticks).	False
worldchange 切换世界	当一个玩家传送到一个指定世界或符合列表的世界里时触发。触发器变量可以是一个或多个用英文逗号隔开的世界。	True
gamemodechange 切换模式	当玩家模式切换时触发。触发器变量可以为空或是要监听的的模式。	True
magicspellsloaded MS重载	当MS插件重载完成时触发。	False
inventoryaction 物品栏行为	当一个玩家打开或关闭物品栏时触发 (如果你打开别人的不管用). 触发器变量可以留空，这样开启或关闭都会触发；当然你可以写 open开启/close关闭来决定触发方式。此事件只能在开启行为中撤销(服务器可以组织玩家开启物品栏，但关闭不可以) 。	True (if open)
inventoryclick 物品栏点击	当玩家点击物品栏时触发。触发器变量形式是 (inventoryAction) (itemCurrent) (itemCursor) -所有参数都是可选填的或具都可以使用通配符()。inventoryAction是物品栏物品/槽位/空位所执行的操作 [??],与此同时null 可以作为通配符使用。 itemCurrent指的是玩家对物品的点击,与此同时null 可以作为通配符使用。 itemCursor 是玩家鼠标所指的物品[?? ] is the item on the player's cursor.* 物品格式请参考此格式。	False
spellselect 法术选中	当玩家使用触发法术的物品选定一个法或绑定后施法时触发。触发器变量可以是一个法术名(真名而非使用名) 或者用英文逗号隔开的多个法术名。	False
potioneffect 药水效果	当实体获得药水效果应用或效果消失时触发。触发器变量格式为： (type种类) (action行为) (cause原因). 所有参数都是可选填的或具都可以使用通配符()。 type 即药水效果类型 , 可作为通配符使用。 action 为药水效果操作 (ADDED/CHANGED/CLEARED/REMOVED等), 可作为通配符使用。 cause 为药水效果原因 ,或事件的起源[?] source of the event*	True
resourcepack 资源包	当玩家更换资源包时触发。触发器变量可以是以下之一: loaded加载, declined去除, failed失败, accepted接受.	False
enterbed 上床	当玩家钻进被窝里时触发。	True
leavebed 起床	当玩家跳出被窝时触发。	True
sheepshear 剪羊毛羊的头发	当玩家剪羊毛时触发。触发器变量可作为白名单限制染色	True
offhandswap 副手切换	当玩家把主手物品切换到副手时触发，或者颠倒过来 - 请使用物品格式 .	True
startglide 开始滑翔	当玩家开始滑翔时	True
stopglide 停止滑翔	当玩家停止滑翔时	True
signbook 笔记	当玩家编辑书本时触发。触发器变量可作为白名单，只有包含由它指定的页面的书籍才会触发。	False

举例 :

darkcloak:

spell-class: ".PassiveSpell"

triggers:

- ticks 20

spells:

- darkcloak_invis

modifiers:

- lightlevelbelow 7 required

Player Menu Spell 玩家菜单法术
描述 :

这个法术可以打开一个上面印有当前在线玩家头的菜单。法术可以指定选定玩家为目标释放。大多数设置项都是可编辑的 , 即使它们不必要被编辑。比如你可以专门地使用函数 function 技能来用变量记录玩家名字被点击的次数。你也可以借助特殊的条件或范围来限制菜单里展示的内容。

注：个人认为这玩意可以当成生死簿 /OP 管理菜单 , 毕竟它可以展示所有玩家的状态并且对他们放技能，至于技能是击杀、传送还是啥其他的就太多了

可配置项目 :

设置项	描述	默认值
title 标题	支持颜色代码、变量参数，可用%a代表施法者的用户名
delay 延迟	Delay in server ticks.	1
radius 范围	设置为0, 则显示所有在线玩家，否则则会显示某范围内的。	0
stay-open 保持开启	当一个玩家在菜单中被选定，这将会决定插件是否把菜单关闭	false
skull-name 头颅名	支持颜色代码、变量参数，可用%a代表施法者的用户名，可用%t代表目标名
skull-lore 头颅的lore	此空为字符串。和上一个选项类似。
skull-name-range 头颅名字范围	如果启用了距离，那么玩家超出这个距离就会显示头颅名字。[?] Skull name displayed if the player is out of range, if range is used.
skull-name-offline 下线头颅名字	和上文一样,不过不支持 %t 参数
spell-offline 下线法术	若选中的玩家下线了则释放一个法术
spell-range 法术距离	如果选中的玩家超出了Spell casted if selected player is out of range.
spell-on-left 左键法术	当头被左键点击时释放法术。如果是目标类法术则将会把选定玩家作为目标。否则就只会正常释放。
spell-on-right 右键法术	同上，不过换成了右键
spell-on-middle 中键法术	同上，不过换成了中键
spell-on-sneak-left 潜行左键法术	同上，不过换成了潜行+左键
spell-on-sneak-right 潜行右键法术	同上，不过换成了潜行+右键
player-modifiers 玩家条件	如果这些条件不可通过，那么玩家将不会显示在菜单里。
variable-target 目标变量	以此变量的形式记录选定玩家的用户名。

举例 :

damagePlayerMenu: # 玩家伤害记录菜单

spell-class: ".PlayerMenuSpell"

always-granted: true

title: "L - Smite | R - Teleport"

# 为目标打开菜单。我们需要施法者在这里打开

target-self: true

# 如果是 false, 将会在点击后关闭菜单

stay-open: true

spell-on-left: lightning

# 点击触发的法术可以不指定。如果没有被指定，点击将不会有任何操作

spell-on-right: teleport

# 对目标的条件将会被逐一检查。如果留空或未指定，将不会检查，这里的意思是玩家不能潜行

player-modifiers: [sneaking deny]

lightning:

spell-class: ".targeted.PainSpell"

helper-spell: true

damage: 5

effects:

Lightning:

position: target

effect: lightning

teleport:

spell-class: ".targeted.ShadowstepSpell"

helper-spell: true

distance: 0

str-no-landing-spot: " 不可以传送这个玩家 ."

variables:

username: {type: playerstring}

selectPlayerMenu:

spell-class: ".PlayerMenuSpell"

always-granted: true

target-self: true

title: "&9 选定传送 "

add-opener: true

# ExternalCommandSpell外部命令类技能扩展可以没有目标 , 而且我们也无须让他此时必须有目标

cast-spells-on-target: false

spell-on-left: teleport

# 这里的字符串数值变量可以在其它法术里使用

variable-target: username

teleport:

spell-class: ".ExternalCommandSpell"

helper-spell: true

do-variable-replacement: true

command-to-execute: ["minecraft:tp %a %var:username%"]

随机法术

从指定设置里释放一个随机法术

设置项	描述	默认值
pseudo-random 伪随机	如果开启, 同样的设置项将不会按顺序检验	true
spells 法术	将会被检验的法术列表。必须后面跟着一个权重(你可以理解为概率...吧) 且权重必须大于 0 ，用空格分隔

举例：

真实的骰子将会按顺序检验

dice:

spell-class: ".RandomSpell"

pseudo-random: false

spells:

- say1 1

- say2 1

- say3 1

- say4 1

- say5 1

- say6 1

伪随机举例：

notSoRandom:

spell-class: ".RandomSpell"

pseudo-random: true

spells:

- say1 1

- say2 1

- say3 1

无论权重是不是在选项中被设置为 10 。此法术将会切换这两个设置的组成部分 ( 预设 ) 以实现伪随机

switch:

spell-class: ".RandomSpell"

pseudo-random: true

spells:

- say1 1

- say2 10

Targeted Spell 目标法术
目标法术配置 :

设置项	描述	变量类型	默认值
always-activate 总是激活	此选项决定：如果法术无法锁定一个有效目标，该法术的状态[?] reagents 是否会被充能 charged ，冷却时间是否照常启用	布尔型	false
play-fizzle-sound 发出火熄灭的声音	如果法术无法锁定一个有效目标，是否播放火焰熄灭的音效以提示玩家(我不明白为什么非要是这个音效)	布尔型	false
target-self 自身为目标	强制把施法者自己作为目标。	布尔型	false
spell-on-fail 失败所触发法术	如果当前法术施法失败则触发另一个法术(e.g. 当技能找不到目标时)	字符串	空
str-cast-target 对目标提示	如若目标是个玩家，就发送一个字符串的提示消息。	字符串	空
str-no-target 无目标提示	如若找不到目标，就发送一个字符串的提示消息给施法者。	字符串	空

TargetedMultiSpell 多重目标法术

这是一个特殊的多重法术，它只对目标法术起效。它对于一切可以以实体或地面为目标的法术都有效。不同之处在于此法术保留了最初的用法，甚至施法者移动或转动视角，而一般的多重法术就做不到。 [?]

The difference with this spell is that it maintains the initial target, even if the caster moves or looks around, unlike the normal Multi Spell.

可配置项目 :

设置项	描述	默认值
require-entity-target 需要实体为目标	此法术是否需要施法者锁定一个实体为目标。	false
point-blank 指向填充	法术是否以玩家为中心，或者法术必须为目标类法术[??] Whether the spell should be centered on the player, or if it should be targeted. 设置为true,此法术将会以施法者为中心。设置为false，此法术将会以目标方块为中心。	false
y-offset Y轴偏离	修改法术相交于目标位置的Y轴偏移量例如：5即以目标上方5格为实际目标位置，可写负数。可用此功能造陨石雨。	0
cast-random-spell-instead 释放随机法术以替代	随机释放法术列表里的法术而不是全部都释放一遍。	false
stop-on-fail 失败则停止	设置为true，那么当法术列表里的一个法术释放失败，插件会停止这一套法术的执行。	true
spells 法术列表	按顺序键入可用的法术。你可以使用使用特殊的“DELAY #”延迟伪法术来增加法术间的延迟(见下文)	empty

举例 : 这个技能意味着消耗 5 魔法 , 无需锁定实体为目标 , 冷却为 10 秒，连续使用三次、每次间隔为 10tick( 一般是 0.5 秒 ) 雷击目标 ( 位置 ) 。

smite:

spell-class: ".TargetedMultiSpell"

cooldown: 10

cost:

- mana 5

str-cost: 5 mana

stop-on-fail: false

require-entity-target: false

spells:

- lightning

- DELAY 10

- lightning

- DELAY 10

- lightning

2020-12-26 05:42:14

炫宙菌

本帖最后由炫宙菌于 2020-12-26 13:55 编辑

Instant Spells

瞬发类法术

BeamSpell 束线技能
Qualified Name 限定名 : com.nisovin.magicspells.spells.instant.BeamSpell
Parent 父系 : InstantSpell 瞬发法术
Functionality 功效 : 制造一个远程攻击的装置，可以发射一条瞬发射线到终点位置。
配置 :

设置项	描述	默认值
relative-offset 相对偏移	束线的起始点的偏移量(此为矢量),格式为X偏移量,Y偏移量,Z偏移量	0,0.5,0
target-relative-offset 目标相对偏移	束线实体目标位置的偏移量(此为矢量)	0,0.5,0
hit-radius 碰撞半径	束线周围的计算碰撞的半径。	2
max-distance 最大距离	束线在被移除前的最大距离。	30
vertical-hit-radius 垂直碰撞半径	垂直方向上束线碰撞半径	2
y-offset Y偏移	相较于施法者的位置，法术开始位置的垂直偏移 ( 将覆盖 relative-offset 选项 )	0
gravity 重力	束线下坠速度，大概和方块正常掉落速度有关。	0
interval 间隔	以ticks为单位，多久播放一次技能的效果。	1
rotation 旋转	束线随时间和举例所旋转的角度。	0
beam-vert-offset 束线垂直偏移	垂直起始位置。	0
beam-horiz-offset 束线水平偏移	水平起始位置。	0
change-pitch 更改俯仰角	是否改变开始位置的俯仰角 pitch	true
stop-on-hit-entity 击中实体则停止	是否应该让束线击中一个实体时停下来 ?	false
stop-on-hit-ground 击中地面则停止	是否应该让束线击中一个地面时停下来 ?	false
spell 法术	当束线击中时触发法术。	""
spell-on-end 结末法术	在束线结束位置释放的法术。	""
spell-on-travel 途中法术	沿束线程度经过每个方块释放的法术	""
spell-on-hit-ground 击中地面法术	当束线击中地面时触发的技能	""

举例 :
LightBeam : # 光束
spell-class : ".instant.BeamSpell"
spell : LightBeamHit # 光束打击
beam-width : 2
y-offset : 0
max-distance : 30
interval : 1

BlockBeamSpell 方块射线法术
限定名 : com.nisovin.magicspells.spells.instant.BlockBeamSpell
父系 : InstantSpell
功效 : 制造一个远程攻击的装置，可以发射一条瞬发射线到终点位置，使用方块特效。
配置 :

设置项	描述	默认值
block-type 方块种类	技能所使用的方块种类	stone
relative-offset 相对偏移	束线的起始点的偏移量(此为矢量),格式为X偏移量,Y偏移量,Z偏移量	0,0.5,0
target-relative-offset 目标相对偏移	束线实体目标位置的偏移量(此为矢量)	0,0.5,0
remove-delay 移除延迟	方块消失的时间	40
health 生命	每个方块的生命值[?]	2000
hit-radius 碰撞半径	束线周围的计算碰撞的半径。	2
max-distance 最大距离	束线在被移除前的最大距离。	30
vertical-hit-radius 垂直碰撞半径	垂直方向上束线碰撞半径	2
gravity 重力	束线下坠速度，大概和方块正常掉落速度有关。	0
y-offset Y偏移	相较于施法者的位置，法术开始位置的垂直偏移 ( 将覆盖 relative-offset 选项 )	0
interval 间隔	以ticks为单位，多久播放一次技能的效果。	1
rotation 旋转	束线随时间和举例所旋转的角度。	0
rotation-x X轴旋转	绕其x轴的旋转	0
rotation-y Y轴旋转	绕其y轴的旋转	0
rotation-z Z轴旋转	绕其z轴的旋转	0
beam-vert-offset 束线垂直偏移	垂直起始位置。	0
beam-horiz-offset 束线水平偏移	水平起始位置。	0
small 缩小	是否把方块缩小	false
use-hp-fix 使用HP恢复	是否使用HP恢复	false
change-pitch 变动俯仰角	是否改变起始位置的俯仰角	true
stop-on-hit-entity 击中实体则停止	是否应该让束线击中一个实体时停下来 ?	false
stop-on-hit-ground 击中地面则停止	是否应该让束线击中一个地面时停下来 ?	false
spell-on-end 结末法术	在束线结束位置释放的法术。	""
spell-on-travel 途中法术	沿束线程度经过每个方块释放的法术	""
spell-on-hit-ground 击中地面法术	当束线击中地面时触发的技能	""

举例 :
StoneBeam:
spell-class: ".instant.BlockBeamSpell"
spell: StoneBeamHit
block-type: stone
max-distance: 20
hit-radius: 1
remove-delay: 20
interval: 1
y-offset: 0.5
rotation-x: 0
rotation-y: 0
small: false
use-hp-fix: true

CastAtMarkSpell 标记处法术
瞬发类法术。可在你标记的位置释放另一个法术。 设置项 :

设置项	描述	默认值
mark-spell 标记法术	制造标记的那个法术的真名。	""
spell 法术	在标记点释放的那个法术的真名。	""
str-no-mark 无标记提示	如果玩家没有标记地点就发送一个提示消息。	You do not have a mark specified

举例 : 在标记处释放爆炸 (explode) 法术
castatmark :
spell-class : ".instant.CastAtMarkSpell"
mark-spell : mark
spell : explode
str-no-mark : " 你尚未设置一个标记点 "

ConfusionSpell 迷惑法术
瞬发类法术。可让周围怪物自相残杀。 设置项 :

设置项	描述	默认值
radius 范围	此法术有效范围。	10

举例 :
confusion :
spell-class : ".instant.ConfusionSpell"
description : 让周围的怪物彼此攻击
cast-item : stick
cooldown : 20
radius : 10
cost :
- mana 30
str-cost : 30 mana
str-cast-self : 你让周围的怪物们自相残杀了起来。

ConjureBookSpell 召唤书法术
描述 : 使用法术召唤一本可自定义格式的书
可配置内容 :

Option	描述	默认值
pickup-delay 回收延迟	如果 add-to-inventory 设置为 false, 这个选项就会决定回收延迟。(单位为ticks)	0
gravity 重力	是否让其漂浮	true
add-to-inventory 添加至物品栏	是否让烟花掉落或生成于下一个空槽位	true
title 标题	书的标题	"Book"
author 作者	书的作者	"Steve"
pages 页	字符串格式。支持颜色代码。	null
lore	物品lore。支持颜色代码。	null

举例 : book :
spell-class : ".instant.ConjureBookSpell"
add-to-inventory : false
pickup-delay : 100
title : " 魔法书 "
author : "nisovin"
pages : ["&9 这个看上去 ...","&9 你被戏耍了 &4{{disp}}&9."]
effects :
cloud :
position : special
effect : particlecloud
particle-name : endRod
radius : 2
radius-per-tick : 0.01
duration : 100
y-offset : 0.2

ConjureFireworkSpell 烟火召唤法术
描述 : 召唤一个可配置的烟花
可设置项 :

设置项	描述	默认值
count 数量	烟火数量	1
flight 飞行时效	飞行时效	2
pickup-delay 回收延迟	如果 add-to-inventory 设置为 false, 这个选项就会决定回收延迟。(单位为ticks)	0
gravity 重力	是否让其漂浮	true
add-to-inventory 添加至物品栏	是否让烟花掉落或生成于下一个空槽位	true
firework-name 烟火名	烟火的名字	""
firework-effects 烟火效果	应用于烟火的效果	null

举例 : fireworks :
spell-class : ".instant.ConjureFireworkSpell"
count : 10
flight : 2
gravity : true
add-to-inventory : false
pickup-delay : 200
firework-name : "&2&l 红绿大烟花 "
firework-effects :
- largeball FF0000,00FF00

ConjureSpell 召唤法术
限定名 : com.nisovin.magicspells.spells.instant.ConjureSpell
父系 : InstantSpell
功效 : 用不同方式生成物品
可配置内容 :

设置项	描述	默认值
delay 延迟	施法开始与物品召唤的延迟	-1
pickup-delay 回收延迟	如果 add-to-inventory 设置为 false, 这个选项就会决定回收延迟。(单位为ticks)	0
required-slot 需要槽位	如果 "add-to-inventory" 设置为true，那么强制生成的物品出现在指定槽位，即使那个槽已经有物品了。	-1
preferred-slot 优化槽位	如果 "add-to-inventory" 设置为true，那么强制生成的物品出现在指定槽位，并且这个槽位必须没有其他物品才可以放置(防止吞物品)	-1
expiration 过期[?]	Item expiration.	0
random-velocity 随机速度	如果 "add-to-inventory" 设置为false且这里的值大于0 , 生成的物品将会获得随机的速度。	0
offhand 副手	如果 "add-to-inventory" 设置为true，那么此选项决定了物品是否出现在副手槽。	false
auto-equip 自动装备	是否自动装备盔甲一类。如果玩家已经装备东西了，那么这个就没有效果啦。	false
stack-existing 存在则堆叠	设置为 true, 召唤的物品将会放入已有物品的堆叠数量里面。	true
gravity 重力	如果 "add-to-inventory" 和此选项设置为false , 物品将不会受到重力影响。	true
add-to-inventory 添加至物品栏	如果设置为 true, 召唤的物品将会被直接添加进施法者的物品栏里面。设置为false，将会在施法者脚边掉落。	false
add-to-ender-chest 添加至末影箱	是否把召唤的物品放到施法者末影箱里面。	false
ignore-max-stack-size 忽略最大堆叠	是否忽略召唤物品本身的堆叠限制。	false
power-affects-chance 强度影响概率	法术强度是否影响掉落物品的概率。	true
drop-if-inventory-full 物品栏已满则掉落	如果 "add-to-inventory" 设置为true且物品栏已满且此项为true，物品将会在玩家狡辩掉落。否则这个物品就不会被召唤。	true
power-affects-quantity 强度影响数量	法术强度是否影响掉落物品的数量。	false
force-update-inventory 强制更新物品栏	是否强制对物品栏进行一次刷新。	true
calculate-drops-individually 单独计算掉落	设置为 true, 每一个掉落物都会被单独处理，这意味着随机概率将会被分开计算，这将是对于任何掉落物而言的。设置为 false, 掉落物将会一起计算，这样的话随机概率会被插件认作是最高100%，因此其中一个物品将会掉落。	true
items 物品	生成的物品清单 ( 格式请见下文 )	null

物品格式 : 每一个清单内的物品请遵守此格式为 :
itemtype 物品类型 quantitymin 最小数量 [-quantitymax 最大数量 ] [chance% 概率 ]
你也可以召唤卷轴 scroll 和技能 tomes , 格式如 : ( 这个技能书是 spells-command.yml 的那个 )
SCROLL:scroll_spell_name 卷轴法术名 :spell_name_to_put_on_scroll 卷轴上的法术名 :uses 使用次数
TOME:tome_spell_name 技能书 :spell_name_to_put_on_tome 技能书上的法术名 :uses 使用次数
一个简单的例子 :
331 5-7 → 将会掉落 5-7 个红石
265 1-2 10% → 有 10% 概率会掉落 1-2 个铁锭
351:4 1 10% → 有 10% 概率会掉落 1 个青金石
SCROLL:scroll:blink:5 → 将会掉落一个可释放 5 次 blink 技能的卷轴 A scroll with five charges of blink will drop
TOME:tome:leap:1 → 将会掉落一个教人使用 leap 技能的技能书
举例 :
conjure :
spell-class : ".instant.ConjureSpell"
name : conjure
spell-icon : redstone
描述 : 召唤一些炼药的材料
cast-item : book
cooldown : 600
power-affects-quantity : false
power-affects-chance : true
calculate-drops-individually : true
auto-equip : false
items :
- redstone 1-2 25%
- glistering_melon_slice 1 25%
- magma_cream 1-2 25%
- spider_eye 1-2 25%
add-to-inventory : false
str-cost : free
str-cast-self : 你变魔术般地掏出来了一堆炼药材料 !

CraftSpell 合成法术
瞬发类法术 . 不用 工作台就 能够 打开工作台 . 举例 :
craft :
spell-class : ".instant.CraftSpell"
cooldown : 20
cast-item : stick

DowseSpell 探索法术
瞬发类法术。 在某个范围内找到方块或实体 。
设置项 :

Option	描述	默认值
block-type 方块种类	将搜索的方块种类 . 将覆盖实体种类设置。	""
entity-type 实体种类	将搜索的实体种类	""
str-not-found 未找到提示消息	如果方块没有找到则发送一条提示消息。(原文没写如果没找到实体的情况)	No dowsing target found. (未找到目标。)
radius 范围	搜索范围。会受到法术强度影响。	4
set-compass 设置	是否设置罗盘目标为找到的实体/方块。	true
rotate-player 旋转玩家	是否旋转玩家以面朝找到的方块/实体。	true

举例 :
dowse :
spell-class : ".instant.DowseSpell"
name : dowse
描述 : 寻找铁矿
cast-item : book
cooldown : 60
block-type : iron_ore
entity-type : ""
radius : 4
rotate-player : true
set-compass : true
cost :
- mana 35
- stone 2
str-cost : 35 法力和 2 石头
str-cast-self : 附近有铁矿。
str-not-found : 附近木有铁矿。
mob_dowse :
spell-class : ".instant.DowseSpell"
name : mobdowse
description: 探测一下附近有没有爬行者 !
cast-item : book
cooldown : 60
block-type : ""
entity-type : "creeper"
radius : 10
rotate-player : true
set-compass : true
cost :
- mana 35
str-cost : 35 mana
str-cast-self : 麻也 , 旁边就有苦力怕
str-not-found : 附近没有苦力怕。

EnchantSpell 附魔法术
描述 : 此法术可以让施法者用提供的附魔类型附魔物品。这里有一个附魔种类名清单
限定名 : com.nisovin.magicspells.spells.instant.EnchantSpell
父系 : InstantSpell
可配置内容 :

设置项	描述	默认值
enchantments 附魔	什么样的附魔以及等级。	null
safe-enchants 安全附魔	是否采用安全附魔?	true

法术举例 : Holy_Sword:
spell-class: ".instant.EnchantSpell"
enchantments:
- unbreaking 1
- knockback 1
- fire_aspect 1
注意 : 附魔列表的格式不同于其他大多数的法术 , 有时候需要考虑如下的情况 :
enchantments:
- "DAMAGE_ALL 5"
这将有别于在已经准备好的物品上附魔。正因为如此，对插件熟悉的用户也可能会感到迷惑，基于此技能运行的效果中的设想 [????]
It even differs from how enchantments are done on predefined items. Because of this, it may end up confusing even skilled users of the plugin, based on their assumptions of how it should work.

EnderchestSpell 末影箱法术
描述 : 瞬发类法术 , 可以为施法者打开末影箱。
如果施法者拥有 magicspells.advanced.enderchest 权限 , 那么他就可以指定一个玩家名来打开他的末影箱。举例 : /cast enderchest Yu_Tah
法术举例 Enderchest :
spell-class : ".instant.EnderchestSpell"
name : 末影箱
cast-item : blaze_rod
description: 打开末影箱
cooldown : 60

Firenova Spell 新星法术 -4.0已弃用
瞬发类法术，可以在玩家附近召唤一个扩大的火环。

设置项	描述	默认值
tick-speed tick速度	#据翻译者推测此处WIKI被人破坏，猜测此选项的效果是以tick为单位扩散的速度,10即半秒拓展一次。原文驴唇不对马嘴。 Relating to the Charged Wither Skull (与充能的凋灵骷髅头有关)	10
burn-tall-grass 焚烧高草	是否在扩散时烧毁高草?	true

举例 :
firenova :
spell-class : ".instant.FirenovaSpell"
name : 火焰新星
spell-icon : blaze_powder
description : 释放一个火环
cast-item : bone
cooldown : 10
range : 5
tick-speed : 10
burn-tall-grass : true
check-plugins : true
cost :
- mana 15
str-cost : 15 mana
str-cast-self : 你放了一个火环焚烧周围。
str-cast-others : "%a 放了一个扩散的火环 "

FlightPathSpell 飞行轨迹法术
瞬发类法术 . 。 此法术可以让玩家骑上一个实体，旅行至指定地点 。 设置项 :

Option	描述	默认值
speed 速度	移动的速度	1.5
x	目的地的X坐标	0
z	目的地的Z坐标	0
interval	移动的间隔	5
cruising-altitude 巡行绝对高度	施法者在飞向目标位置之前要飞到的高度	150

举例 : flightpath :
spell-class : ".instant.FlightPathSpell"
name : Flightpath
cast-item : stick
cooldown : 20
x : 0
z : 0
cruising-altitude : 150
speed : 1.5

FoodSpell 食物法术
瞬发类法术。 回复饥饿值和饱和度饱和度请见 此界面 设置项 :

Option	描述	默认值
food 饥饿	[size=10.5000pt]恢复多少饥饿值	4
saturation 饱和度	在饥饿消减前添加的饱和度。	2.5
max-saturation 最大饱和度	Max saturation	0

举例 :
Food :
spell-class : ".instant.FoodSpell"
cast-item : stick
cooldown : 10
food : 4
saturation : 2.5

ForcepushSpell 强力推击法术
瞬发类法术。把施法者周围的尸体推走。
设置项 :

Option	描述	默认值
radius 范围	推挤的范围	3
pushback-force 推挤力度	推挤的力度	30
additional-vertical-force 额外垂直力	额外附加一个垂直方向力。	15
max-vertical-force 最大垂直力	推挤的最大的垂直方向力。	20
add-velocity-instead 以增加速度的形式	设置为true将会在原有基础上附加速度而非设定一个速度。	false

举例 :
forcepush :
spell-class : ".instant.ForcepushSpell"
name : 强推
cast-item : stick
cooldown : 20
radius : 8
pushback-force : 20
additional-vertical-force : 20
max-vertical-force : 20
description : Pushes away nearby enemies.
cost :
- mana 75
- redstone 5
str-cost : 75 法力和 5 红石粉
str-cast-self : 你把周边的一切都推开 !

FreezeSpell 冻结法术 -4.0已弃用
瞬发类法术。 喷射雪球 以使实体减速并受到伤害。 设置项 :

Option	描述	默认值
snowballs 雪球量	喷射的雪球数量	15
horizontal-spread 水平扩散	水平扩散的力度。	15
vertical-spread 垂直扩散	垂直扩散的力度。	15
damage 伤害	造成的伤害	3
spell-damage-type 伤害类型	伤害类型 (soon)
slow-amount 减速程度	减速效果强度	3
slow-duration 减速时长	以tick为单位计算	40
gravity 重力	是否不受重力影响	true

举例 :
Freeze :
spell-class : ".instant.FreezeSpell"
name : " 冻结 "
cast-item : book
cooldown : 0
cost :
- mana 0
str-cost : "35 法力 "
str-cast-self : " 你喷射了一堆雪球 !"
snowballs : 15
horizontal-spread : 15
vertical-spread : 15
damage : 3
slow-amount : 3
slow-duration : 40
gravity : true

GateSpell 传送法术
瞬发类法术 .把你传送到一个存在的世界里的特定坐标位置。世界名和坐标都区分大小写。使用 SPAWN 以保证安全的最大 Y坐标数值 ；使用 EXACTSPAWN 来指定精确的坐标，包括 Y坐标 。 设置项 :

Option	描述	默认值
world 世界	传送到哪个世界	CURRENT
coordinates 坐标/位置	传送的位置	SPAWN
str-gate-failed 失败提示消息	如果传送失败则提示消息	Unable to teleport. (不能传送。)

举例 :
Gate :
spell-class : ".instant.GateSpell"
name : Gate
cast-item : book
cooldown : 50
cost :
- mana 10
str-cost : "10 mana."
world : CURRENT
coordinates : SPAWN
str-gate-failed : " 不能传送 "
另一种格式可以使用正确的数值 来传送，也支持俯仰角和偏航角 ， 不过这可以不填，因为不是一定必要。 Gate :
spell-class : ".instant.GateSpell"
name : Gate
cast-item : book
cooldown : 50
cost :
- mana 10
str-cost : "10 法力 "
world : CURRENT
coordinates : "x,y,z,yaw,pitch"
str-gate-failed : " 不能传送 "

ItemProjectileSpell 物品投掷物法术
功效 : 此法术可以把物品当成投掷物扔出去，比如扔一个冰方块作为投掷物。
可配置内容 :

设置项	描述	默认值
item 物品	物品种类，支持魔法物品格式或简单的字符串魔法物品格式	iron_sword
spell-delay 延迟	在 spell-on-delay 法术释放前的延迟。	40
pickup-delay 回收延迟	在实体能够捡起物品之前的延迟。	100
remove-delay 移除延迟	在物品移除之前的延迟。	100
tick-interval 以tick计间隔	播放粒子效果且检测碰撞箱的间隔。单位是ticks。	1
spell-interval 法术间隔	在多个 spell-on-tick 法术释放之间的间隔。	2
item-name-delay 物品展示名延迟	在名称应用于物品之前的延迟。	10
special-effect-interval 特殊效果间隔	播放效果间的间隔。	2
speed 速度	投掷物起始速度。	1
y-offset Y偏移	对于定义的Y坐标，此选项可以设置一个相较于施法者的Y方向偏移量。	0
hit-radius 碰撞半径	[size=10.5000pt]投掷物的碰撞半径	1
vert-speed 垂直速度	垂直方向发射速度	0
vertical-hit-radius 垂直碰撞半径	[size=10.5000pt]抛掷物的垂直碰撞半径	1.5
rotation-offset 旋转偏移	以指定角度旋转起始位置	0
stop-on-hit-ground 触地则停止	是否让技能在触地时停止	true
gravity 重力	是否让物品受重力影响	true
relative-offset 相对偏移量	相较于起始位置的偏移量	"0,0,0"
item-name 物品名	物品名称	""
spell-on-tick 途中法术	当投掷物飞行时释放的法术,和MM的projectile技能有些类似。	""
spell-on-delay 延迟法术	在一个延迟后释放的法术。	""
spell-on-hit-entity 击中实体法术	当投掷物击中一个实体时释放法术。	""
spell-on-hit-ground 击中地面法术	当投掷物击中地面时释放法术。	""

举例 :
itemprojectilepainspell : # 攻击有效的技能
spell-class : ".targeted.PainSpell"
range : 5
damage : 6
itemprojectilefailspell : # 攻击无效的技能
spell-class : ".instant.DummySpell"

itemprojectilespell : # 法术的主体
spell-class : ".instant.ItemProjectileSpell"
speed : 1
vert-speed : 0
hit-radius : 1
y-offset : 0
spell-on-hit-entity : itemprojectilepainspell
spell-on-hit-ground : itemprojectilefailspell
item : iron_sword
以上的意思大致就是 , 发射一把铁剑，速度为 1 击中实体则触发一个攻击用的技能，击中地面则什么也不发生。 ( 现成的效果就类似于飞刀了 )

LeapSpell 跳跃法术
瞬发类技能。依据设置项，此法术会让施法者向某方向跃进。
可对照 VelocitySpel l 法术
设置项 :

设置项	描述	默认值
rotation 旋转	以度为单位更改[前进冲刺]的方向 ( 左 : 90, 右 : -90, 后 : 180, 等等 )	0
upward-velocity 弹射速度	玩家向上弹射的速度。由于摩擦力 , 你不得不设置大于一个值的弹射速度才能成功实现跳跃效果。好比你穿着粗糙鞋底的鞋在粗糙不堪的地面上，适当跳起来会让你向前移动更加轻松。	15
forward-velocity [前进冲刺]	玩家向前的起始速度。负值就会让你往后跳了。	40
client-only [??]	Whether to use packets or not.	false
cancel-damage 取消伤害	在玩家使用此法术时是否忽略下一次的掉落伤害	true
add-velocity-instead 采用加速	在原有基础上给玩家加速而不是由技能设定一个速度。	false
land-spell 触地法术	当坠地时触发法术，只有在受到掉落伤害时触发[???] ( Only works if you take fall damage ).	""

举例 :
leap :
spell-class : ".instant.LeapSpell"
name : leap
cooldown : 6
cast-item : stick
cost :
- mana 10
- feather 1
str-cost : "10 法力和 1 羽毛 "
forward-velocity : 40
upward-velocity : 15
cancel-damage : true

MagnetSpell 磁力法术
瞬发类法术。 可以吸走周围的物品 。 设置项 :

Option	描述	默认值
radius 范围	磁力法术的有效范围。	5
velocity 速度	物品被吸走时的速度。个人感受颇深:在进程设置超过20基本上就是瞬间吸走了，太低的话非常地慢，不过也挺有意思。	1
teleport-items 传送物品	是否直接把物品传送过来，这样就直接忽略速度设置了。	false
force-pickup 强制拾取	是否强制捡走物品	false
remove-item-gravity 移除物品重力	设置为true后吸引的物品将不受重力	false

举例 :
magnet :
spell-class : ".instant.MagnetSpell"
name : magnet
cooldown : 2
cast-item : stick
cost :
- mana 20
- coal 1
str-cost : "20 法力和 1 煤炭 "
radius : 5
velocity : 1
teleport-items : false
force-pickup : false
remove-item-gravity : false

ManaSpell
瞬发类法术， 可恢复法力 . 设置项 :

Option	描述	默认值
mana 法力	能恢复多少法力。负值则会减少法力。	25

举例 :
mana :
spell-class : ".instant.ManaSpell"
name : 法力献祭
cooldown : 30
cast-item : stick
cost :
- health 2
str-cost : "2 生命值 "
mana : 25

MarkSpell 标记法术
瞬发类法术。在施法者的位置做一个标记，配合其他法术使用。
虽然算不上正式的目标类法术，标记法术实现了 “目标位置法术”的效果并且可以在其它目标类法术中释放
While not officially a targeted spell, MarkSpell implements "TargetedLocationSpell" and can be cast in other targeted spells.
设置项 :

Option	描述	默认值
permanent-marks 永久标记	所做标记是否永久存在。	true
enable-default-marks 允许默认标记	是否开启[默认标记]。	false
use-as-respawn-location 作为重生位置	是否让标记作为重生位置(慎用)	false
default-mark [默认标记]	默认设置的标记位置 , 格式为 : 世界名, x, y, z, 俯仰角 , 偏航角	world,0,0,0

举例 :
mark :
spell-class : ".instant.MarkSpell"
name : mark
cast-item : stick
cooldown : 60
description : Marks your location.
permanent-marks : true
cost :
- mana 75
- redstone 5
str-cost : 75 法力和 5 红石粉
str-cast-self : 你在你的位置留下了一个标记欸。

Particle Projectile Spell 粒子投掷物法术
描述 : 发射一个由离子组成的投掷物
可配置内容 :

设置项	描述	变量类型	默认值
start-forward-offset 起始向前偏移	修改开始时的向前偏移。 ( 此选项将覆盖 start-x-offset )	单精度浮点数	1
start-x-offset 起始X偏移	修改开始时的 x 方向偏移。	单精度浮点数	1
start-y-offset 起始Y偏移	修改开始时的y方向偏移。	单精度浮点数	0
start-z-offset 起始Z偏移	修改开始时的z方向偏移。	单精度浮点数	0
target-y-offset 目标Y偏移	修改目标的Y方向偏移。	单精度浮点数	0
relative-offset 相对偏移量	应用于起始位置的相对偏移量。 ( 将覆盖上面所有设置项 )	字符串	"1,1,0"
effect-offset 效果偏移	应用于投掷物位置的效果偏移。	字符串	"0,0,0"
projectile-acceleration 投掷物加速	随时间增加投掷物的速度。	单精度浮点数	0
projectile-acceleration-delay 投掷物加速延迟	以ticks为单位衡量多久投掷物加速一次。	整型数	0
projectile-turn 投掷物转动	每tick飞行时就让投掷物旋转某个角度(此选项设置的是角度,旋转轨迹为圆)	单精度浮点数	0
projectile-velocity 投掷物速度	衡量投掷物的移动速度，粗略估计的话约为每秒多少格方块	单精度浮点数	10
projectile-vert-offset 投掷物垂直偏移	以正切值[?]为形式设置投掷物垂直移动状态的偏移量 An offset of the direction the projectile moves vertically ihorizn *tangent values* .	单精度浮点数	0
projectile-horiz-offset 投掷物水平偏移	以度数为形式衡量投掷物移动的水平偏移量。	单精度浮点数	0
projectile-gravity 投掷物重力	投掷物下坠有多快?粗略估算的话约为每秒多少方块。	单精度浮点数	0
projectile-vert-gravity 投掷物垂直重力	投掷物下坠有多快?粗略估算的话约为每秒多少方块。 ( 覆盖 projectile-gravity )	单精度浮点数	0
projectile-horiz-gravity 投掷物水平重力	应用于水平旋转时的重力 ( 形成螺旋形轨迹 )	单精度浮点数	0
projectile-spread 投掷物扩散	实际上这里设置效果与投掷物精确度成负相关。一个大的值将会导致投掷物更加不精准(霰弹)。	单精度浮点数	0
projectile-vertical-spread 投掷物垂直扩散	实际上这里设置效果与投掷物垂直方向精确度成负相关。一个大的值将会导致投掷物更加不精准 ( 覆盖 projectile-spread )	单精度浮点数	0
projectile-horizontal-spread 投掷物水平扩散	实际上这里设置效果与投掷物水平方向精确度成负相关。一个大的值将会导致投掷物更加不精准 ( 覆盖 projectile-spread )	单精度浮点数	0
tick-interval 以tick计间隔	多久播放一次粒子效果且检查碰撞箱? ( 以 ticks 为单位 )	整型数	2
spell-interval 法术间隔	与 hit-air-during 设置伴随使用 , 在规定的ticks间释放一次 spell-on-tick 的技能。即多久释放一次spell-on-tick的技能。	整型数	20
intermediate-effects 中途效果	在不同位置间时多久播放一次粒子效果。[?] How often to play the particle effects between travelled locations	整型数	0
intermediate-hitboxes 中途碰撞箱	在不同位置间时多久检测一次碰撞箱 How often to check hitboxes between travelled locations	整型数	0
special-effect-interval 特殊效果间隔	多久播放一次粒子效果 ( 单位为 ticks)	整型数	1
max-distance 最大距离	粒子被允许达到的最远距离。	双精度浮点数	15
max-duration 最大时效	粒子消失前的最大存在时间。	双精度浮点数	0
hit-radius 碰撞半径	距离粒子中心点有多大长度判定命中实体。	单精度浮点数	1.5
vertical-hit-radius 垂直碰撞半径	距离粒子中心点垂直距离多少以内算作判定命中实体。	单精度浮点数	1.5
ground-hit-radius 触地半径	距离粒子中心点有多大长度判定命中地面。	单精度浮点数	0
ground-vertical-hit-radius 触地垂直半径	距离粒子中心点垂直距离多少以内算作判定命中地面。	单精度浮点数	0
ground-materials 地面材质	此处填写一个方块材质的列表，用以衡量什么方块算作“地面”	字符串列表	null ( pathable blocks by default )
disallowed-ground-materials 不算触地材质	投掷物将会忽略的“地面”方块类型。你可以使用这个来覆盖一部分默认作为“地面”方块的方块。[?] You can use this to override some blocks in the default pathable list.	字符串列表	null
tick-spell-limit 中途法术限制	可以释放多少次 spell-on-tick 的法术 ? 此值只有大于 0 时才有效。	整型数	0
max-entities-hit 最大命中实体	在投掷物消失前它最多可以击中多少实体。	整型数	0
height-from-surface 相对表面高度	如果 hug-surface 设置为 true, 此选项将会控制投掷物离地的高度。	单精度浮点数	0.6
hug-surface 紧贴表面	此选项决定了投掷物是紧贴路径表面而不是常规地沿着弧线移动。如果设置为 true, 则 projectile-gravity 选项就会被忽略 .	布尔值	false
controllable 可控制飞弹	如果是 true, 此投掷物将会随着你光标的位置飞行。(俗称子弹拐弯,想哪打哪)	布尔值	false
change-pitch 改变俯仰角	如果设置为 false, 投掷物的起始位置的俯仰角将会被设置为0	布尔值	true
hit-self 命中自己	是否让投掷物命中施法者。用以治疗飞弹使用就极好。	布尔值	false
hit-ground 命中地面	投掷物命中地面时是否触发法术	布尔值	true
hit-players 命中玩家	[size=10.5000pt]是否可以命中玩家	布尔值	false
hit-non-players 命中非玩家	是否可以命中非玩家 non-players.	布尔值	true
hit-air-at-end 未命中补救	是否让投掷物在未命中任何东西且达到最大距离时触发技能?	布尔值	false
hit-air-during 空中触发	投掷物是否会在整个飞行过程中触发法术?	布尔值	false
hit-air-after-duration 失效触发	是否让投掷物在未命中任何东西且达到最大时效时触发技能?	布尔值	false
stop-on-hit-entity 命中实体则停止	是否让投掷物在命中实体时停止?如果设置为 false, 将会继续飞行且可以击中多个目标。	布尔值	true
stop-on-hit-ground 命中地面则停止	是否让投掷物在命中地面时停止? 如果设置为f alse, 将会穿透地面且不会停止(除非设置了最大距离和最大时效)。	布尔值	true
stop-on-modifier-fail 条件不满足则停止	若 projectile-modifiers 检测失败，是否让投掷物消失?	布尔值	true
allow-caster-interact 允许施法者交互	是否允许施法者在没有其他玩家的情况下创建交互? Whether the caster can create interactions without other players	布尔值	true
power-affects-velocity 强度影响速度	法术强度是否可以影响到投掷物速度。	布尔值	true
can-target 允许的目标	技能可以命中的目标 ( 覆盖 hit-self , hit-players , hit-non-players 设置 )	字符串列表	null
projectile-modifiers 投掷物条件	投掷物的条件 , 如果条件未满足，投掷物将会停止飞行。	字符串列表	null
interactions 交互	交互列表[???] (- projectileToCollideWith spellOnCollision)	字符串列表	null
spell 法术	默认命中时触发的法术。必须是一个目标类法术以命中实体或地面，取决于上面的设置项如何。	字符串	Empty
spell-on-hit-air 未命中补救法术	当投掷物达到最大距离时所触发的法术，必须是一个目标类法术以命中实体或地面，取决于上面的设置项如何。 ( 需要 hit-air-at-end )	字符串	Empty
spell-on-hit-self 命中自身法术	当投掷物命中了施法者时所触发的法术，必须是一个目标类法术以命中实体或地面，取决于上面的设置项如何。 ( 需要 hit-self )	字符串	Empty
spell-on-tick 中途法术	在投掷物飞行过程中所触发的法术。必须是一个可命中地面的目标类法术，取决于上面的设置项如何。 ( 需要 hit-air-during 和 spell-interval )	字符串	Empty
spell-on-hit-ground 命中地面法术	投掷物命中地面时所触发的法术。必须是一个可命中地面的目标类法术，取决于上面的设置项如何。 ( 需要 hit-ground )	字符串	Empty
spell-on-hit-entity 命中实体法术	投掷物命中目标时所触发的法术。必须是一个目标类法术以命中实体或地面，取决于上面的设置项如何。 ( 需要 hit-players 或 hit-non-players 或 can-target )	字符串	Empty
spell-on-duration-end 时效到尽法术	投掷物达到最大时效时所触发的法术。必须是一个可命中地面的目标类法术，取决于上面的设置项如何。 ( 需要 hit-air-after-duration )	字符串	Empty
spell-on-modifier-fail 条件未满足法术	投掷物的条件未满足时所触发的法术。必须是一个可命中地面的目标类法术，取决于上面的设置项如何。 ( 需要 projectile-modifiers )	字符串	Empty
spell-on-entity-location 实体位置法术	投掷物命中一个目标时所触发的法术(目标位置)。须是一个可命中地面的目标类法术。	字符串	Empty

举例 : proj_test :
spell-class : ".instant.ParticleProjectileSpell"
change-pitch : true
controllable : false
projectile-velocity : 10
tick-interval : 1
max-distance : 40
special-effect-interval : 1
stop-on-hit-entity : false
stop-on-hit-ground : true
relative-offset : 0,1,0
effects :
eff1 :
position : special
effect : particles
particle-name : REDSTONE
color : FFFF00
horiz-spread : 0.1
vert-spread : 0.1
size : 1
count : 25

PhaseSpell 穿墙法术
描述 : 目标类法术。可穿透方块。
设置项 :

设置项	描述	默认值
phasable-blocks 可穿透的方块	一个列表，用以衡量可以穿透的方块类型。如果这个设置为空或被忽略，所有方块都能穿透。	(empty)
max-distance 最大距离	施法者穿过固体物质并到空气的最大距离。它包括到墙的距离（范围）	15
range 范围	施法者与他们试图穿透的墙之间的最大距离。	5
str-cant-phase 不可穿透提示	释放失败发送一条信息。	Unable to find a place to phase to. 没能成功找到一个可以穿透的地方。

默认示例 : phase :
spell-class : ".instant.PhaseSpell"
name : phase
spell-icon : diamond
description : 穿透固体物质
cast-item : stick
cooldown : 10
range : 5
max-distance : 15
phasable-blocks : []
cost :
- mana 15
str-cost : 15 mana
str-cant-phase : 没能成功找到一个可以穿透的地方

Portal Spell 传送门法术
瞬发类法术。可以开启一个传送门，短时间内到达你标记的地点，可以多次使用或让其他玩家使用。

设置项	描述	默认值
mark-spell 标记法术	所使用的标记法术的真名	""
second-mark-spell 二次标记法术	二次标记法术的真名 , 如果为空，则会使用施法者当前位置	""
teleport-cost 传送消耗	传送一次的消耗物 ( 请填上消耗物列表 ).	empty
duration 时效	传送门的时效 ( 单位为t icks)	400
min-distance 最小距离	两个标记点之间最小距离	10
max-duration 最大距离	两个标记点之间最大距离	0
effect-interval 效果间隔	在传送门位置播放效果的间隔 ( 单位为t icks)	10
teleport-cooldown 传送冷却	两次传送间的冷却 ( 单位为秒 ).	5
vert-radius 垂直范围	传送门的垂直范围	1
horiz-radius 水平范围	传送门的水平范围	1
allow-return 允许返回	玩家是否可以返回到传送门?	true
teleport-other-players 传送其他玩家	其他玩家是否能够穿过传送门?	true
charge-cost-to-teleporter 对传送者收费消耗	是否传送其他玩家应该收取传送费?	false
str-no-mark 无标记点提示	当标记法术没有标记点时发送的提示消息。	"You have not marked a location to make a portal to." (你没有设置一个传送门可传送的位置)
str-too-far 过远提示	如果距离标记点过远的提示消息	"You are too far away from your marked location." (你离你的标记点太远力)
str-too-close 过近提示	如果距离标记点过近的提示消息	"You are too close to your marked location." (你离你的标记点太近啦)
str-teleport-cost-fail 传送消耗失败提示	如果你的传送消耗物不足,则发送此消息。	""
str-teleport-cooldown-fail 传送冷却未到提示	如果还在冷却中试图使用传送门则发送此消息。	""

举例 :
portal :
spell-class : ".instant.PortalSpell"
mark-spell : "mark"
duration : 400
teleport-cooldown : 1
min-distance : 10
max-distance : 0
allow-return : true
teleport-cost :
- mana 10
charge-cost-to-teleporter : false
effect-interval : 10
str-no-mark : "你没有设置一个传送门可传送的位置"
str-too-close : "你离你的标记点太近 "
str-too-far : "你离你的标记太远"
effects :
eff1 :
position : special
effect : effectlib
height-offset : 1
effectlib :
class : SphereEffect
particle : VILLAGER_HAPPY
color : ffffff
radius : 1
particles : 20
iterations : 1
period : 1
visibleRange : 150

Prayer Spell 暂无

Projectile Spell 投掷物法术
此法术可以发射一个正常的（实体）投掷物。

设置项	描述	默认值
projectile-type 投掷物类型	投掷物的类型。更多请见下文。	arrow
relative-offset 相对偏移量	相较于起始位置的偏移量	"0,1.5,0"
tick-interval 以tick计间隔	播放粒子效果且检测碰撞箱的间隔。单位是ticks。	1
spell-interval 法术间隔	在多个 spell-on-tick 法术释放之间的间隔。	20
special-effect-interval 特殊效果间隔	播放效果间的间隔。(单位为ticks)	0
rotation 旋转	以度为单位更改[前进冲刺]的方向 ( 左 : 90, 右 : -90, 后 : 180, 等等 )	0
velocity 速度	[size=10.5000pt]投掷物的速度	1
hit-radius 碰撞半径	[size=10.5000pt]投掷物的碰撞半径	2
vertical-hit-radius 垂直碰撞半径	[size=10.5000pt]抛掷物的垂直碰撞半径	2
vertical-spread 垂直扩散	实际上这里设置效果与投掷物垂直方向精确度成负相关。一个大的值将会导致投掷物更加不精准	0
horizontal-spread 水平扩散	实际上这里设置效果与投掷物水平方向精确度成负相关。一个大的值将会导致投掷物更加不精准	0
gravity 重力	是否应该把重力应用于投掷物 ?	true
charged 充能	如果投掷物是凋灵骷髅头,是否应该充能	false
stop-on-modifier-fail	若 projectile-modifiers 检测失败，是否让投掷物消失?	true
max-duration 最大时效	粒子消失前的最大存在时间。	10
spell 法术	投掷物命中时触发的默认法术。必须是一个目标类法术且可以命中实体或地面，取决于上面的设置。	""
spell-on-tick 中途法术	当投掷物飞行时释放的法术,必须是一个目标类法术且可以命中地面，取决于上面的设置。	""
spell-on-hit-ground 击中地面法术	当投掷物击中地面时释放法术。,必须是一个目标类法术且可以命中地面，取决于上面的设置。	""
spell-on-modifier-fail 条件未满足法术	投掷物的条件未满足时所触发的法术。必须是一个可命中地面的目标类法术，取决于上面的设置项如何。 ( 需要 projectile-modifiers )	""
spell-after-duration 时效后法术	当投掷物达到最大时效时触发一个法术。必须是一个可命中地面的目标类法术，取决于上面的设置项如何。	""
projectile-modifiers 投掷物条件	投掷物的条件 , 如果条件未满足，投掷物将会停止飞行。	null

投掷物类型
· Arrow 箭矢
· Dragonfireball 龙火球
· Egg 蛋
· Enderpearl 末影珍珠
· Fireball 火球
· Fishhook 鱼钩
· Largefireball 大火球
· Lingeringpotion 龙息
· Llamaspit 羊驼唾沫
· Shulkerbullet 潜影贝导弹
· Smallfireball 小火球
· Snowball 雪球
· Spectralarrow 光灵箭
· Splashpotion 喷射药水
· Thrownexpbottle 经验瓶
· Thrownpotion 丢出的药水
· Tippedarrow 药箭 [?]/ 坠落箭 [?]
· Trident 三叉戟
· Witherskull 凋灵骷髅头
举例 :
explosivearrow :
spell-class : ".instant.ProjectileSpell"
name : explosivearrow
spell-icon : arrow
description : 当箭着地时触发一次爆炸
cast-item : blaze_rod
cooldown : 30
projectile-type : arrow
velocity : 1
max-duration : 3
spell : explode
spell-on-hit-ground : explode
cost :
- mana 25
- gunpowder 1
- arrow 1
str-cost : 25 法力 ,1 火药和 1 箭矢
str-cast-self : 你发射一个爆炸箭

Purge Spell 肃清法术
瞬发类法术。可以击杀附近所有怪物和动物。

设置项	描述	默认值
radius 范围	法术有效范围	15
entities 生物	生物列表 ( 如果留空 , 则可对所有实体生效 )	null

举例 :
purge :
spell-class : ".instant.PurgeSpell"
name : purge
description : 击杀附近所有动物和怪物
cast-item : bone
cooldown : 60
radius : 8
can-target : monsters,animals
cost :
- mana 50
str-cost : 50 法力
str-cast-self : 你净化了周围的一切事物
str-cast-others : "%a 扫清了附近的一切生物 "

Recall Spell 回传法术
瞬发类法术。此法术可以让施法者回到他们用标价法术标记的位置。

设置项	描述	默认值
mark-spell 标记法术	标记法术的真名 ( 在法术配置中最顶头的关键词 )	mark
max-range 最大范围	可以把玩家从他的标记传送走的最大距离。0代表无限距离。	0
use-bed-location 使用床的位置	如果是 true, 施法者将会被传送到他们床的位置而不是标记法术所标记的位置。	false
allow-cross-world 允许跨世界	是否可以跨越不同世界。	true
str-no-mark 无标记提示	如果施法者没有标记则发送这条提示消息。	You have no mark to recall to. (你没有标记点来传送)
str-too-far 过远提示	如果 max-range 设置值比 0 大且玩家超出了那个范围则发送一个提示消息。	Your mark is too far away. (你的标记过远了)
str-other-world 跨界提示消息	如果 allow-cross-world 设置为 false 但是玩家尝试传送到不同世界	Your mark is in another world. (你的标记在其他世界)
str-recall-failed 回传失败提示	如果传送失败则法术提示信息 ( 通常发生在被其他插件阻止的情况 )	Could not recall. (你不能传送)

举例 :
recall :
spell-class : ".instant.RecallSpell"
name : recall
spell-icon : compass
description : 传送你到标记地点
cast-item : stick
cooldown : 300
mark-spell : mark
max-range : -1
allow-cross-world : true
use-bed-location : false
cost :
- mana 75
str-cost : 75 法力和 1 铁锭
str-cast-self : 你传送到了你的标记地点
str-no-mark : 你没有标记点来传送
str-other-world : 你不能传送到别的世界
str-too-far : 你标记的位置太远了
str-cast-others : "%a 不知怎的就消失了 !"

Repair Spell 修复法术
瞬发类法术。可以修复物品或护甲的耐久。

Option	描述	默认值
repair-amount 修复量	能够补充多少耐久	300
to-repair 可修复	要修复的物品栏槽位。详情请见举例
ignore-items 忽略物品	一个列表，列表内的物品将被忽略
allowed-items 允许物品	一个列表，列表内的物品将被修复
str-nothing-to-repair 无物可修提示	如果没东西修则发送此提示消息	Nothing to repair. (你没啥可修的)

举例 :
repair :
spell-class : ".instant.RepairSpell"
name : repair
description : 修理你的装备
cast-item : book
cooldown : 120
repair-amount : 300
to-repair :
- held
- hotbar
- inventory
- helmet
- chestplate
- leggings
- boots
ignore-items :
- flint_and_steel
- fishing_rod
cost :
- mana 50
- iron_ingot 2
str-cost : 50 法力和 2 铁锭
str-cast-self : 你修了你的装备 !

Ritual Spell 仪式法术 (群体技能)
瞬发类法术。仪式法术可以创建一个多人启动的法术。通常来说适用于威力大的法术 ( 群体技能 ) 。首先一个人施展仪式法术开启仪式，然后附近的随便哪个人可以右键第一个人来加入这个仪式。参与者动一下就会打断仪式。一旦仪式完成了并且有足够的参与者，法术就会被激活啦。此法术自己本身并不起作用，必须在完成后激发其他的法术。

设置项	描述	默认值
ritual-duration 仪式时效	一次仪式的时效，单位为服务器ticks。	200
tick-interval 以tick计间隔	以ticks为单位计量多久刷新一次仪式。此选项决定多久经验条更新一次以及多久检测一次玩家的移动状态。	5
effect-interval 效果间隔	以ticks为单位决定多久应用一次法术效果此选项必须是t ick-interval 设置值的倍数才能正常起效。	20
req-participants 所需人数	仪式成功所需的最小人数是多少?	3
set-cooldown-for-all 全局冷却	设置为 true, 所有参加仪式的按键都将拥有自己的冷却以适应此仪式。 all players who participate in the ritual will have their cooldown set for the ritual spell as well.	true
show-progress-on-exp-bar 经验条展示进度	是否借助经验条来显示仪式的进度?	true
set-cooldown-immediately 即时冷却	如果是 true, 此法术的冷却将会在仪式开始时就被计量。如果是 false, 直到仪式结束才会计算冷却并且必须是仪式成功才可以。	true
need-spell-to-participate 需要法术参与	参与者是否需要掌握法术才能参加仪式	false
charge-reagents-immediately 即时消耗	如果是 true, 在仪式一开始就会消耗施法者的消耗品。如果是 false, 则将会在仪式结束才收取消耗 , 并且必须是仪式成功的情况下。	true
spell 法术	当仪式结束后触发一个法术，请填写真名	( 无 )
str-ritual-left 离开仪式提示	当有人离开一个已经准备开始的仪式时发送提示消息。	( 空 )
str-ritual-joined 加入仪式提示	当有人加入一个已经准备开始的仪式时发送提示消息。	( 空 )
str-ritual-success 仪式成功提示	当仪式成功时发送一条提示消息。	( 空 )
str-ritual-interrupted 仪式破坏提示	当有人乱动导致仪式失败时发送一条提示消息。	( 空 )
str-ritual-failed 仪式失败提示	当仪式完成但是失败时发送一条提示消息 ( 参与者不够 )	( 空 )

举例 :
summon_helper :
spell-class : ".targeted.SummonSpell"
can-cast-with-item : false
can-cast-by-command : false
require-exact-name : false
require-acceptance : true
max-accept-delay : 90
accept-command : accept
str-usage : | 用法 : /cast 召唤 < 玩家名 >, 或输入 /cast summon 并且准星瞄准一个第一行写着玩家名的牌子
str-no-target : 目标玩家未找到
str-summon-pending : 你被召唤了 ! 输入 /accept 来传送
str-summon-accepted : 你已经被传送了
str-summon-expired : The summon has expired.
summon :
spell-class : ".instant.RitualSpell"
name : 召唤
spell-icon : portal
description : 召唤其他玩家来到你的位置，需要至少 3 人参与
cast-item : stick
cooldown : 300
ritual-duration : 200
req-participants : 3
charge-reagents-immediately : true
set-cooldown-immediately : true
set-cooldown-for-all : true
spell : summon_helper
tick-interval : 5
effect-interval : 20
cost :
- mana 75
- redstone 3
- iron_ingot 3
str-cost : 75 法力 ,3 红石粉和 3 铁锭
str-cast-self : 你开启了召唤仪式
str-cast-others : "%a 开启了召唤仪式，右键来加入吧 "
str-ritual-joined : 你上了召唤仪式的贼船
str-ritual-success : 召唤成功了 !
str-ritual-interrupted : 仪式被破坏了
str-ritual-failed : 召唤仪式已经失败

Roar Spell 嘲讽法术
瞬发类法术。强制附近的敌人来攻击你。

设置项	描述	默认值
radius 范围	此法术有效范围	8
str-no-target 无目标提示	当没有目标时给施法者发送此消息。	"No targets found." (未找到目标。)
cancel-if-no-targets 无目标取消	当没有目标时是否取消此法术?	true

举例 :
roar :
spell-class : ".instant.RoarSpell"
name : 嘲讽
description : 强制附近的敌人攻击你
cast-item : book
cooldown : 15
radius : 8
can-target : monsters
cost :
- mana 10
str-cost : 10 法力
str-cast-self : " 你放肆地大笑 , 附近的敌人都想群殴你。 "
str-cast-others : "%a 大声嘲讽着 !"

Steed Spell 骑乘法术
瞬发类法术。可召唤一个可骑乘的实体

设置项	描述	默认值
type 类型	实体类型	horse (马)
gravity 重力	此实体是否受到重力影响?	true
has-chest 有箱子	是否在生成实体时附带箱子	false
jump-strength 跳跃高度	马的跳跃高度	1
color 颜色	马的颜色	""
style 样式	马的样式	""
armor 盔甲	马的盔甲	""
str-already-mounted 已骑乘提示	当施法者已经骑乘某生物时还尝试施法时发送这么一条提示消息	"You are already mounted!" (你已经骑着什么了。)

举例 :
steed1 :
spell-class : ".instant.SteedSpell"
gravity : true
type : mule
color : black
style : none
has-chest : true
jump-strength : 0.3

Throw Block Spell 投掷方块法术
瞬发类法术 . 可以丢出一个设定好的方块 ( 默认是铁砧 ) Throws a block of the given type (anvil by default), 当落地时就会变成一个正常的方块。

设置项	描述	默认值
block-type 方块类型	投掷的方块类型	anvil
velocity 速度	投掷方块的速度	1.0
y-offset Y偏移	初始位置的Y方向偏移量	0
vertical-adjustment 垂直适应	调整方块的飞行高度	0.5
rotation-offset 旋转偏移	投掷方块的方向，以度为单位。0代表着正前方投掷 ,180 代表着反向投掷，以此类推	0
apply-spell-power-to-velocity 应用法术强度于速度	是否通过法术强度影响投掷的速度	false
gravity 重力	[size=10.5000pt]投掷的方块是否会受到重力影响	true
drop-item 掉落物品	如果物品不能正确着陆，是否掉落物品形式	false
remove-blocks 清除方块	设置为 true, 投掷的方块将会在着陆后不久被清除掉。	false
prevent-blocks 防止方块	完全阻止方块生成。 Completely prevents blocks from spawning.	false
call-target-event	当被坠落方块击中时是否将其算作法术的目标?	true
check-plugins 检查插件	是否试图提醒其他插件，法术造成的伤害实际上是施法者造成的?	false
ensure-spell-cast 确认法术	设置为 true, 插件将始终监听这个投掷出去的方块以确保法术确实结束了。开启后可能会对服务器性能有负面影响，如果不需要开启此功能，请关闭	true
sticky-blocks 粘性方块	设置为 true, 投掷的方块将会黏在墙上，而不是撞上墙后掉下去。	false
spell-on-land 着陆法术	当投掷方块坠地时触发法术	false

举例 :
anvil :
spell-class : ".instant.ThrowBlockSpell"
name : anvil
cooldown : 10
cast-item : blaze_rod
description : 丢出去一个铁砧
block-type : anvil
velocity : 1.0
rotation-offset : 0
vertical-adjustment : 0.5
drop-item : false
remove-blocks : false
call-target-event : true
cost :
- mana 25
- anvil 1
str-cost : 25 法力和 1 铁砧

T imeSpell 时间法术
描述 : 瞬发类法术 . 此法术将改变施法者所在世界的时间 (low 到爆 )
法术强度对此法术无效
设置项 :

设置项	描述	默认值
time-to-set 设置时间	设置的时间。取值范围为 0 到 24000 。一些参考近似值 : 0 是黎明 , 6000 是正午 , 12000 是黄昏 , 18000 是午夜	0
str-announce 通告	当时间改变后将会发送一条当前世界所有玩家都能看见的提示消息	The sun suddenly appears in the sky. (太阳公公突然出现在了天上)

Spell Default: Dawn :
spell-class : ".instant.TimeSpell"
name : 黎明
cast-item : blaze_rod
str-announce : 太阳终将升起 !
time-to-set : 22550
cooldown : 200

UnconjureSpell 消失法术
限定名 : com.nisovin.magicspells.spells.instant.UnconjureSpell
父系 : InstantSpell
功效 : 从施法者的物品栏里面移除指定物品，包括在身上的物品 [?? 我查了英文 wiki 也不知道 hovered 什么意思
Removes specified items from caster's inventory including the hovered item.
可配置内容 :

设置项	描述
items 物品	此列表的物品将会被没收。大于1个物品可以通过“物品类型+空格+数量 ” 的形式收取

举例 : unconjure :
spell-class : ".instant.UnconjureSpell"
items :
- paper 64

VariableCastSpell 变量法术
限定名 : com.nisovin.magicspells.spells.instant.VariableCastSpell
父系 : InstantSpell
功效 : 释放一个储存变量名的法术 [??]
Casts a spell saved to the variable's name.
可配置内容 :

Option	描述	默认值
variable-name 变量名	变量的名字	null
str-doesnt-contain-spell 未包含法术提示	当变量名未包含一个有效的法术时发送此提示消息给施法者	"You do not have a valid spell in memory" (你没有写上一个合适的法术)

举例 : variablecast :
spell-class : ".instant.VariableCastSpell"
variable-name : spell_variable
str-doesnt-contain-spell : " 你没有写上一个合适的法术 "

Velocity Spell 速度法术
描述 : 瞬发类法术。可以设置你所视方向的速度，法术强度影响此法术效果
可配置内容 :

Option	描述	Variable Type	默认值
speed 速度	设定的速度	单精度浮点数	40
cancel-damage 取消伤害	速度变化是否应取消导致坠落伤害	布尔值	true
add-velocity-instead 使用加速	是否增加速度而非设定速度?	布尔值	false

举例 : velocity :
spell-class : ".instant.VelocitySpell"
speed : 40
cancel-damage : false

Wall Spell 墙壁法术
可以创建一堵墙的法术

设置项	描述	默认值
wall-types 墙的类型	组成墙壁的方块类型	null
str-no-target 无目标提示	当无法创建墙时的提示消息	Unable to create a wall. (不能创建墙)
spell-on-break 破墙法术	墙破坏时在其位置触发一个法术，需要填写真名。	""
y-offset Y偏移	起始位置Y方向偏移	-1
distance 距离	墙的距离	3
wall-width 墙的宽度	墙的宽度	5
wall-depth 墙的厚度	墙的厚度	1
wall-height 墙的高度	墙的高度	3
wall-duration 墙的时效	墙可以存在多久	15
range 范围	[size=10.5000pt]墙应该放置在离你[size=10.5000pt]施法[size=10.5000pt]的地方多远	3
check-plugins 检查插件	是否检测有关世界的插件?	true
prevent-drops 防止掉落	是否防止方块从墙上掉落?	true
always-on-ground 总是在地上	墙是否必须在地上?	false
prevent-breaking 防止破坏	墙能否被破坏?	false
check-plugins-per-block 检测插件每个方块	是否检测有关世界的插件?	true

举例 :
wall :
spell-class : ".instant.WallSpell"
name : wall
description : 创建一堵墙来短暂阻挡你的敌人
cast-item : stick
cooldown : 15
range : 3
wall-width : 5
wall-height : 3
wall-types :
- stone
- cobblestone
wall-duration : 100
cost :
- mana 12
- stone 2
str-cost : 12 法力和 2 石头
str-no-target : 不能创建墙

Wither Skull Spell 凋灵骷髅头法术
投掷物法术。可以发射一个凋灵骷髅头在你面向的位置。

设置项	描述	默认值
charged 充能	凋灵骷髅头充能状态	false
velocity 速度	投掷物飞得有多快?	2.0

举例 :
witherskull :
spell-class : ".instant.WitherSkullSpell"
charged : false
velocity : 2.0

2020-12-26 05:45:36

炫宙菌

本帖最后由炫宙菌于 2020-12-26 14:12 编辑

Buff Spells

BUFF类法术

Buff Spell BUFF法术通用设置
Buff Spell 配置 :

设置项	描述	变量类型	默认值
can-cast-with-item 可手持物品	此法术可否手持物品触发	布尔值	true
can-cast-by-command 可命令触发	此法术可否用 /cast ( 法术名 ) 指令触发	布尔值	true
targeted 目标类	此法术是否作为一个目标类法术 ( 将会遵循目标类法术设置 ) 。对于对于低于M S 4.0 的版本，此设置项将不会对玩家以外的目标实体起效	布尔值	false
toggle 切换	此法术是否可以在处于激活状态下被停止。只会在持续时间内计算冷却。	布尔值	true
use-cost 使用消耗	开启BUFF所需消耗品的列表（字符串形式）。消耗将会在下面的interval设置里被计量。此列表可包括 : health 生命 , mana 魔力 , hunger 饥饿 , experience 经验 , levels 等级 , durability 耐久 , money 金钱 ( 若 Vault 插件有的话) , 或 Item Type 物品种类。所有此列表的物品都可用空格来设置数量(mana 1)，而物品可以不设置数量则默认为1	字符串列表	null
use-cost-interval 使用消耗间隔	以ticks为单位指定 use-cost 设置项的消耗间隔 .	整型数	0
num-uses 使用次数	BUFF法术销毁前的触发次数	整型数	0
duration 时效	以秒为单位指定BUFF法术的时效。0表示无限	单精度浮点数	0
power-affects-duration 强度影响时效	法术强度是否可以影响时效	布尔值	true
cancel-on-give-damage 造成伤害则撤销	如果施法者对其他实体造成了伤害则取消此法术	布尔值	false
cancel-on-take-damage 受到伤害则撤销	如果施法者被其他实体造成了伤害则取消此法术	布尔值	false
cancel-on-death 死亡则撤销	如果施法者狗带了则取消此法术	布尔值	false
cancel-on-teleport 传送则撤销	如果服务器为施法者发送传送事件则取消此法术	布尔值	false
cancel-on-change-world 切换世界则撤销	如果施法者切换世界则取消此法术	布尔值	false
cancel-on-spell-cast 施法则撤销	如果施法者释放一个法术则取消此法术	布尔值	false
cancel-on-logout 登出则撤销	如果施法者离开游戏则取消此法术	布尔值	false
spell-on-use-increment 额外则触发法术	当此法术已被使用时触发的另一个法术。如果num-uses设置为0，这一法术将会被立刻触发	字符串	null
spell-on-cost 消耗则触发	当BUFF法术尝试消耗时触发此法术	字符串	null

[size=10.5000pt]

ExternalDisguiseSpell 外部伪装法术
Disguise Spell 伪装法术
BUFF类法术。 此法术允许使用者伪装成一个实体 LibsDisguises 插件需要作为前置 !

设置项	描述	默认值
player-name 玩家名	如果伪装的实体是玩家，那么玩家名是什么?	""
skin-name 皮肤名	如果伪装的实体是玩家，那么皮肤名是什么?	player-name
data 数据	应用于伪装的数据 data used for disguises	0
burning 燃烧	是否让伪装实体燃烧	false
glowing 发光	是否让伪装实体发光	false
disguise 伪装	实体数据设置部分，更多请见 EntityData	-

举例：
Disguise:
spell-class: ".buff.ext.DisguiseSpell"
name: "Disguise"
toggle: true
disguise:
entity: tropical_fish
type: clayfish
color: red
pattern-color: blue
[size=10.5000pt]

Armor Spell 盔甲法术
BUFF 类法术。 可以给施法者施加护甲

设置项	描述	默认值
permanent 永久性	盔甲是永久的亦或是暂时的。如果永久的,则可以取下；如果是暂时的，在时效内不可用取下	false
replace 替换	是否让召唤的盔甲替换任何已有的盔甲。如果此项不启用，且已经装备了任一护甲，此法术将无法施放	false
helmet 头盔	召唤给玩家的头盔。支持魔法物品类型或单纯的字符串魔法物品 .	""
chestplate 胸甲	召唤给玩家的胸甲。	""
leggings 护腿	召唤给玩家的护腿。	""
boots 靴子	召唤给玩家的靴子。	""
str-has-armor 已有盔甲提示	字符串消息。若施法者已经有盔甲且replace设置成false	"You cannot cast this spell if you are wearing armor." ( “ 你不能在已经装备盔甲时再使用此法术 ” )

举例：
BloodyArmor:
spell-class: ".buff.ArmorSpell"
toggle: false
replace: true
permanent: false
duration: 30
helmet: leather_helmet{name:"&4Bloody Helmet", color:FF0000, enchants:{ blast_protection:2 }}
chestplate: leather_chestplate{name:"&4Bloody Chestplate", color:FF0000, enchants:{ blast_protection:2 }}
leggings: leather_leggings{name:"&4Bloody Leggings", color:FF0000, enchants:{ blast_protection:2 }}
boots: leather_boots{name:"&4Bloody Boots", color:FF0000, enchants:{ blast_protection:2 }}
[size=10.5000pt]

Carpet Spell 地毯法术
在你的目标位置生成一个地毯。

设置项:	描述:	默认值
block 方块	平台由啥构成	white_carpet
radius 范围	平台的范围 ( 以方块格数为单位 )	1
duration 时效	平台的时效 ( 以ticks为单位 ).	0
touch-check-interval 接触间隔检测	多久检测一个玩家接触地毯的情况 ? ( 以ticks为单位 )	3
circle 圆圈	地毯是否应该弄成圆圈型	false
remove-on-touch 接触时移除	如果有人接触了地毯是否移除它	true
spell-on-touch 移除时发送	当有人接触地毯时触发一个法术（真名）	""

举例 :
carpet:
spell-class: ".targeted.CarpetSpell"
range: 100
block: white_carpet
radius: 2
duration: 200
touch-check-interval: 20
remove-on-touch: true
circle: true
[size=10.5000pt]

Clarity Spell 醒脑法术
BUFF 类法术。 此法术可修改其他法术的消耗。 ( 实际上它对自身也有效 ) 比如用完之后其他法术的冷却全部减少 30% 这样的。

设置项	描述	默认值
multiplier 倍率	法术的消耗将会乘上此值。如果你需要降低法术消耗请设置为低于1的数。(1相当于100%)	0.5
spells 法术	会被此法术影响的法术列表。如果为空则会影响所有法术。	null
denied-spells 禁止法术	不会被影响的法术列表	null
spell-tags 法术标签	拥有这里的标签的法术将会被影响。查阅更多信息，请点击全局设置页	null
denied-spell-tags 禁止法术标签	拥有这里的标签的法术将不会被影响。查阅更多信息，请点击全局设置页	null

举例：
Clarity:
spell-class: ".buff.ClaritySpell"
multiplier: 0.5
duration: 60
[size=10.5000pt]

Damage Empower Spell 伤害控制法术
BUFF 类法术。 可修改其他法术的伤害 ( 实际上它对自身也有效 ) 。

设置项	描述	默认值
damage-multiplier 伤害倍率	法术的伤害将会乘上此值。如果你需要降低法术伤害请设置为低于1的数。(1相当于100%)	1.5
spells 法术	会被此法术影响的法术列表。如果为空则会影响所有法术。	null
denied-spells	不会被影响的法术列表	null
spell-tags	拥有这里的标签的法术将会被影响。查阅更多信息，请点击 the general configuration page	null
denied-spell-tags	拥有这里的标签的法术将不会被影响。查阅更多信息，请点击 the general configuration page	null

举例：
Damage-Empower:
spell-class: ".buff.DamageEmpowerSpell"
damage-multiplier: 1.5
duration: 60
[size=10.5000pt]

Dodge Spell 闪避法术
BUFF类法术。 此法术可以让你闪避 ParticleProjectileSpells 粒子投掷物法术

设置项	描述	默认值
distance 距离	距投掷物有此距离外的玩家将会被传送	2
spell-before-dodge 闪避前法术	闪避前在施法者位置释放一个法术	""
spell-after-dodge 闪避后法术	闪避后在施法者位置释放一个法术	""
spells 法术	会被此法术影响的法术列表。如果为空则会影响所有法术。	null
denied-spells 禁止法术	不会被影响的法术列表	null
spell-tags 法术标签	拥有这里的标签的法术将会被影响。查阅更多信息，请 the general configuration page	null
denied-spell-tags 禁止法术标签	拥有这里的标签的法术将不会被影响。查阅更多信息， the general configuration page	null

举例：
dodge:
spell-class: ".buff.DodgeSpell"
toggle: true
duration: 20
distance: 2
spells:
- particleProjectileSpellName

Empower Spell 调控法术 ( 增幅 )
BUFF 类法术。 以设置的倍率增加法术强度。

设置项	描述	默认值
power-multiplier 强度乘数	法术强度的增幅。1表示保持不变	1.5
max-power-multiplier 最大乘数	你最多可以增幅到多少。此选项对于堆叠增幅伤害的小伎俩极为有效。个人觉得你也不会希望玩家通过此法术堆叠技能伤害到1W倍再释放出来	1.5
spells 法术	可增幅的法术列表。如果留空则用于全部法术	null
denied-spells 禁止法术	此列表的法术将会被排除在外	null
spell-tags	拥有这里的标签的法术将会被影响。查阅更多信息，请请点击 the general configuration page	null
denied-spell-tags 禁止法术标签	拥有这里的标签的法术将不会被影响。查阅更多信息，请点击 the general configuration page	null

举例：
Empower:
spell-class: ".buff.EmpowerSpell"
power-multiplier: 2.0
max-power-multiplier: 4.0
duration: 10
str-cast-self: "You feel empowered."
str-cast-others: "%a powers up!"

Flamewalk 火弧步
BUFF 类法术。 点着附近的目标。

设置项	描述	默认值
radius 范围	点着的有效区域	8
fire-ticks 火焰刻	火焰将持续多久，单位为ticks	80
tick-interval 以tick计间隔	多久再次点着新火焰	100

举例：
Flamewalk:
spell-class: ".buff.FlamewalkSpell"
radius: 8
fire-ticks: 80
tick-interval: 100

Frostwalk spell 冰霜步
BUFF 类法术， 让施法者脚下水源方块变成冰类似于冰霜行者附魔，不过可以自定义范围。

设置项	描述	默认值
size 尺寸	冻结的圆圈尺寸	2
leave-frozen 留下冻结	是否让冻结的冰永久存在	false

举例：
Frostwalker:
spell-class: ".buff.FrostwalkSpell"
size: 2
leave-frozen: true
duration: 5

Gills Spell 鳃法术
BUFF 类法术。允许施法者水下呼吸

设置项	描述	默认值
head-effect 头部效果	是否让玩家头上套着一个方块	true
head-block 头部方块	头部方块的材质名	glass
refill-air-bar 填充空气槽	是否让玩家的空气槽被补充?	true

举例：
gills:
spell-class: ".buff.GillsSpell"
name: gills
description: 让你在水下逍遥自在
cast-item: book
head-effect: true
cooldown: 60
duration: 300
num-uses: 5
cost:
- mana 50
- sugar_cane 1
use-cost:
- sugar_cane 1
use-cost-interval: 1
str-cost: 50 法力和一甘蔗，几秒钟就多消耗一个甘蔗
str-cast-self: 你感觉你脖子上长了个鳃
str-fade: 你的鳃消失了

Haste Spell 急迫法术
BUFF 类法术。 显著增加施法者冲刺 ( 疾跑 ) 速度

设置项	描述	默认值
effect-strength 效果强度	速度会有多快	3
boost-duration 强化时效	效果消退前可以最多增效多久(单位为ticks) , 此设置在玩家仍处于疾跑状态时有效	300
acceleration-amount 加速度	加速度	0
acceleration-delay 加速度延迟	首次加速前的间隔时间	0
acceleration-increase 加速度增量	每次加速的增量	0
acceleration-interval 加速度间隔	每次加速的时间差	0
hidden 隐藏	切换粒子效果可见性	false

举例：
haste:
spell-class: ".buff.HasteSpell"
effect-strength: 3
boost-duration: 300
duration: 60
cost:
- 331 3
str-cost: 3 红石粉
str-cast-self: 你发疯似的跑起来了 !
str-cast-others: "%a 跑得非同寻常得快 !"
str-fade: 你又不能跑那么快了

Impact Record Spell ???

设置项	描述	默认值
variable-name 变量名	变量名	""
spells 法术名	Spell list (filter)	null
record-cancelled	Whether the record should be cancelled	false

Invisibility Spell 隐匿法术
BUFF 类法术。 让你在所有玩家和怪物面前完全隐身

设置项	描述	默认值
prevent-pickups 防止拾取	防止施法者隐身期间拾取任何物品	true
mob-radius 生物范围	任何生物在此半径内设置以你为目标，那么它的目标将被重置为无目标	true

举例：
Vanish:
spell-class: ".buff.InvisibilitySpell"
permission-name: assassin
cooldown: 12
cost:
- mana 25
use-cost:
- mana 5
use-cost-interval: 1
str-cost: 25 法力 , 每秒多耗 5 法力
toggle: true
prevent-pickups: true
cancel-on-give-damage: true
cancel-on-take-damage: true
cancel-on-logout: true
cancel-on-spell-cast: true
str-cast-self: " 你隐身了 !"
str-cast-others: "%a 隐身了 !"
str-fade: "&7 你又能被看见了 "

Invulnerability Spell 霸体法术
BUFF 类法术。 让你对于一些指定的伤害类型无敌

设置项	描述
damage-causes 伤害类型	让施法者不受伤害的类型列表。留空则会让所有伤害都无效化。
spell-damage-types 法术伤害类型	自定义的法术伤害类型，此列表内的法术伤害对施法者无效

举例：
EnvironmentInvuln:
spell-class: ".buff.InvulnerabilitySpell"
description: 使你不受环境伤害
toggle: false
damage-causes:
- block explosion
- contact
- drowning
- fall
- fire
- lava
- lightning
- suffocation
duration: 60
cooldown: 300
cost:
- mana 30
use-cost:
- mana 15
use-cost-interval: 5
str-cost: 30 法力，每次吸收伤害多耗 15 法力
TotalInvuln:
spell-class: ".buff.InvulnerabilitySpell"
description: 让你完全霸体
toggle: false
duration: 5
cooldown: 20
cost:
- mana 80
str-cost: 80 法力

Lifewalk Spell 生花步
BUFF 类法术。 让你走过 的地方长出鲜花和灌木

设置项	描述	默认值
tick-interval 以tick计价格	以ticks为单位计量此法术多久更新施法者的位置，从而继续尝试生成更多的鲜花和灌木	15
blocks 方块	概率生成的材质列表	null

举例：
lifewalk:
spell-class: ".buff.LifewalkSpell"
name: 生花步
description: 鲜花盛开在你的脚下 !
cast-item: book
tick-interval: 15
blocks:
- dandelion 25
- poppy 50
cost:
- mana 25
- poppy 1
- dandelion 1
use-cost:
- dandelion 1
use-cost-interval: 25
str-cost: 25 法力 , 1 罂粟 , 1 蒲公英 , 每过一段时间再消耗 1 蒲公英
str-cast-self: 鲜花盛开在你的脚下 !
str-cast-others: 鲜花盛开在 %a 的脚下 !!
str-fade: 你脚下不会生成鲜花了

Lightwalk Spell 幻灯步法术
BUFF 类法术。让你走过的路径发光。

设置项	描述	默认值
material 材质	发光方块的材质	glowstone
allowed-types	允许替换成幻灯步发光方块的方块	null

举例：
lightwalk:
spell-class: ".buff.LightwalkSpell"
name: lightwalk
cast-item: golden_boots
description: 让你走过的路发光
material: glowstone
allowed-types:
- grass_block
cost:
- mana 25
- torch 3
use-cost:
- torch 1
use-cost-interval: 25
str-cost: 25 法力和 3 火把 , 每隔一段时间消耗 1 火把
str-cast-self: 你让光芒常伴你的脚边 .
str-fade: 你脚边的光亮熄灭了

Lilywalk Spell 荷叶步法术
BUFF 类法术。此法术可以让你踏着脚下不断生成的睡莲在水上走。法术强度不影响此法术效果。此 buff法术无特殊设置
举例：
lilywalk:
spell-class: ".buff.LilywalkSpell"
name: 荷叶步
spell-icon: lily_pad
description: 让你走过的水面铺满荷叶
cast-item: book
cooldown: 30
cost:
- mana 40
- lily_pad 1
use-cost:
- lily_pad 1
use-cost-interval: 25
str-cost: 40 法力和 1 睡莲 , 每 50 方块增加 1 睡莲
str-cast-self: 你可以在水上走
str-cast-others: "%a 现在可以在水上走 !"
str-fade: 你不能在水上走了

Mana Regen Spell 法力恢复法术
BUFF 类法术。 可以增加你的法力恢复速率

设置项	描述	默认值
regen-mod-amt 回复量	每一法术恢复刻恢复的额外法力值	3

举例：
ManaRegen:
spell-class: ".buff.ManaRegenSpell"
description: 增加一段时间的法力回复量
cooldown: 300
duration: 60
regen-mod-amt: 3
str-cast-self: 你的思绪前所未有地清晰
str-fade: 你的思想又恢复成原来的样子

Minion Spell 仆从法术
BUFF 类法术。 生成一个绑定施法者的仆从

设置项	描述	默认值
mob-chances 怪物概率	可能生成的生物类型列表。可以附带百分比概率，详见下文。	null
potion-effects 药水效果	应用于生成仆从的药水效果。	null
attributes 属性	应用于生成仆从的属性。详见下文举例格式。	null
main-hand 主手	仆从主手的物品	""
off-hand	仆从副手的物品	""
helmet 头盔	仆从头盔展示的物品	""
chestplate 胸甲	仆从胸甲展示的物品	""
leggings 护腿	仆从护腿展示的物品	""
boots 靴子	仆从靴子展示的物品	""
minion-targets 仆从目标	仆从可以寻找的目标列表。和can-target设置项类似。	null
main-hand-drop-chance 主手掉落概率	仆从主手物品掉落概率(下面几个完全类似不翻译了)	0
off-hand-drop-chance 副手掉落概率	The chance to drop the item in the off hand.	0
helmet-drop-chance 头盔掉落概率	The chance to drop the helmet.	0
chestplate-drop-chance 胸甲掉落概率	The chance to drop the chestplate.	0
leggings-drop-chance 护腿掉落概率	The chance to drop the leggings.	0
boots-drop-chance 靴子掉落概率	The chance to drop the minion's boots.	0
spell-on-spawn 生成时触发法术	当仆从生成时触发法术。此功能的实现用代码来解释，是施法者在仆从的位置处施法而实现的。这就说明了仆从本身不是施法者。此法术必须能够锁定目标位置或是怪物本身。	""
spell-on-attack 攻击时法术	当仆从攻击时触发的法术此功能的实现用代码来解释，是施法者在仆从的位置处施法而实现的。此法术必须能够锁定目标位置或是怪物本身。	""
spell-on-death	当仆从死亡时触发的法术此功能的实现用代码来解释，是施法者在仆从的位置处施法而实现的。此法术必须能够锁定目标位置或是怪物本身。	""
spawn-offset 生成偏移	应用于生成仆从的位置偏移	1,0,0
follow-range 跟随范围	仆从尽量跟随施法者的距离	1.5
follow-speed 跟随速度	仆从达到最大距离时跑向施法者的速度。 .	1
max-distance 最大距离	仆从距施法者的最大距离。	30
power-affects-health 强度影响生命值	法术强度是否可以影响到生命值	false
power-health-factor 强度	法术强度改变怪物生命值的倍率 factor	1
max-health 最大生命	仆从最大拥有的生命值	20
health 生命	仆从生成时拥有的生命值	20
minion-name 仆从名字	仆从名字。如果指定了，此名字将会始终显示在怪物头顶	""
gravity 重力	仆从是否受到重力影响	true
baby 幼体	生成时是否生成幼体怪物?	false
prevent-sun-burn 防止太阳烧伤	是否防止仆从被太阳灼伤?	true

举例：
HellKnight:
spell-class: ".buff.MinionSpell"
permission-name: necromancer
duration: 60
mob-chances:
- Wither_Skeleton 100
minion-name: "&a%c 召唤的 &c 地狱骑士 "
prevent-sun-burn: true
follow-range: 25
follow-speed: 1
spell-on-spawn: MinionSpawnEffect
max-health: 40
health: 40
max-distance: 25
main-hand: stone_axe
off-hand: shield
helmet: diamond_helmet#000000;durability--100|&0Sacrificial__Helmet
chestplate: diamond_chestplate#000000;durability--100|&0Sacrificial__Plate
leggings: diamond_leggings#000000;durability--100|&0Sacrificial__Leggings
boots: diamond_boots#000000;durability--100|&0Sacrificial__Boots
toggle: false
minion-targets:
- players
- nonplayers
attributes:
- "knockback_resistance 5 addnumber"
- "armor 4 addnumber"
potion-effects:
- 2 1200 1
MinionSpawnEffect:
spell-class: ".targeted.DummySpell"
helper-spell: true
permission-name: necromancer
effects:
1:
position: target
effect: effectlib
effectlib:
class: AnimatedBallEffect
particle: EXPLOSION_LARGE
particles: 10
particlesPerIteration: 10
size: 1
yOffset: 1
xFactor: 1
yFactor: 1.25
zFactor: 1
period: 0
iterations: 1
visibleRange: 100
2:
position: target
effect: lightning

Reach Spell 伸展法术
BUFF 类法术。 此法术可以让你远程放置或破坏方块，持续一段时间

设置项	描述	默认值
range 距离	以方块为单位计量施法者可以放置或破坏的距离	15
consume-blocks 消耗方块	是否在放置时消耗玩家物品栏的方块	true
drop-blocks 掉落方块	是否让破坏的方块作为物品掉落	true
disallowed-break-blocks 不允许破坏的方块	不允许被此法术破坏的方块列表。	null
disallowed-place-blocks 不允许放置的方块	不允许被此法术放置的方块列表。	null

举例：
reach:
spell-class: ".buff.ReachSpell"
name: reach
spell-icon: dispenser
description: 远距离放置或摧毁方块
cast-item: stick
cooldown: 120
duration: 60
range: 15
consume-blocks: true
drop-blocks: true
disallowed-break-blocks:
- air
- bedrock
disallowed-place-blocks:
- air
- bedrock
cost:
- mana 50
str-cost: 50 法力
str-cast-self: 你获得了操纵世界的能力
str-fade: 你没法再对周围的世界胡作非为了

Reflect Spell 反弹法术
BUFF 类法术。此法术可以让施法者反弹其他法术

设置项	描述	默认值
shield-breakers 破盾者(无效法术)	此列表的法术将被此法术忽略	null
delayed-reflection-spells (延迟)反弹法术	List of spells	null
reflected-spell-power-multiplier 反弹法术强度倍率	反弹的法术将会被加强此值的法术强度	1
spell-power-affects-reflected-power 法术强度影响反弹强度	r 法术强度是否可以影响到反弹的强度	false
delayed-reflection-spells-use-payload-shield-breaker (延迟)反弹法术是否计量破盾者法术的次数[推测]	(原wiki什么也没写)	true

举例：
reflect:
spell-class: ".buff.ReflectSpell"
name: reflect
spell-icon: glass_pane
description: 反弹他人对你释放的法术
cooldown: 30
num-uses: 3
cost:
- mana 30
use-cost:
- mana 20
use-cost-interval: 1
str-cost: 30 法力 , 每次反弹增加 20 法力消耗
str-cast-self: 你觉得你周围包裹着魔法屏障
str-cast-others: 魔法屏障包裹着 %a.
str-fade: 你的魔法屏障消退了

Resist Spell 抵抗法术
BUFF 类法术。 减少特定 伤害 来源造成的伤害

设置项	描述	默认值
spell-damage-types 法术伤害类型	减免的伤害种类列表,专门应对于法术伤害	null
normal-damage-types 通常伤害类型	总体内减少的伤害类型的类型列表。请点击这里查看伤害类型列表	null
multiplier 倍率	减免的伤害倍率。允许小数值，填写比1小的数可以减少伤害，如0.5就是减免一半伤害	0.5

举例：
Pavise:
spell-class: ".buff.ResistSpell"
duration: 6
toggle: false
str-cast-self: "** 格挡 **"
str-fade: "&7** 格挡失效 **"
normal-damage-types:
- ENTITY_ATTACK
multiplier: 0.5

See Health Spell 看穿生命法术
BUFF 类法术。 此法术可以让你看见目标的血条

设置项	描述	默认值
bar-size 血条尺寸	血条尺寸	20
update-interval 更新间隔	血条更新间隔，单位为ticks	5
symbol 样式	创建血条的样式	"="

举例：
SeeHealth:
spell-class: ".buff.SeeHealthSpell"
cooldown: 300
duration: 60
symbol: "="
bar-size: 20
update-interval: 5
str-fade: 你看不见血条了

Spell Haste Spell 法术急迫法术
BUFF 类法术 改变冷却时间和施法时间 , 让你施法更快 。

设置项	描述	默认值
cast-time-mod-amt 减少的施法时间	更改的施法时间数，作为百分比使用(无须百分号)。负值则会减少施法时间，正值则增加	-25
cooldown-mod-amt 冷却减免时间	更改的冷却值，作为百分比使用(无须百分号)。负值则会减少冷却时间，正值则增加	-25
spells 法术	应用此效果的法术列表。	null
denied-spells 禁止法术	不应用此效果的法术列表。	null
spell-tags 法术标签	拥有这里的标签的法术将会被影响。查阅更多信息，请点击 the general configuration page .	null
denied-spell-tags 禁止法术标签	拥有这里的标签的法术将不会被影响。查阅更多信息，请点击 the general configuration page .	null

举例：
SpellHaste:
spell-class: ".buff.SpellHasteSpell"
cooldown: 60
duration: 15
cast-time-mod-amt: -50
cooldown-mod-amt: -50
cost:
- 331 3
str-cost: 3 红石粉
str-cast-self: 你大脑运转速度加快 , 可以快速施法了
str-fade: 你的思绪又**了下来

Stealth Spell 隐遁法术
BUFF 类法术。 此法术让你不能被生物指定为目标 。此法术无特殊设置项。
举例：
stealth:
spell-class: ".buff.StealthSpell"
name: 隐遁
description: 怪物装作看不见你的样子
cast-item: bone
cooldown: 60
duration: 20
cost:
- mana 15
str-cost: 15 法力
str-cast-self: 你在怪物目前变得不可见
str-fade: 怪物对你的认知阻碍消除了

Stonevision Spell 石头幻觉法术
BUFF 类法术。 把附近的方块转换成其它任意方块。此效果只是对于客户端而言的， 服务器中这些方块该是什么样还是什么样 ( 大概 ) 。坏黑说这叫“发包”

设置项	描述	默认值
radius 范围	此范围内的方块将会被转换为新方块	4
unobfuscate 混淆	如果你正在启用一个混淆矿物插件(反矿透)，且如果你想让玩家在使用此法术时看到真正的矿石则需要把此项设置为true。如果你没有用那类插件，最好设置为false以节约系统资源消耗。	false
transparent-types 幻觉方块类型	转换成新方块列表	null
material 材质	于 transparent-types 展示的方块材质	barrier

举例：此技能可以把石头当成屏障来看 , 这样你就可以让玩家透视挖矿了 ( 生存模式看不见屏障的渲染 )
stonevision:
spell-class: ".buff.StonevisionSpell"
name: 透视
spell-icon: stone
description: 看穿石头
cast-item: book
range: 4
transparent-types:
- stone
unobfuscate: false
material: barrier
cooldown: 60
duration: 30
cost:
- mana 50
- stone 2
- glass 2
str-cost: 50 法力和 2 石头以及 2 玻璃
str-cast-self: 你看穿了石头
str-fade: 你不能再看穿石头了

Walkway spell 步行路法术
创造一个魔力般的方块道路伴随着你。此法术可能会有点小问题，请使用 Windwalk 法术代替。

设置项	描述	默认值
platform-type 平台样式	平台的组成方块	oak_wood
size 尺寸	平台有多大	6

举例：
walkway:
spell-class: ".buff.WalkwaySpell"
name: 天桥
description: 生成一个移动着的魔法天桥
cast-item: book
cooldown: 60
platform-type: oak_wood
size: 6
cancel-on-logout: true
cancel-on-teleport: true
cost:
- mana 50
- oak_wood 1
use-cost:
- mana 15
- oak_wood 1
use-cost-interval: 15
str-cost: 50 法力 , 每 15 格增加 15 法力和 1 橡木板
str-cast-self: 你生成了一个天桥
str-fade: 你的魔法桥没了

Waterwalk Spell 水上漂法术
BUFF 类法术。 此法术可以让目标在水上悬浮 。实际上 此技能开启 玩家飞行 状态 ，但是阻止 玩家在 水面上 飞， 一旦检测到 在陆地上移动 此技能 会失效

设置项	描述	默认值
speed 速度	玩家在水上走的速度	0.05

举例：
Waterwalk:
spell-class: ".buff.WaterwalkSpell"
speed: 0.05
duration: 60
cancel-on-logout: true
cost:
- mana 25
- boat 1
use-cost:
- water_lily 1
use-cost-interval: 50
str-cost: 25 法力和 1 个船 , 每 50 格方块增加 1 个睡莲
str-cast-self: 你可以在水上行走了 !
str-fade: 你不能在水上行走了 .

WindGlide Spell 迎风飞翔法术
鞘翅般的飞行 , 但是鞘翅是隐形的

设置项	描述	默认值
spell 法术	[size=10.5000pt]要被释放的法术	null
collision-spell 碰撞法术	当施法者撞到一个方块时触发的法术	null
block-collision-dmg 碰撞方块减免	碰撞方块的伤害是否禁用?	true
cancel-on-collision 碰撞则撤销	是否在撞到方块时撤销此法术	false
velocity 速度	玩家飞多快	20.0
height 高度	玩家是下降还是抬升?	0.0
interval	How many ticks until the spell and velocity is executed	4

举例：
Windglide:
spell-class: ".buff.WindglideSpell"
duration: 20
block-collision-dmg: true
cancel-on-collision: true
velocity: 10
height: 0
#spell: targetedspell1
#collision-spell: targetedspell2

WindWalkSpell 腾空步法术
描述 : Buff 类法术。此法术可以使得施法者在空中飞行，类似于创造模式的飞行 .
设置项 :

设置项	描述	默认值
fly-speed 飞行速度	玩家飞行速度	0.1
launch-speed 起飞速度	如果此值大于0 ,施法者施法后会被抛向空中( 由于在飞性,所以不会掉 ). 此值越高非得 The bigger the number, the higher they'll go.	1
max-y 最大Y	最大的Y方向高度	260
max-altitude 最大海拔(我觉得他说错了)	玩家的最大海拔高度(距离地面上方块的距离)	100
cancel-on-land 落地撤销	是否让玩家在落地后撤销此技能的效果？	true

Spell Default 默认技能举例 : Windwalk:
spell-class: ".buff.WindwalkSpell"
name: Windwalk
enabled: true
cast-item: stick
fly-speed: 0.1
launch-speed: 1
cancel-on-land: false
cancel-on-logout: true
cancel-on-teleport: true
duration: 120

2020-12-26 06:08:42

炫宙菌

本帖最后由炫宙菌于 2021-1-8 00:14 编辑

Custom Recipes

自定义配方

自定义配方可以在 general.yml 中修改或通过任何法术文件修改。基本设置如此形式 :
recipes:
randomKey:
# ( 配方表形式 )
全局设置项

设置项	描述
type 类型	可用类型 : shaped 有序 , shapeless 无序 , and furnace 熔炼 . 1.14+ 可使用 : smoking 烟熏 , campfire 营火 , blasting 高炉 , stonecutting 切石机 , and smithing 锻造台 .
result 成品	魔法物品形式
quantity 数量	配方中的数量
group	字符串，可以在Recipe Book中组合配方。举例说明，所有的染色材料被归为一个组合
namespace-key [size=13.3333px]名字重合关键词[?]	此关键词使得此配方与其他配方不同防止配方重合的命名空间

Shaped Recipe 有序配方 :

设置项	描述
shape	合成表的形式是字符串列表。应当由三个字符串组成 , 每个长度为3字母。代表了3×3的合成空间(工作台)详情见下文举例。
ingredients 成分	合成表的成分。用以代指物品，数值代表物品材质合成表中一种较为流行的配置方式 Key-value pair, where the key is a shape character, and value is a material. 如若填写了未指明的的字符，通常表示空气

举例 :
shape:
- "I#I"
- "III"
- "III"
ingredients:
I: iron_ingot
上述内容表示有序合成 , 要求为：
第一行：铁空铁
第二行：铁铁铁
第三行：铁铁铁
成分的作用：把游戏中的物品铁锭 (iron_ingot) 当作字符 ” I ”
Shapeless Recipe 无序配方 :

设置项	描述
ingredients	材料的字符串列表

Cooking Recipe 烹饪配方 : 此设置指代烟熏、营火、高炉的配方

设置项	描述
ingredient	材料
experience 经验	烧制完毕后奖励的经验值
cooking-time 烹饪时间	以服务器tick计量烧制的时间

Stonecutter Recipe 切石机配方 :

设置项	描述
ingredient	材料

Smithing Recipe 锻造台配方 :

设置项	描述
base 基础	材料
addition 附加物	材料

2021-01-01 16:02:09

炫宙菌

本帖最后由炫宙菌于 2021-1-2 21:23 编辑

Magic Items

魔法物品

描述 : 魔法物品可以在任何法术文件中指定 , 也可以在 general.yml 中指定。这样可以在不同的地方使用相同的物品，无需每次都遵循 Cast Item 格式重写。不仅如此， Magic Items 提供了一些 Cast Item格式不支持的物品额外的设置项，且支持 Spigot的ItemStack 串行化
Spigot's ItemStack 格式如果你想使用 Spigot's ItemStack 格式，请点此处查看可用设置项。也可以通过 Item Serialize Spell 法术手持物品将魔法物品认定为 ItemStack 物品
You can also generate magic items as ItemStack objects from hand held items using the .
可设置项如下 :
magic-items:
# 魔法物品名
item:
type: external::spigot
data:
如果你想使用常规设置项，点击这里查看配置，一些可配置项如下 :
magic-items:
# 魔法物品名称
item:
# 设置项
可以用 /ms magicitem 命令来获得魔法物品
常规配置项 :

设置项	描述	变量类型
type 种类	由 Bukkit API设定的物品名。可以通过冒号还指定耐久。不仅如此 , type 可以使用形如 " external::spigot " 的格式来变更data中设定的ItemStack YAML[?] serialise the item from an ItemStack yaml object defined in data . 创建魔法物品时必须填写此设置项。	字符串
name 名称	显示的物品名，支持颜色代码。不能直接使 %var 参数 , 但如果此物品作为 Menu Spell菜单法术中的物品则可以使用	字符串
lore	指定物品lore的字符串列表。性质和上面那个类似。	字符串列表
enchants 附魔	字符串列表，指定物品的附魔，格式为： < 类型 > < 等级 > 。如果留空(不是不写)，则会仅仅展示发光的附魔效果(假附魔)	字符串列表
custom-model-data 自定义模型数据	设定自定义模型数据	整型数
hide-tooltip 隐藏工具提示	是否隐藏工具提示	布尔值
attributes 属性	可配置部分，任何关键词都可以被指定。 A configuration section where any key name can be defined. 格式 : ( 属性名 ) ( 设置 ) ( 运算符 ) ( 槽位 ) 。运算符是可填的，如果填写的与可填项不符，则会采用 add_number 模式 , 可用的全部运算符有： add_number , add_scalar 和 multiply_scalar 。槽位也是可填可不填的，有以下的样式 : hand 主手 , off_hand 副手 , feet 脚部 , legs 腿部 , chest 身体 , head 头部	Configuration Section

每个物品的可设置项 烟火之星 Firework Star :

设置项	描述	变量类型
firework-type 烟火类型	烟火类型 (ball 球状 , ball_large 大型球状 , star 星 , burst 爆裂 , creeper 爬行者 )	字符串
trail 尾迹	是否有尾迹 ?	布尔值
flicker 闪烁	是否闪烁 ?	布尔值
colors 颜色	烟火颜色 (hex 颜色格式),可以用英文逗号分隔	字符串
fade-colors 消退颜色	烟火消退颜色 (hex 颜色格式),可以用英文逗号分隔	字符串

烟火 Firework :

设置项	描述	变量类型
firework-effects 烟火效果	烟花火箭的效果。 ( 种类 ) ( 尾迹 ) ( 闪烁 ) ( 颜色 )(,) ( 消退颜色 )(,)	字符串列表
power 威力	烟火威力	整型数

迷之炖菜 Suspicious Stew

设置项	描述	变量类型
potion-effects 药水效果	药水效果 ( 药水效果 ) ( 时效 )	字符串列表

皮革盔甲 Leather Armor

设置项	描述	变量类型
color	Hex 颜色格式	字符串

药水 Potion

设置项	描述	变量类型
potion-effects 药水效果	字符串列表，格式为 : ( 类型 ) ( 强度 ) ( 时效 ) 。如果设定为环境效果请填写 " ambient " 或 " true "	字符串列表
potion-color 药水颜色	Hex 颜色格式	字符串

头颅 Skull

描述	描述	变量类型
skull-owner 所有者	头颅所有者 (UUID)	字符串
uuid	指定UUID	字符串
texture	指定材质	字符串
signature	指定 signature.	字符串

有耐久的物品 Items with durability

设置项	描述	变量类型
repair-cost 修复消耗	修复消耗	整型数
unbreakable 无法破坏	无法破坏	布尔值
durability 耐久	耐久	整型数

书 Books

设置项	描述	变量类型
title	标题。支持颜色代码	字符串
author	作者。支持颜色代码 .	字符串
pages	字符串列表，可以设定书的页面，支持颜色代码。分行代码为 " \n " 或者使用yaml文字样式 "`	任何文本都将视作字符串，保留了换行符(见下文)

旗子 Banner

设置项	描述	变量类型
patterns 图案	字符串列表，设定图案，格式 : ( 图案 ) ( 染色 ) 。点击这里查看可用的颜色类型，点击这里查看可用的图案	字符串列表

举例 : magic-items:
sun_sword:
type: "golden_sword"
name: "&6 太阳剑 "
lore:
- "&e 它 &6 散发 &e 出 "
- "&e 太阳的威光 "
sun_helm:
type: "leather_helmet"
name: "&6 太阳头盔 "
enchants:
- "fire_protection 1"
lore:
- "&e 太阳的 &6 威光 "
- "&e 让你免受 &c 火焰 &e."
color: "FFFF55"
sun_chestplate:
type: "golden_chestplate"
name: "& 6 太阳胸甲 "
lore:
- "&e 太阳的 &6 威光 "
- "&e 让你 &c 健康 &e."
attributes:
- generic.maxhealth 10 add_number
sun_potion:
type: "potion"
name: "& 6 太阳药水 "
lore:
- "&e 太阳的力量给了你 "
- "&e 免受 &c 火焰的威力 "
- "&e 和 &8 夜视的能力 &e."
potion-effects:
- "fire_resistance 0 600"
- "night_vision 0 600"
rule_book:
type: "written_book"
title: "&4 规则之书 "
author: "&c 管理员 "
pages:
- 请阅读我 , 我很重要
- 这事第二页啦，还有一些内容
- | 这事第三页了有好几行吧 . 看又是一行 .
魔法物品也可以作为某些法术和施法物品的消耗。如果物品的耐久与其本身不符，则无效。以下内容举例为 : 必须手持“法杖”且释放一次法术就消耗一个“法力水晶”
magic-items:
ManaCrystal:
type: "redstone"
name: "&b 法力水晶 "
lore:
- "&7 施法的必须物 "
MagicWand:
type: "stick"
name: "&c 法 &6 杖 "
lore:
- "&7 右键施法 "
SpeedMagic:
spell-class: ".targeted.PotionEffectSpell"
right-click-cast-item: MagicWand
type: 1
strength: 1
duration: 200
targeted: false
cost:
- ManaCrystal 1

2021-01-01 16:07:51

炫宙菌

Cast Items

施法物品

描述 : 施法物品是基于 Magic Items 的，但单独成行的字符串。由于自身局限性，并非所有的设置项都支持，最好使用 Magic Item 替代。简单来说就是 CastItem 是一行字符规定的物品，类似于原版指令给予的物品。
施法物品的格式非常简约 (JSON 字符串形式 ): itemType 物品种类 {itemData 物品数据 , itemData,...}
itemData 处填写什么 ?:

数据	描述	变量类型	举例
name	物品名称	字符串	stone_sword{name:"God Sword"}
amount	物品数量	Integer	stone_sword{amount:2}
durability	物品耐久	Integer	stone_sword{durability:10}
customModelData	自定义模型数据	Integer	stone_sword{customModelData:20}
color	Hex 颜色格式设定颜色	字符串	leather_boots{color:#214365}
potion	药水种类	字符串	potion{potion:mundane}
title	物品标题(书)	字符串	written_book{title:"Interesting Book"}
author	物品作者 (书)	字符串	written_book{author:"God"}
enchants	物品附魔	字符串 :Integer(,) (enchantName:enchantLevel)	stone_sword{enchants:{ fire_aspect:1, smite:2, sharpness:3 }}
lore	物品lore	字符串 , 字符串 (,)	stone_sword{lore:["&aVery Strong", "&bStrong", Sword]}

实战举例
diamond_sword{name:"&a 神之剑 ", amount:3, enchants:{ fire_aspect:1, smite:2, sharpness:3 }, lore:[ 非常 , 强大 , 的剑 ]}

2021-01-01 16:09:15

炫宙菌

本帖最后由炫宙菌于 2021-3-1 22:08 编辑

Variables

变量

Variables 变量
描述 : 在 MS 中 , 你可以用变量储存一些信息。变量由其名字和包含的信息类型决定。
通用类配置 :

设置项	描述	变量类型	默认值
type 类型	决定变量可以包含的信息，可用类型有 : global 全局 , player 玩家 , globalstring 全局字符串 , playerstring 玩家字符串 , distancetolocation 距离位置 , and squareddistancetolocation 距离位置平方[?]	字符串	global
permanent 参数	此变量值应当在重载还是服务端重启时被储存被储存?	布尔值	true
scoreboard-title 记分板标题	如果不指定此项 , 则此功能保持禁用状态。此记分板功能只对玩家( player )类型的变量有效	字符串	""
scoreboard-positon 记分板位置	此项决定了记分板展示的位置。可用位置有 : sidebar 侧边栏 , nameplate 名字下方 , playerlist 玩家列表里 .	字符串	""
exp-bar 经验条	是否在经验条位置展示此变量。不会修改真正的经验值。此项只对全局( global )和玩家( player )变量类型起效。	布尔值	false
boss-bar BOSS血条	如果这里写了如何东西，则此变量值就会作为BOSS血条显示出来。这里可以指定BOSS血条的标题(字符串格式)或一个BOSS Boss血条配置部分 (map 格式 ).	字符串或某配置部分	null

BossBar 配置

设置项	描述	变量类型	默认值
title 标题	指定BOSS血条的标题 .	字符串	""
style 种类	指定BOSS血条的类型	字符串	"solid"
color 颜色	指定BOSS血条的颜色	字符串	"purple"
namespace-key 防重名关键词	指定防重名关键词。如果不重复 , 则此血条会单独显示	字符串	"ms_variable"

Meta 变量 : Meta 变量是一类特殊的变量，可以方便地检视修改实体、玩家、服务器等的特殊数据。比如获取在线玩家数、设置玩家指南针所指位置等。变量列表可以在这里找到 , 但是请注意这些量必须前面跟前缀 “ meta_ ” ( 如 meta_location_x ).

Variable Types 变量类型 :
global type 全局 · 全局变量不需要指定所有者，如果通过 /ms variable modify 命令修改变量，则可以用 <player> 指定玩家，或任何非玩家名的字符串
· 这里使用的 Java 变量类型为双精度浮点数

设置项	描述	变量类型	默认值
default 默认	默认变量值	双精度浮点数	0
min 最小值	最小值	双精度浮点数	0
max 最大值	最大值	双精度浮点数	Double.MAX_VALUE

player type 玩家玩家类变量绑定玩家。此变量类型的配置项和 global 变量类型共享

globalstring type 全局字符串 · 此类型也是一个全局类型 ——不指定所有者。当使用 / ms variable modify , 使用 - 作为 <player>
· 此变量内 Java 变量类型是字符串
· 此变量类型只有 default-value 可用。

playerstring type 玩家字符串 此变量变量绑定玩家。此变量类型的配置项和 globalstring 变量类型共享

distancetolocation type 距离位置 · 此变量不能被修改，它通过设定好的配置转换距离计算
· 此变量内 Java 变量类型是字符串

设置项	描述	变量类型	默认值
default 默认值	如果有内容未通过( faild )，则退回一个默认值	双精度浮点数	0
cross-world 跨世界	可以跨世界计算距离？	布尔值	false
target-location 目标位置	要计算的位置格式： world,x,y,z .	字符串	world,0,0,0
cross-world-distance-multiplier 跨世界距离倍率	跨世界计算距离的话乘上一个什么数	双精度浮点数	1