[插件]SkillAPI教程 —— 试着做一个华丽的技能吧

本帖最后由 Alpha-∞ 于 2020-5-31 13:45 编辑

此排版来自PCD小组

SkillAPI教程

（注：该教程以Spigot-1.12，SkillAPI-Premium-1.87作测试，无法保证所有内容与其他版本兼容）

本插件是付费插件, 部分功能为付费版独有

插件配置类型

内容编写

编写属性

wiki

Attributes系统默认是关闭的，如果需要用到这项系统

打开config.yml找到

attributes-enabled: 'false'

复制代码

设置成true，然后重启服务器生成attribute.yml文件

然后就可以开始编写属性了

首先看这个模板(请勿直接复制, 若要复制, 请自行删除每行末的[n]字符, 否则将导致不可预料的后果)

力量: [1]
display: '力量' [2]
max: '999' [3]
icon: 'ink sack' [4]
icon-data: '1' [5]
icon-lore: [6]
- '&c力量'
- '&6已分配 &7(&2{amount}&7)'
- '&6每点&c力量&6提供'
- '&61点普攻伤害'
global:
condition: {}
mechanic: {}
target: {}
stats:
physical-damage: 'v+a*1'

复制代码

给大家分别列举了一下每一个选项的内容

[1]属性的内部名称，一般用不到，推荐与[2]一致

[2]属性的展示名称，用于技能，GUI.yml等地方

[3]最大加点数，即能通过/class attr加点的最大等级；该选项不会限制来自装备和技能加成的属性

[4]在GUI界面中显示的图标ID

[5]在GUI界面中显示的图标的Data值

[6]在GUI界面中显示的图标的lore；其中第一行会默认读取成图标的名称

[7]属性的目标选取选项，一般不需要管
[8]属性提升的各种能力值

这里[1],[2],[3],[4],[5],[6]就不多解释了

重头戏在[7]和[8]

咱们先来讲[8]，再讲[7]，相对[8]，[7]更难理解，但是实用性不大，实在不会可以跳过

[8]的格式是

能力ID: '公式'

复制代码

只需要严格参考这个公式，就可以写出你想要的属性

一个属性支持多个能力ID

能力ID有如下几种

health                      玩家的最大生命值
mana                         玩家的最大魔力值
mana-regen             玩家的魔力值每秒恢复量
move-speed             玩家的移动速度
physical-damage       玩家的普通攻击伤害（包括近战和弓箭）
physical-defense       玩家的普通攻击伤害减免
skill-damage                玩家的技能攻击伤害
skill-defense                玩家受到技能伤害的减免
armor                         [付费版][1.9+] 普通攻击伤害减免（百分比）
armor-toughness       [付费版][1.9+] 二级伤害减免
attack-speed                [付费版] [1.9+] 攻击速度
cooldown                   [付费版] 修改技能冷却时间
defense-<type>          [付费版]减免各种来源的伤害，具体伤害源参考这里
exp                               [付费版]增加所有获得的职业经验
hunger                         [付费版] 增加饱食度消耗的时间。此属性始终基于基值1。例如，如果结果值为2，将使原饱食度的时间增加至基础值的两倍(比如本来能持续10秒的现在能持续20秒)
hunger-heal                [付费版] 增加饱食度满的时候的恢复生命量
knockback-resist          [付费版]  [1.9+] 击退抗性，其中（1表示100%，免疫击退）
luck                               [付费版][1.9+] 获取掉落的几率
skill-damage-<职业名> [付费版]指定职业的伤害加成
skill-defense-<职业名> [付费版]玩家受到指定职业伤害的减免

计算式中，a表示该属性的总量，v表示该属性没有受到加成时的值
支持的运算有
下列高级运算中需将x替换为a/v, 且需要付费版才可使用

加 +
减  -
乘 *
除 /
乘方 ^
对数 _
绝对值 abs(x)
平方 sq(x)
平方根 sqrt(x)
正数取+1，负数取-1,0取0 sign(x)
向上取整 ceil(x)
向下取整 floor(x)
正弦 sin(x)
余弦 cos(x)
正切 tan(x)

[7]是指对技能的目标加成，目前有用到的可以这么写

global:
condition: {}
mechanic: {}
target:
Cone-range: 'a+v'
Linear-range: 'a+v'
Location-range: 'a+v'
Nearest-radius: 'a+v'
Single-range: 'a+v'

复制代码

这个的意思是对所有技能的选取范围+1格

编写职业

编写职业之前呢，咱们先来看看一个模板

当然也可以用编辑器

(请勿直接复制, 若要复制, 请自行删除每行末的[n]字符, 否则将导致不可预料的后果)

战士:

  name: '战士'[1]

  action-bar: ''[2]

  prefix: '&c战士'[3]

  group: '战士'[4]

  mana: '&2魔力'[5]

  max-level: 300[6]

  parent: ''[7]

  needs-permission: 'true'[8]

  attributes: [9]

health-base: '20'

mana-base: '103'

health-scale: '0'

dexterity-scale: '0'

mana-scale: '3'

dexterity-base: '0'

  mana-regen: 1.0[10]

  tree: 'REQUIREMENT'[11]

  blacklist:  [] [12]

  skills: [] [13]

  icon: 'QUARTZ' [14]

  icon-durability: 0 [15]

  icon-data: 0 [16]

  icon-lore: [17]

  - ''

  exp-source: 273 [18]
复制代码
[1]职业的ID

[2]含义不明。。

[3]职业的展示名称，支持颜色代码“&”

[4]这是职业组，推荐不要重复

[5]这个职业的mana属性被显示成什么

[6]该职业满级是多少

[7]这个职业的前置职业（父系）

[8]这个职业是否需要权限，权限是skillapi.class.<职业名>

[9]这个职业拥有什么属性，其中XXX-base表示初始属性，XXX-scale表示每级提升多少点属性

[10]这个职业默认恢复魔力值的速度

[11]这个职业的技能树

[12]这个职业的黑名单职业，加入了黑名单职业后不能再加入这个职业？

[13]这个职业的技能

[14][15][16][17]这个职业在/class profess打开的GUI界面中显示的图标相关属性

[18]这个职业的经验来源？

对于编写一个职业，最关键的就是[9]和[13]相结合，这样可以把职业特色最大化

编写职业其实很简单，把上面的模板复制过去改改就行了

但是写好一个职业绝非易事，要做到职业特色，否则写出来的职业只是没有专长的散人

这样保存之后呢，重启服务器，插件会帮你把这个职业载入到group.yml

打开之后是这样子的

法师:

  default: 'none' [1]

  permission: 'none' [2]

  profess-reset: 'false' [3]

  can-reset: 'true' [4]

  friendly: 'false' [5]

  show-scoreboard: 'true' [6]

  exp-lost-on-death: 0.0 [7]

  starting-points: 3 [8]

  points-per-level: 3.0 [9]

  starting-attribs: 1 [10]

  attribs-per-level: 1.0 [11]

  use-custom-points: 'false' [12]

  use-custom-attribute-points: 'false' [13]

  custom-points: [14]

5: 1

10: 1

15: 1

20: 1

  custom-attribute-points: [15]

5: 1

10: 1

15: 1

20: 1
复制代码
[1]这个职业是否为默认职业，即一进服就加入该职业

[2]这个职业需要的权限名，'none'不需要

[3]加入新的职业后，技能点和属性点是否重置

[4]这个职业是否能够被/class reset，设false则该职业不能被重置

[5]这个职业是友好还是敌对

[6]是否展示计分板

[7]玩家如果阵亡，扣除多少经验

[8]玩家加入职业的时候，拥有多少技能点

[9]玩家每升1级获得多少技能点

[10]玩家初始拥有多少属性点

[11]玩家每升一级获得多少属性点

[12]是否启用自定义技能点，启用后，玩家升级不再获得技能点，而是到达指定等级给予技能点

[13]属性点，同[12]

[14]针对[12]的达到多少级获得多少技能点的配置

[15]属性点，同[14]

技能编写

咱们还是先来看一个模板

技能 1: [1]
name: '技能 1' [2]
type: 'Dynamic' [3]
max-level: 5 [4]
skill-req-lvl: 1 [5]
needs-permission: 'false' [6]
attributes: [7]
level-base: '1'
level-scale: '0'
cost-base: '1'
cost-scale: '0'
cooldown-base: '0'
cooldown-scale: '0'
mana-base: '0'
mana-scale: '0'
points-spent-req-base: '0'
points-spent-req-scale: '0'
incompatible:
- ''
msg: '&6{player} &2has cast &6{skill}' [8]
icon: 'AIR' [9]
icon-durability: -1
icon-data: -1

复制代码

别看了这不是一个完全的技能图，只是部分，用来讲解用的，之前用过这插件的都知道components下面还有一大段，那段才是重点

还是老规矩，先逐个分析，最后用编辑器演示制作一个技能

[1]技能内部名称，务必与文件名和[2]保持一致，否则会出很多奇奇怪怪的问题

[2]和[1]一致即可，不需要颜色代码

[3]技能类型，用于展示给玩家看的，可不去理会

[4]填写的是这个技能的最大等级

[5]填写的是前置技能等级，如果需要前置，请在前面插入一行

skill-req: '技能名'

复制代码

这样就可以用一个技能来限制另一个技能的学习，应该你们都懂的

[6]是指这个技能是否需要权限，权限节点skillapi.skill.<技能名>
[7]是这个技能的次重要部分，它决定了这个技能的属性
逐个分析，base和scale之前讲过了，一个是初始值，一个是技能升级后的递增值
level就是技能需要多少级才能学习
cost就是技能升级需要多少技能点
cooldown是指，释放技能后需要等待多长时间才能继续释放技能，理解为冷却
mana是指释放技能消耗的魔力值
points-spent-req指的是在这之前需要使用多少点技能点才能加点这个技能
incompatible下面填写技能名称，如果这个技能被加点，那么incompatible填写的所有技能都将不能学习，反之同理
[8]释放技能的时候，旁边玩家看到的信息，这个范围和默认信息可以在language修改
[9]该技能在/class skill打开的GUI界面中，显示的是什么按钮，描述之类的
[10]这个技能的效果

编辑技能效果推荐先跳转下方其他工具栏打开编辑器

否则你会很头大

这里需要了解三点

1.你要怎么样触发这个技能

2.触发这个技能之后选取什么目标

（可选：选取目标后检测什么基础条件）

3.全部选取，检测完毕后有什么效果

咱们来逐项讲解

1.你要怎么样触发这个技能

先点击触发条件

说得抽象点就是说

你的玩家需要怎么做来触发这个技能

只有经过了这一步，才算成功地释放一个技能

其中

除“主动释放”外，其他均可用于制作被动技能

“复活触发”+“被动（等下会讲到）”是最常用的被动组合

选择了触发方式后，会跳转至该触发方式的细节编辑（如果有）

根据个人需求来编辑就行了

2.触发这个技能之后选取什么目标

点击刚刚建立的Cast主目录下的Add Child，然后弹出的界面第一栏便是选取目标

这里示例选择“直线”，就是选取一条直线的目标

选取自身不需配置，但是运行选取自身的技能后会加载出其配置

如果技能无效的话尝试把选取自身这一环节中的“群组”修改成Both

然后打开的界面就是一些参数，咱们一一讲解

钥匙图标能让这个技能在GUI中技能图标里面显示这个技能的一些变量

这个在等下生成代码的时候讲解会更好理解一些

然后距离和宽度就是这条直线的长度与宽度

群组没什么好说的，可以选择队友，敌人，两者，这里选取的是敌人

穿墙就是是否能够无视墙壁造成伤害

包括施法者就是连你自己一起选取

最大目标就是选取最大目标数量，多出来的不选取

配置好了之后，点击Done

（可选：选取目标后检测什么基础条件）

然后单击在Linear目录下的Add Child，下拉找到基础条件

这里是检测条件是否满足，如果满足就继续进行技能，不满足就切换下一个检测条件，其实很好理解

示例选择“几率”，有几率成功触发技能，有几率失败，初始几率5%，每级增加5%

3.全部选取，检测完毕后有什么效果

单击在Chance目录下的Add Child，下拉找到最终效果

此处示例选择“造成伤害”

类型选择Damage

主动释放不要管

造成的伤害初始20，每级增加5

真实伤害False

于是一个主动释放，几率对一条直线目标造成伤害的技能就做好了

保存之后，我的代码是这样子的

鸡你太美:

  name: '鸡你太美'

  type: '主动技能'

  max-level: 20

  skill-req: ''

  skill-req-lvl: 1

  needs-permission: 'False'

  msg: '&6玩家{player} &2释放了&6{skill}'

  combo: ''

  indicator: '2D'

  icon: 'Jack O Lantern'

  icon-data: 0

  icon-lore:

  - '&d{name} &7({level}/{max})'

  - '&2类型: &6{type}'

  - ''

  - '{req:level}等级: {attr:level}'

  - '{req:cost}技能点: {attr:cost}'

  - ''

  - '&2法力值: {attr:mana}'

  - '&2冷却: {attr:cooldown}'

  - '有几率对一条直线目标造成伤害'

  attributes:

level-base: 1

level-scale: 0

cost-base: 1

cost-scale: 0

cooldown-base: 5

cooldown-scale: 0

mana-base: 5

mana-scale: 0

  components:

Cast-a:

   type: 'trigger'

   data:

      icon-key: ''

   children:

      Linear-b:

      type: 'target'

      data:

         icon-key: ''

         range-base: 20

         range-scale: 0

         tolerance-base: 4

         tolerance-scale: 0

         group: 'Enemy'

         wall: 'False'

         caster: 'False'

         max-base: 2

         max-scale: 2

      children:

         Chance-c:

            type: 'condition'

            data:

               icon-key: ''

               chance-base: 5

               chance-scale: 5

            children:

            Damage-d:

               type: 'mechanic'

               data:

                  icon-key: ''

                  counts: 'True'

                  type: 'Damage'

                  value-base: 20

                  value-scale: 5

                  true: 'False'
复制代码

有没有觉得'有几率对一条直线目标造成伤害'的描述不太准确？

这个时候，钥匙图标的作用就体现出来了

分别在Linear-b，Chance-c，Damage-d的icon-key: ''依次填上ikun1，ikun2，ikun3

然后把'有几率对一条直线目标造成伤害'改成

'有{attr:ikun2.chance}几率对一条直线(长{attr:ikun1.range},宽{attr:ikun1.tolerance})目标造成{attr.ikun3.value}伤害'

就可以实时显示这些变量啦，技能每升一级这些变量都会随之变化

最后的代码是这样子哒

鸡你太美:

  name: '鸡你太美'

  type: '主动技能'

  max-level: 20

  skill-req: ''

  skill-req-lvl: 1

  needs-permission: 'False'

  msg: '&6玩家{player} &2释放了&6{skill}'

  combo: ''

  indicator: '2D'

  icon: 'Jack O Lantern'

  icon-data: 0

  icon-lore:

  - '&d{name} &7({level}/{max})'

  - '&2类型: &6{type}'

  - ''

  - '{req:level}等级: {attr:level}'

  - '{req:cost}技能点: {attr:cost}'

  - ''

  - '&2法力值: {attr:mana}'

  - '&2冷却: {attr:cooldown}'

  - '有{attr:ikun2.chance}几率对一条直线(长{attr:ikun1.range},宽{attr:ikun1.tolerance})目标造成{attr.ikun3.value}伤害'

  attributes:

level-base: 1

level-scale: 0

cost-base: 1

cost-scale: 0

cooldown-base: 5

cooldown-scale: 0

mana-base: 5

mana-scale: 0

  components:

Cast-a:

   type: 'trigger'

   data:

      icon-key: ''

   children:

      Linear-b:

      type: 'target'

      data:

         icon-key: 'ikun1'

         range-base: 20

         range-scale: 0

         tolerance-base: 4

         tolerance-scale: 0

         group: 'Enemy'

         wall: 'False'

         caster: 'False'

         max-base: 2

         max-scale: 2

      children:

         Chance-c:

            type: 'condition'

            data:

            icon-key: 'ikun2'

            chance-base: 5

            chance-scale: 5

            children:

            Damage-d:

               type: 'mechanic'

               data:

                  icon-key: 'ikun3'

                  counts: 'True'

                  type: 'Damage'

                  value-base: 20

                  value-scale: 5

                  true: 'False'
复制代码

把它丢进/plugins/SkillAPI/dynamic/skill然后打开刚刚创建的职业，找到

skills:

- ''
复制代码

然后把技能名称填进去

比如这样

skills:

- '鸡你太美'
复制代码

再输入/class reload就可以载入这个技能了

*如果是付费版，还需关服，打开gui.yml，输入

ikun:

  rows: 1

  pages: 1

  slots:

1:

   鸡你太美: 0
复制代码

此处第一行，在重启后会变成stikun，目前不明原因，如果出现这类情况，不需改动

然后启动服务器即可

编辑工具

进阶内容

1. 技能编写中，Key和Icon_Key的应用及区分

2. 进阶技能编写

被动技能:

这类技能的触发器通常使用“复活触发”[1]，当然也可以使用“普通/技能攻击触发”和“受到普通/技能攻击触发”[2]

这类技能通常不需要魔力值消耗，甚至冷却都不需要

使用[1]类技能时，通常是利用“复活触发”，选取自身为目标，然后调用最终效果“被动”，再添加其他子环节

这类技能允许在“被动”这一环节下，使用判断条件，再添加最终效果

“被动”的周期时间务必与技能冷却时间一致，否则会出现叠加技能效果的情况

使用[2]类技能时，利用“(受到)攻击触发”，然后直接添加(判断条件)最终效果即可

该类技能可以通过控制最终效果的持续时间和技能冷却时间差来达到连续触发叠加属性的效果

存储值技能:

这类技能可以添加变量来检测玩家(目标)的当前属性，然后直接应用于技能的最终效果

各类存储值的作用如下：

标签存储值: 检测玩家主手（副手）持有物品的某条lore（由正则表达式控制），读取该条lore对应的value值并记录到Key

标签槽存储值: 检测玩家背包某个槽位放置物品的某条lore（由正则表达式控制），读取该条lore对应的value值并记录到Key

属性存储值: 读取玩家的某条属性的总和值（包括加点和装备加成）并记录到Key

生命存储值: 读取玩家当前生命值并记录到Key

法力存储值: 读取玩家当前法力值并记录到Key

坐标存储值: 读取玩家当前坐标并记录到Key

随机存储值: 在给定的最大值和最小值之间随机取一个值记录到Key

添加存储值: 在原有Key的基础上添加一个值，这个值可以是另一个Key(取负数为减少)

倍数存储值: 在原有Key的基础上乘以一个值，这个值可以是另一个Key(取小数为除)

普通存储值: 无视原有Key直接设置Key的值

记录Key后可以直接在其他环节中填写数值的地方填写对应的Key

Key在技能释放完毕后仍将存在，可多次调用

在下一次存储值（或者玩家转移世界/被击杀）之前，这个值不会改变

天赋技能:

对于任何技能，可以通过设定其needs中的level为零来做到玩家不需等级即可升级

对于任何技能，可以通过设定其needs中的cost为零来做到玩家达到对应等级自动升级

对于任何技能，可以通过设定其needs中的level和cost为零来做到加入职业自动升级，甚至自动满级

依此可作为某些不需加点的被动技能. 并且作为职业的天赋等

3.大胆的想法(但是没时间实现，有闲情雅致的大佬们可以去尝试一下):

[1]通过Skill与Attribute制作船新Attribute？

比如说

在Attribute.yml上面创建一个叫做 “暴击几率”和“暴击伤害”的属性，但是不予任何属性加成，即创建一个空壳属性

然后制作一个叫做“暴击.yml”的技能

技能的大致内容是“（技能）攻击触发” → “属性存储值（存储‘暴击几率’，计入关键词“bjjl”）” → “几率（几率的base填写bjjl，scale不需填）” → “属性存储值（存储‘暴击伤害’，计入关键词‘bjsh’）” → “属性存储值（存储攻击力属性，计入关键词gjl，如果使用非SkillAPI的攻击力属性请使用标签存储值）” → “倍数存储值（关键词填写gjl，倍率填写bjsh）”

注1：该技能needs中level-base，level-scale，cost-base，cost-scale均填写0，以确保玩家加入职业就能暴击

此时，把这个技能添加到所有职业里面，重载插件（服务器）即可

注2：该技能不需添加到gui.yml

[2]通过Skill制作船新功能？

比如说

制作一个戒指槽

新建一个技能，这个技能大致内容是“复活触发” → “被动（这个循环周期一定要短，1s左右合适）” → “标签槽检测（检测第XX格放置的东西是否有‘生效部位戒指槽’）” → “标签槽存储值（这里需要你把将要用到的属性都存储一遍）” → “属性加成（直接填写标签槽存储值里面的关键词，属性名务必保持一致）”

注1：该技能“被动”的循环周期务必与冷却时间一致

注2：该技能needs中level-base，level-scale，cost-base，cost-scale均填写0，以确保玩家加入职业就能穿戴戒指

再比如说

制作一个存档点的技能

它将会采用主动释放，如不想玩家知道这是SkillAPI的技能，可以不将其添加到gui.yml，但是needs里面level和cost设定成0，采用/class cast释放，甚至你可以用下面的联动功能做到绑定在物品上面右键使用

新建一个技能，大致内容“主动触发” → “潜行（判定在潜行）” → “坐标存储值” → “潜行（判定非潜行）” → “坐标传送”

即可

注：该技能设定的存档点将会在玩家死亡/切换世界时丢失[spoiler]

4.[付费版]群组Ally，Emeny和Both的定义和应用
[spoiler]

相信大家在使用这款插件的时候都注意到了

技能的目标选取中，有“Group”这一项

那么它是干什么用的呢

它控制着技能的生效目标，例如技能对Ally类目标生效，即对队友生效，一般是辅助技能

而Emeny类则是敌对目标，默认所有怪物和玩家都是敌对，如果需要更改，则更改config中的

Targeting:
# 不管目标是玩家还是怪物.
# 如果你使用的宠物包括僵尸/蜘蛛/etc,
# 你不应该启用这个选项（请让它保持在false）.
# 如果你想为特定的世界启用它,列出需要的世界
# 应该使用以下格式:
# monsters-enemy:
# - world1
# - world2
monsters-enemy: 'false'
# 不管是不是所有的被动型生物都是友好的.
# 如果有自定义的被动型生物你可以攻击,
# 你不应该启用这个选项（请让它保持在false）.
# 如果你想为特定的世界启用它,列出需要的世界
# 应该使用以下的格式:
# passive-ally:
# - world1
# - world2
passive-ally: 'false'
# 不论任何玩家是友好的.
# 如果你需要pvp,这是不应该启用的选项.
# 如果你想为特定的世界启用它,列出需要的世界
# 应该使用以下的格式:
# player-ally:
# - world1
# - world2
player-ally: 'false'
# 是否通过聚集来检测玩家的队友
parties-ally: 'false'

复制代码

如果技能不生效，请先尝试着查看一下目标的组是否正确

选取self的技能不需要设置“Group”，取默认即可

在Group.yml下同样有关于“Group”的设定，一般情况下只需修改config.yml

5. 与其它属性插件的联动与兼容

6. 技能和属性的搭配

插件提供的属性完全不够用？

你还可以把属性和技能配合，完全自定义你的属性！

首先，创建两个空壳属性“暴击几率”和“暴击伤害”

然后，分别创建技能“暴击检测”，“暴击效果”

其中，“暴击检测”的技能如下

具体配置在这里

这个技能的意思就是，在玩家重生以后，每0.5秒执行一次对玩家属性的检测，并且把属性转换为“关键词”的形式

这样就可以直接调用这个值了

接下来，就是“暴击效果”这个技能了

它的架构是这样的

简单地解读一下，当玩家使用物理攻击的时候，执行一次几率判断，几率等同于刚才“暴击检测”中检测到的暴击几率

然后触发几率的话，就给予玩家伤害加成

这里有两个要点

因为判断造成伤害和造成伤害是在10~100毫秒内完成的，所以暴击伤害buff会直接计入玩家伤害中，检测的先后顺序基本上可以忽略不计

如果你的服务器使用的“暴击伤害”是类似于“1.2X”,“2.0X”的，上面可以直接使用

如果你的服务器使用的“暴击伤害”是类似于“120%”，“200%”的，插件不会检测“%”，实际上检测到的值是“120”和“200”，而插件的DamageBuff中，1 表示 100%，即实际造成伤害是原来的“12000%”和“20000%”

故你需要在Damage Buff之前加上这么一条

意为将原来的值除以100

因为暴击几率Chance中，1表示1%，所以不需要执行此步骤

这个技能的具体配置就在这里了

可是，这么做的话，物理攻击才会暴击，技能攻击不会！！！怎么整！！！

在此处再添加一个触发条件，选择“技能攻击触发”

然后把左侧物理攻击的子元件复制过来即可

这样子的话，技能也都能够暴击了！

这两个技能不需要加入gui.yml，只需将技能加入职业并且把

level-base

level-scale

cost-base

cost-scale

都设置成0即可

意为让玩家不需加点，甚至不需要知道这是技能做的

当然你如果要让这个属性可以加点

那当我没说

7.插件提供的机制完全不够用？[19-12-28]

8.复杂粒子的运用(久等了)

本插件的粒子效果大致可分为三类, 粒子抛射, 粒子动画和粒子效果(单独的粒子)

本次将逐一介绍

首先是粒子抛射(Particle Projectile)

即为向前方抛射一簇粒子, 对击中的目标应用子元件

其代码大致为

Particle Projectile-b:
type: 'mechanic'
data:
icon-key: ''
counts: 'True'
group: 'Enemy'
spread: 'Cone'
amount-base: 1
amount-scale: 0
velocity-base: 3
velocity-scale: 0
angle-base: 30
angle-scale: 0
position: 0
forward-base: 0
forward-scale: 0
upward-base: 0
upward-scale: 0
right-base: 0
right-scale: 0
gravity: 0
pierce: 'False'
particle: 'Angry Villager'
arrangement: 'Circle'
radius-base: 4
radius-scale: 0
particles-base: 20
particles-scale: 0
direction: 'XZ'
visible-radius: 25
dx: 0
dy: 0
dz: 0
speed: 1
amount: 1
frequency: 0.05
lifespan: 3
use-effect: 'False'
children:

复制代码

首先"counts"指的是是否需要主动释放技能, 如果该技能的触发器是Cast就需要填True, 反之False

"group"指的是该粒子丢出去后会命中哪些目标? 支持的类型有"Enemy(敌对)", "Ally(友好)"和"Both(两个一起打)"

"spread"为粒子传播方向, 支持的类型有"Cone(抛物线)", "Horizontal Cone(水平)"和"Rain(垂直, 即箭雨)"

"amount"为粒子数量; "velocity"为速度, 如果速度为负值, 将会往后射

"angle"就是粒子分散角度, 如果amount设为1, 则不会有影响

"forward", "upward"和"right"分别为粒子会向前, 上, 右偏移多少值, 如果为负值就向反方向偏移

"geavity"为粒子的重力, 值越大下降越快, 如果为负值就会往天上飘哦

"pierce"指这个粒子能否透过目标, 如果为True, 这将会导致这个粒子无限穿透实体直到碰到墙壁

"particle"为粒子类型, 下面会有个附录列出所有粒子类型

其他的自行参考汉化编辑器, 下面重点说一下粒子动画和粒子效果

刚入门的小朋友可能要说了, 这个粒子动画似乎只能支持在身边画一个圈, 画一个球, 画一个半圆, 那么怎样实现那种华丽的粒子特效呢?

如果要实现, 并不是很难的一件事情, 这里就不推荐使用"Particle Animation"了, 因为其粒子过于死板, 可以使用"Particle Effect"作为粒子效果的主要元件

但它只能在你身边生成粒子, 而且这个元件不支持像"粒子抛射"那样的偏离, 这可怎么办呢

这里我们就要用到一个新的目标选取器"(偏离)Offset"

但它并不能单独使用, 需要基于上一层的目标选取(你都不知道你的目标是啥还谈什么偏移)

首先选择触发器"Cast", 依次选择"Self"和"Offset", 意为在自己的基础上向一个位置偏移

这里的意思就是在自身位置往前 1 格的地方应用子组件(设置为负数同样向反方向偏移)

然后再选用"Particle Effect"就可以在你偏移的位置生成粒子了

就像这样

可是, 这只能生成一个点啊, 又有什么用呢? 这里就需要单击"Offset"元件下面那个"Copy"按钮了(可别手残点到了"Delete")

然后分别修改偏移量, 就能得到直线/圆圈/奇奇怪怪的形状的粒子效果了

当然, 向其他方向偏移也是可以的

就像这样, 我的是向前生成一条长为0.5格的直线的粒子(该示例放在下面可供下载)

插件联动

SX-Attribute

1.你可以在SX-Attribute的属性面板添加SkillAPI的变量

例子

BASE: '&9&l&o其他属性'
BASE_LORE:
- '&e经验加成&b %sx_ExpAddition%%'
- '&c力量 %sapi_attrib_total:力量%'
- '&b智力 %sapi_attrib_total:智力%'
- '&a敏捷 %sapi_attrib_total:敏捷%

复制代码

2.你可以运用SX-Attribute（v3.0+）的随机字符串配合SkillAPI的属性来自定义你的装备

例子

破损系数: '0.5'
破旧系数: '0.8'
粗糙系数: '0.9'
普通系数: '1'
优秀系数: '1.05'
稀有系数: '1.1'
精良系数: '1.15'
传说系数: '1.2'
史诗系数: '1.5'

复制代码

W1:
Name: <s:<l:品质>Color><l:品质> 激光剑
ID: '268:0'
Lore:
- '&f—————————&e装备属性&f—————————'
- '&8攻击 <c:(<s:<l:品质>系数>*144)>'
- '&c力量 <c:int(<s:<l:品质>系数>*108)>'
- '&f———————————&6其他&f———————————'
- '&7等级 60'
- '&7职业战士'
- '&7生效部位主手'
- '&7不可出售'
Unbreakable: true

复制代码

3.SX-Attribute的全息伤害显示支持SkillAPI的技能伤害

PlaceHolderAPI

1.它为你的SkillAPI提供了根本不够用的变量

免费版变量（付费版同样适用）

%skillapi_attribute_points%#玩家当前可用属性点
%skillapi_mana%#玩家当前魔力值
%skillapi_max_mana%#玩家最大魔力值
%skillapi_skill_level_<skillName>%#玩家某个技能的等级
%skillapi_skill_points_<skillName>%#玩家某个技能加点
%skillapi_skill_cost_<skillName>%#玩家某个技能需要消耗的技能点
%skillapi_skill_levelreq_<skillName>%#玩家某个技能的前置技能等级
%skillapi_skill_is_maxed_<skillName>%#玩家某个技能最高等级
%skillapi_skill_message_<skillName>%#玩家释放技能的信息
%skillapi_skill_type_<skillName>%#技能名称？？
%skillapi_skill_req_<skillName>%#玩家某个技能的前置技能

复制代码

*付费版变量

%sapi_attrib_points% 可用的属性点
%sapi_attrib_spent:<attribute>% 单个属性加点的数量
%sapi_attrib_total:<attribute>% 单个属性的总量，包括装备和技能加成
%sapi_combo% 当前你按下的组合按键
%sapi_exp% 当前这个职业的经验值(如果没有职业则为0)
%sapi_exp:<职业>% 指定职业的经验值(如果没有职业则为0)
%sapi_exp_total% 当前这个职业总共获得的经验值(如果没有职业则为0)
%sapi_exp_total:<职业>% 指定职业总共获得的经验值(如果没有职业则为0)
%sapi_exp_left% 当前这个职业距离升级的经验值
%sapi_exp_left:<职业>% 指定职业距离升级的经验值
%sapi_exp_req% 当前这个职业升级需要的经验
%sapi_exp_req:<职业>% 指定职业升级需要的经验
%sapi_level% 玩家当前SkillAPI等级
%sapi_level:<职业>% 玩家指定职业的SkillAPI等级
%sapi_mana% 玩家的当前魔力值
%sapi_mana_max% 玩家的最大魔力值
%sapi_mana_name% 玩家当前职业的魔力值名称
%sapi_mana_name:<职业>% 指定职业的魔力值名称
%sapi_prefix% 当前这个职业的展示名称
%sapi_prefix:<职业>% 指定职业的展示名称
%sapi_skill_level:<技能>% 某个技能的等级
%sapi_skill_points% 当前职业所有可用的技能点
%sapi_skill_points:<职业>% 指定职业所有可用的技能点
%sapi_value:<关键词>% 指定技能中Key关键词的值！

复制代码

GuoItemLoreCommand（gilc）

1.你可以用gilc把技能绑定在武器上，使它需要手持特定装备左键（右键，被攻击）触发

例子

屠龙宝刀:
检测描述: '&7被动: &6攻击有15%几率触发被动屠龙神技'
触发几率: 15
玩家指令:
- '[op]:class cast 屠龙神技'
后台指令: []
开启使用提醒: false
使用信息: '&e[系统] &b斯塔缇克电刃&a触发了。'
冷却模块:
是否启用该模块: true
冷却组: '屠龙宝刀'
冷却时间: 2000
是否提醒冷却中: false
冷却中提醒信息: '&c此类道具处于冷却中，剩余时间&e%less%&c。'
权限模块:
是否启用该模块: false
检测的权限: '装备权限.斯塔缇克电刃'
是否提醒权限不足: false
权限不足提示信息: '&c使用此物品需要到达&e七级&c，请升级后再尝试使用'
动作模块:
是否启用该模块: false
需要奔跑: false
需要蹲下: false
需要格挡: false
需要浮空: false
姿势不对是否提示: false
姿势不对提示信息: '&c该物品需要在蹲下时使用'</font>

复制代码

2.你可以用gilc制作关于SkillAPI的回血药剂，回蓝药剂，属性提升药剂（需要用技能制作）等

例子

魔力药:
检测描述: '&b右键使用恢复50魔力值'
点击类型: 右键
玩家指令:
- '[op]:class mana 50'
后台指令: []
开启使用提醒: false
使用信息: '&e已为你打开菜单'
物品模块:
需求堆叠数量: 1
需求不足提示: '&c需要同时持有&e1&c个此物品时才能使用'
是否消耗物品: true
冷却模块:
是否启用该模块: true
冷却组: '蓝药水'
冷却时间: 30000
是否提醒冷却中: true
冷却中提醒信息: '&e蓝药水&c类道具处于冷却中，剩余时间&e%less%&c。'
权限模块:
是否启用该模块: false
检测的权限: '药品权限.天堂的痊愈药剂'
是否提醒权限不足: true
权限不足提示信息: '&c使用此物品需要到达&e七级&c，请升级后再尝试使用'
动作模块:
是否启用该模块: false
需要奔跑: false
需要蹲下: false
需要格挡: false
需要浮空: false
姿势不对是否提示: false
姿势不对提示信息: '&c该物品需要在蹲下时使用'
变量模块:
是否启用该模块: false
判断项目:
判断等级:
判断式: '%player_level%>=30'
不通过是否提示: true
不通过提示信息: '&c等级不足，附魔等级至少要到达30级。'</font>

复制代码

MangoQuest

1.SkillAPI的职业，等级可以作为MangoQuest的任务需求

2.SkillAPI的等级可以作为MangoQuest的任务奖励

3.SkillAPI技能击杀怪物同样会计入MangoQuest的任务进度

4.用MangoQuest来制作SkillAPI的转职系统！

VexView+SkillKeyBoard
1.把SkillAPI的技能绑定到快捷键，运用VexView制作计分板显示技能信息
弊端：每一个主动技能都需要设置一个图标

MythicMobs(mm)

1.让你击杀mm怪物后掉落skillapi经验

打开mm的config，找到

compatibility:
heroes:
enabled: true
showxpmessage: true
xpmessageformat: you receive <drops.xp> experience for slaying <mob.name>
mcmmo:
enabled: true
showxpmessage: true
xpmessageformat: you receive <drops.xp> experience for slaying <mob.name>
skillapi:
enabled: false
showxpmessage: true
xpmessageformat: 你获得了&e <drops.xp> &f经验

复制代码

将skillapi的enabled设置成true

然后打开对应的怪物文件

在drops下面添加

- skillapi-exp 10

复制代码

即可让这个怪被击杀后给予击杀者10点skillapi经验

福利时间

Quest And Answer

帖子更新日志[/spoiler]
2019-6-8 帖子发布

2019-12-28
更新内容
1. "运用Key定义新的机制"

2020-5-31
1. 更新内容"复杂粒子的运用"
2. 完善并校正了帖子部分内容(更新了编辑器链接)

这款插件提供的是一个API

技能的搭配有∞种，没有任何一个教程可以完全地教透

仅提供该API内容的主要编辑过程

最后。求人气。求金粒呀

QQ图片20190823182514.png (41.06 KB, 下载次数: 104)

12.png (25.24 KB, 下载次数: 27)

13.png (36.6 KB, 下载次数: 19)

01.png (26.53 KB, 下载次数: 15)

02.png (39.01 KB, 下载次数: 24)

03.png (42.75 KB, 下载次数: 28)

04.png (91.84 KB, 下载次数: 27)

[插件]SkillAPI教程 —— 试着做一个华丽的技能吧

回复: