SkillAPI教程————内置已汉化编辑器

本帖最后由 Antarctic丶于 2017-8-18 16:39 编辑

前言:众所周知，SkillAPI的教程贴都在16年开始不再更新了，而一个新的教程贴也从3月开始没有更新了，所以我就来自己写一个教程贴了~~ 由于内容过多，本帖可能分多次更新，请不要催更

让我AT一下和我汉化了编辑器以及WIKI的基友吧@1204244136

注：本帖教程为1.8.X及以上版本，1.7.X的散了吧

一.介绍
SkillAPI是一个什么样的插件呢？他是一个可以给你一个完全自定义的职业，技能，以及种族的插件，它只给了你一个框架，而多余的部分，比如技能内容，技能效果，种族名称，职业属性等等，就需要你自己的想象力来实现了。
先在这里贴上几个地址：
      1.MCBBS的插件帖
      2.贴吧的教程贴 ←注意，此贴使用API制作职业与技能，不会JAVA的人可以无视
      3.[教程]SkillAPI编辑器完全教程——随心自定义你的RPG世界吧[HAYO Studio]
      4.SkillAPI教程——懒人专用的教程[9月27日更新]
      5.英文版编辑器（官方）
      6.中文版编辑器（我和基友汉化的）
      7.经验换算器
      8.据说是1.7.X可以用的编辑器但我没用过
      9.官方插件Wiki百科(英文版)
      10.非官方插件Wiki百科（中文版）PS：还是我和基友汉化的
      11.职业示例（竟然有个中国人在里面上传了职业）
二.索引
      1.插件配置文件(注释/汉化版本)
      已完成(完成度:90%)
      2.职业篇
      已完成(完成度:100%)
      3.技能篇
      未完成(完成度:60%)
      4.额外篇
      未完成(完成度:15%)
三.我的话
求人气，求金粒~~~
有疑问的小伙伴可以回复询问哦~
更新时间不定，如果有不会的可以去看我和朋友一起翻译的Wiki。

一.属性文件
attributes.yml

# 属性设置
#
# 详情请访问(虽然已经没用了)：
# http://dev.bukkit.org/bukkit-plugins/skillapi/pages/attributes/
#
# 可以修改且可用的属性列表：
# health - 玩家的最大生命值
# mana - 玩家拥有的法力值(魔力值)
# mana-regen - 每秒钟恢复的法力值(魔力值)
# physical-damage - 不使用技能造成的伤害(物理攻击)
# physical-defense - 不使用技能抵挡的伤害(物理防御)
# skill-damage - 技能造成的伤害(魔法攻击)
# skill-defense - 技能抵挡的伤害(魔法防御)
# move-speed - 玩家的移动速度
#一下为1.9及以上可用：
# attack-speed - 玩家的攻击速度
# armor - 玩家的护甲值
# luck - 玩家的运气值
# armortoughness - 护甲的韧度
#活力/体质
#属性编码
体质:
#属性显示名
display: '体质'
#最大等级
max: 999
#图标
#默认为墨囊,"_"以" "代替
icon: 'ink sack'
#图标副ID
#如果为羊毛
#白色羊毛填0，橙色羊毛填1
icon-data: 1
#图标LORE
#简单来说就是属性介绍
icon-lore:
- '&6体质等级:&7(&2{amount}&7)'
- ''
- '&7每升一级获得1生命值'
- '&7需要1属性点.'
#全局配置
global:
# 条件
condition: {}
# 效果
mechanic: {}
# 目标
target: {}
#统计点数
stats:
#生命值
#a=原数值 v=加点数
health: 'a+v'
精神:
display: '精神'
max: 999
icon: 'ink sack'
icon-data: 6
icon-lore:
- '&6精神等级:&7(&2{amount}&7)'
- ''
- '&7获得1魔力并且增加2.5%恢复速度'
- '&7需要1属性点.'
global:
condition: {}
mechanic: {}
target: {}
stats:
mana: 'a+v'
mana-regen: 'a*0.025+1*v'
智力:
display: '智力'
max: 999
icon: 'ink sack'
icon-data: 5
icon-lore:
- '&6智力等级:&7(&2{amount}&7)'
- ''
- '&7增加2.5%的技能伤害'
- '&7需要1属性点.'
global:
condition: {}
mechanic:
Damage-value: 'a*0.025+1*v'
target: {}
灵巧:
display: '灵巧'
max: 999
icon: 'ink sack'
icon-data: 10
icon-lore:
- '&6灵巧等级:&7(&2{amount}&7)'
- ''
- '&7增加2.5%技能范围'
- '&7需要1属性点.'
global:
condition: {}
mechanic: {}
target:
Cone-range: 'a*0.025+1*v'
Linear-range: 'a*0.025+1*v'
Location-range: 'a*0.025+1*v'
Nearest-radius: 'a*0.025+1*v'
Single-range: 'a*0.025+1*v'
力量:
display: '力量'
max: 999
icon: 'ink sack'
icon-data: 14
icon-lore:
- '&6力量等级:&7(&2{amount}&7)'
- ''
- '&7增加2.5%物理攻击'
- '&7需要1属性点.'
global:
condition: {}
mechanic: {}
target: {}
stats:
physical-damage: 'a*0.025+1*v'

复制代码

二.默认配置
config.yml

# ---------------------------------------------- #
# 一般的配置 #
# ---------------------------------------------- #
# 如果您不确定如何使用此文件, #
# 但是想要改变当前插件的配置文件 #
# 请查看Bukkit网页: #
# http://dev.bukkit.org/bukkit-plugins/skillapi/ #
# 并查看默认的配置文件 #
# ---------------------------------------------- #
Accounts:
# 用于GUI显示的主群组/职业/类组/新手职业
main-class-group: class
# 只能选择一个职业
# 好像禁用了
one-per-class: false
# 玩家可以拥有的最大用户数
# 简单来说就是玩家最多注册几个账号
max-accounts: 3
# 拥有下方权限的人可以注册更多账号
# 格式必须为:'<权限>:<数量>'
perm-accounts:
#拥有"skillapi.account.admin"权限的人可以注册10个账号
- 'skillapi.account.admin:10'
#
# 大部分时间都不需要这个目标设置
# 如果使用它们，它们可以帮助你更快地进行立场检查。
Targeting:
#
# 所有怪物都默认为敌人
# 如果你使用了宠物插件，请务必不要使用这个
# 如果想要指定世界使用此选项
# 格式为:
# monsters-enemy:
# - world1
# - world2
monsters-enemy: false
#
# 所有中立怪(不主动攻击)默认为友军
# 如果你创造了一个中立怪，请务必不要使用这个
# 如果想要指定世界使用此选项
# 格式为:
# passive-ally:
# - world1
# - world2
passive-ally: false
#
# 所有玩家默认为友军
# 如果你开启了PVP，请务必不要使用这个
# 如果想要指定世界使用此选项
# 格式为:
# player-ally:
# - world1
# - world2
player-ally: false
#
#保存
Saving:
#
# 是否定期保存数据
auto-save: false
#
# 多长时间保存一次(分)
minutes: 30
#
# 是否使用SQL数据库保存
sql-database: false
#
# 连接到数据库的详细信息
sql-details:
host: localhost
port: 54321
database: plugins
username: username
password: password
#
#职业
Classes:
#
# 是否使用SkillApi的生命值系统
modify-health: true
#
# 新手玩家(无职业)的初始生命值
classless-hp: 20
#
# 是否显示非连锁型被动技能
show-auto-skills: false
#
# 是否启用属性点
attributes-enabled: false
#
# 属性点是否可以撤销
attributes-downgrade: false
#
# 玩家在升级时释放的技能名称
level-up-skill: 'lvlup'
#
#魔力/法力
Mana:
#
# 是否使用skillapi的魔法体系
enabled: true
#
# 每秒恢复的法力值
freq: 1
#
#技能
Skills:
#
# 玩家是否可以令技能降级
allow-downgrade: true
#
# 释放技能时是否显示信息
show-messages: true
#
# 向附近玩家显示技能释放时信息的半径(在这个范围内所有玩家都会收到信息)
message-radius: 20
#
# 击退时是否有伤害
knockback-no-damage: false
#
# 不造
block-filter:
- 'chest'
- 'ender chest'
- 'trapped chest'
- 'redstone*'
- 'wall sign'
- 'sign post'
#
#物品
Items:
#
# 是否开启装备检测lore标签
lore-requirements: false
#
# 是否开启技能lore标签
skill-requirements: false
#
# 是否开启默认的属性标签
lore-attributes: false
#
# 当无法使用武器时是否丢下武器
drop-weapon: false
#
# 用于LORE中的职业文本
lore-class-text: '职业要求: '
#
# 用于LORE中的技能文本
lore-skill-text: '技能要求:{skill}: '
#
# 用于LORE中的等级文本
lore-level-text: '等级要求: '
#
# 用于LORE中的被排除的职业的文本
lore-exclude-text: '不可使用职业: '
#
# 用于LORE中的属性文本
lore-attribute-text: '{attr}要求: '
#
# 用于提供属性的文本
attribute-text: '{attr}: '
#
# 每个玩家检查几次
players-per-check: 1
#
#GUI
GUI:
#
# 血量显示固定为10颗心(20血)，只是显示而已，不会造成影响
old-health-bar: true
#
# 是否强制覆盖其他插件的生命值
force-scaling: false
#
# 是否使用经验条显示(无，法力值，等级)
# 下方填为: none, mana, level
level-bar: none
#
# 是否使用饥饿条显示(无，法力值，等级)
# 下方填为: none, mana, level
food-bar: none
#
# 是否启用计分板
use-action-bar: false
#
# 可以在计分板上使用的文本
# 可以使用的代码:
# {combo} - 玩家的攻击目标
# {class} - 玩家的职业名称
# {level} - 玩家的职业等级
# {exp} - 玩家的职业经验
# {expReq} - 玩家的职业经验需求
# {expLeft} - 玩家到下一级需要的经验
# {health} - 玩家当前生命值
# {maxHealth} - 玩家最大生命值
# {mana} - 玩家当前法力值
# {maxMana} - 玩家最大法力值
# {name} - 玩家名称
# {attr} - 玩家属性点
# {sp} - 玩家的职业技能点
# {value:<key>} - 技能按键
action-bar-text: '{combo}'
#
# 是否启用标题信息
title-enabled: true
#
# 标题信息持续时间(秒)
title-duration: 3
#
# 标题信息淡入时间(秒)
title-fade-in: 0.5
#
# 标题信息淡出时间(秒)
title-fade-out: 0.5
#
# 标题栏可以使用的文本代码
# 第二行将在副标题显示
# 代码:
# level_up
# exp_gained
# exp_lost
# status
title-messages:
- level_up
- exp_lost
#
# 是否在计分板上显示职业信息
scoreboard-enabled: true
#
# 是否在玩家姓名前加上职业名称
show-class-name: true
#
# 是否在玩家姓名后显示等级
show-class-level: true
#
# 启用时,将显示玩家等级
# 一般为:{level} {text}
class-level-text: 'Level'
#
# 使用地图树而不是技能树,这将会生成一个map.yml文件供你修改
# 同时添加更多方案在"img"文件夹
# 允许两个地图树和技能树以及常规设置
# 这是"partial"
map-tree-enabled: false
#
#点击
Click Combos:
#
# 是否开启
enabled: false
#
# 玩家可以定制自己的点击组合
allow-custom: false
#
# 是否允许左键点击
use-click-left: true
#
# 是否允许右键点击
use-click-right: true
#
# 是否允许下蹲
use-click-shift: false
#
# 执行一个组合需要多少次点击
combo-size: 4
#
# 在几秒内完成组合才会释放
click-time: 1.0
#
#技能
Skill Bar:
#
# 是否使用技能栏
enabled: false
#
# 是否在技能栏显示冷却时间
show-cooldown: true
#
# 在技能栏中用作占位符的项
empty-icon:
material: PUMPKIN_SEEDS
data: 0
text: '&7未制作'
#
# 技能栏的默认布局
# 玩家可以自定义快捷键
layout:
1:
skill: true
locked: false
2:
skill: true
locked: false
3:
skill: true
locked: false
4:
skill: true
locked: false
5:
skill: true
locked: false
6:
skill: false
locked: false
7:
skill: false
locked: false
8:
skill: false
locked: false
9:
skill: false
locked: false
#
#经验
Experience:
#
# 是否启用经验瓶
use-exp-orbs: true
#
# 自然生成的生物是否掉落经验
block-mob-spawner: true
#
# 怪物蛋生成的生物是否掉落经验
block-mob-egg: true
#
# 放置方块是否掉落经验
block-creative: true
#
# 获取经验时显示信息
exp-message-enabled: true
#
# 升级时显示信息
level-message-enabled: true
#
# 死亡是否丢失经验
lose-exp-message: true
#
# 计算所需经验的公式
# 公式为: x*lvl*lvl + y*lvl + z
# X×等级×等级 + Y×等级 + Z
formula:
x: 1
y: 8
z: 16
#
# 是否使用自定义
use-custom: false
#
# "LVL"为玩家当前等级
custom-formula: '25(1.1^(lvl-1))'
#
# 生物掉落经验
# 如果自定义为关闭，请无视这个
yields:
blaze: 10
cavespider: 5
creeper: 3
elderguardian: 10
enderdragon: 400
enderman: 5
endermite: 3
ghast: 5
giant: 20
guardian: 10
irongolem: 10
magmacube: 1
pigzombie: 5
player: 5
shulker: 5
silverfish: 2
skeleton: 3
slime: 1
spider: 3
witch: 3
wither: 500
witherskeleton: 5
zombie: 2
#
# How much logging to do when loading SkillAPI
# When testing setting up skills/classes, increase this to 1-5
Logging:
#
# Logs for loading attributes
attribute-load: 0
#
# Logs for attack/defense buffs applying
buff: 0
#
# Logs for registration of skills and classes
registration: 0
#
# Logs for GUI updates
gui: 0
#
# Logs for mana updates
mana: 0
#
Worlds:
#
# Whether or not to enable the world restriction
enable: false
#
# Whether or not to use the list as an enabling list
# If true, only worlds in the list will let players use SkillAPI
# If false, any world not in the list will let players use SkillAPI
use-as-enabling: true
#
# The worlds to include in the enable/disable list
worlds:
- world

复制代码

三.语言文件
language.yml

# ---------------------------------------------- #
# 语言配置 #
# ---------------------------------------------- #
# 如果您不确定如何使用此文件, #
# 但是想要改变当前插件的配置文件 #
# 请查看Bukkit网页: #
# http://dev.bukkit.org/bukkit-plugins/skillapi/ #
# 并查看默认的配置文件 #
# ---------------------------------------------- #
Notifications:
cast: '&6{player} &2使用了 &6{skill}'
gain-exp: '&2你获得了 &6{exp} 点经验'
gain-lvl: '&6Level Up! &2当前&6等级为 {level}级'
lose-exp: '&4你的{class}经验下降了&6{exp}&4点'
Errors:
on-cooldown: '&6{skill} &4冷却中 - &6{cooldown} &4秒后才能使用'
no-mana: '&4魔力不足，缺少 &6{missing} &4点魔力'
no-skills: '&4这个职业没有技能'
cannot-use: '&4你不能使用这个物品'
GUI:
attribute-title: '属性({points}点)'
skill-tree: '职业:{class}'
skill-class-list: '职业列表:{player}'
Skill Tree:
title: '{name} ({level}/{max})'
type: '&2技能类型: &6{name}'
requirement:
met: '&2'
not-met: '&4'
attribute:
changing: '&6{value} -> {new}'
not-changing: '&6{value}'
layout:
- '&d{name} &7({level}/{max})'
- '&2类型: &6{type}'
- ''
- '{req:lvl}等级需求: {attr:level}'
- '{req:cost}升级消耗: {attr:cost}'
- ''
- '&2魔力值: {attr:mana}'
- '&2冷却时间: {attr:cooldown}'
- '&2范围: {attr:range}'
- ''
- '&2详细信息: &7{desc:1}'
- '&7{desc:2-x}'
Stats:
health: '&2生命值'
mana: '&2法力值'
points: '&2技能点'
level: '&2等级'
exp: '&2经验'
Status:
silenced: '&4你将在&6{duration}&4秒之内无法释放技能'
stunned: '&4你将在&6{duration} &4秒之内无法攻击'
rooted: '&4你将在&6{duration} &4秒之内无法移动'
disarmed: '&4你将在&6{duration} &4秒之内无法使用武器'
invincible: '&4该目标在&6{duration} &4秒之内处于无敌状态'
absorbed: '&4该目标在&6{duration} &4秒之内处于嗜血状态'
channeling: '&4你在&6{duration} &4秒之内处于吟唱状态'
Combo:
left: '&6左键'
right: '&6右键'
shift: '&6下蹲'

复制代码

二.职业篇

名称: 职业的显示名称，可以使用中文，不可使用颜色代码前缀: 显示在玩家名称前面的称号，可用中文，可用颜色代码群组: 群组，可以用来制作团队/种族等，部分技能可以设置只攻击不同群组或相同群组，比如法师与奥术法师都可以设定为法师群组，战士与狂战士都可以设置为战士职业。法力名称: 这个很好理解，奥术法师可以设置为奥术，元素法师可以设置为元素，战士可以设置为怒气，可以使用颜色代码最大等级: 这个职业最高可以升到多少级。父职业: 默认为None，如果你在左边框中:

拥有其他职业，那么你点击None就可以发现下面拥有你写的职业，只有当玩家拥有父职业中选择的职业后才能选择现在的职业。权限: 默认为False，当选择为True时，玩家必须拥有{skillapi.class.<职业名称>}权限才可以选择此职业。
经验来源: 顾名思义，就是玩家获得经验的方法，从上往下，分别为：击杀生物破坏方块（煤矿之类）放置方块合成使用指令特殊（不懂）经验瓶熔炼矿物之类任务插件大多数只有经验瓶会在config.yml中启用

生命值: 玩家血量，左侧为基础生命值，右侧为每级增加的生命值。
法力值: 玩家法力/魔力，左侧为基础法力值，右侧为每级增加的法力值。
下面的体质/灵巧/精神/活力我就不介绍了，关于他们的属性请前往WIKI查看。当然，如果你是自己创建属性的话当我没说QwQ

法力回复: 每秒回复的法力值。
技能树: 默认为Requirement,具体请前往Wiki查看，或等待额外篇更新。
技能: 当前职业所拥有的技能，一行填一个技能名称即可。
图标: 职业的显示图标，这个可以随意，按下子母键会自动为你挑选，比如你按下F键，会自动帮你找到Fireball。

图标数据: 用来表示图标的耐久/副数据，比如羊毛的副数据。
图标lore: 用来显示职业的介绍，可以随便填。

职业示例

设定:
名称: 奥术法师
前缀: &b奥&4|&a法师
群组: 法师
法力名称: &2奥术
最大等级: 40
父职业: 法师
权限: 开启
经验来源: 生物指令经验瓶任务
生命值: 10+10
法力值: 60+10
法力回复: 10
技能树: Requirement
技能: 奥术飞弹，奥术防御
图标: 书
图标数据: 0
图标Lore: 奥术法师

好了，职业篇到这里就结束了QwQ，有疑问的小伙伴可以回复询问哦~

三.技能篇

名称: 同职业，填写技能名称。
类型: 这个可以随便，只是来显示技能类型的，比如什么奥术防御，远程攻击，近程攻击都可以。
最大等级: 这个技能最多升到多少级。
父技能: 类似父职业，必须要学会父技能才能学当前技能
父技能等级: 将父技能升到指定登记才能学这个技能
权限: 默认为False，选择True时，必须玩家拥有{skillapi.skill.[技能名称]}这个权限才可以学习本技能
等级要求: 只有玩家职业等级到达要求才能学习此技能,左边为基础等级，右边为每级提升的等级
技能点: 玩家爱需要花费指定的技能点才能学习此技能，左边为基础技能点，右边为每级提升的技能点
冷却: 技能的冷却时间，单位为"秒"，左边为基础冷却时间，右边为每级提升的冷却
法力值: 技能释放消耗的法力值,左边为基础法力值，右边为每级提升的法力值
释放信息: 玩家施放技能时，在其周围的玩家都能接收到技能信息(是否开启，范围半径请到config.yml文件中修改)
组合键: 只对插件V3.0以下版本有效，当玩家按照指定规则按下 L R S组合成的四个按键即可释放技能， L为鼠标左键 R为鼠标右键 S为Shift，格式: L R S S
指示器: 用于预览的显示类型(不懂，没用过)
图标: 技能在技能树中显示的图标，按下你要选择的图标首字母，它会自动带你到他的位置。
图标数据: 显示图标的耐久/数据
图标Lore: 就是技能图标的标签，可修改。变量参考额外篇。
技能基础设置到这结束，开始技能效果设置。
在机能基础设置的左下角找到这个

，单击进入技能效果设置。

我们便进入到了这个界面，第一个:细节设置,用来查看上一个界面，第二个触发条件，这个便是技能的效果了，第三个保存，第四个删除
我们点击第二个触发条件，就会出现这个页面：

咳咳，暂时就写到这里了，具体请去看我和朋友汉化的Wiki以及中文版编辑器，里面都有介绍。
技能的用法我也会在之后慢慢写出

四.额外篇
指令(中文)

/class acc
使用者: 玩家
改变玩家当前的角色
/class bind
使用者: 玩家
绑定技能到手持物品
/class cast
使用者: 玩家
直接释放技能
/class clearbind
使用者: 玩家
清除手持物品上的技能绑定
/class exp [player]
使用者: 玩家，控制台
给予玩家[player]数量为经验
/class info [player]
使用者: 玩家，控制台
显示玩家[player]的详细信息
/class level [player]
使用者: 玩家，控制台
修改玩家[player] 数量为等级
/class list [player]
使用者: 玩家，控制台
显示玩家[player] 的主要职业与等级
/class mana [player]
使用者: 玩家，控制台
给予玩家[player] 数量为魔力值
/class options
使用者: 玩家
显示玩家可以选择的职业
/class points [player]
使用者: 玩家，控制台
给予玩家[player] 数量为技能点
/class profess
使用者: 玩家
加入这个职业
/class reload
使用者: 玩家，控制台
重载插件，当配置改变后会删除所有数据并重新加载
/class reset
使用者: 玩家
删除玩家活跃账户的数据并清除他们所有选择的职业
/class skill
使用者: 玩家
查看玩家的技能树
/class unbind
使用者: 玩家
取消物品与技能的绑定
/class forceaccount
使用者: 管理员
设定玩家的角色
/clasee forceattr [attr] [amount]
使用者: 管理员
强行更改玩家属性[attr]上升/下降指定数量[amount]
/class forcecast [level]
使用者: 管理员
强制玩家释放技能的等级[level]
/class forceprofess
使用者: 管理员
强制玩家加入职业
/class forcereset [accountId]
使用者: 管理员
强行重置玩家数据
/clasee scheme [list]
使用者: 管理员
观看/设置地图体系
注意:此指令需要前往默认设置中开启地图栏选项

复制代码

权限(中文)

示例（中文）
无