查看“ShadowLevels”的源代码

[[分类:娱乐]]

{{Plugin Infobox
|外文名     = ShadowLevels
|作者       = XiaoJianhao_awa
|最新版本   = 1.1
|前置插件   = ShadowCore , [可选]PlaceholderAPI
}}

==总览==
这是一个可以让你的服务器实现强大的等级系统,和等级奖励系统的插件

你可以用SL强大的自定义菜单功能和SC给予的强大事件格式写一个完全

属于你的奖励菜单,写一个属于的你的奖励系统。

===PAPI占位符===
* %shadowlevels_<等级系统>_exp% - 当前经验
* %shadowlevels_<等级系统>_level% - 当前等级
* %shadowlevels_<等级系统>_required-exps% - 下一级所需的经验
* %shadowlevels_<等级系统>_max-levels% - 最高级
* %shadowlevels_<等级系统>_isMax% - 是否满级
* %shadowlevels_<等级系统>_multiple% - 等级倍率
* %shadowlevels_<等级系统>_color% - 等级颜色
* %shadowlevels_<等级系统>_received-rewards-count% - 已领取的奖励数量
* %shadowlevels_<等级系统>_progressbar% - 进度条 (默认长度,  可在Config.yml中更改)
* %shadowlevels_<等级系统>_progressbar_<长度>% - 进度条

==自定义等级系统==

===如何创建一个等级系统===

在控制台输入/sl CreateLevelSystem <等级系统名>

也可以使用/sl cls <等级系统名>

等级将会自动载入

===编辑你的等级系统===

<small>路径ShadowLevels\Levels\####.yml</small>

等级的名称(请勿随意修改!)
<pre>Name: Global</pre>

此等级配置的最大等级上限
如果你的等级达到这个数值
那么将不会继续增长等级
<pre>Max-levels: 100</pre>

等级颜色设置, 表示0到9级颜色为'&7', 10级及以后为'&f'
<pre>
Colors:
  0: '&7'
  10: '&f'
</pre>

默认升级经验
<pre>Default-exps-to-level-up: 5000  </pre>

自定义升级经验 (原写法)

表示升到1,2,3,4,5级需要100经验，升到6,7,8,9,10级要1000经验，10级以后要默认经验
<pre>
Custom-exps-to-level-up:
  1: 100
  2: 100
  3: 100
  4: 100
  5: 100
  6: 1000
  7: 1000
  8: 1000
  9: 1000
  10: 1000
</pre>

在ShadowLevels v1.0中， 若无指定升级所需的经验， 则为默认升级经验！

例： 未指定到达第3级的经验， 则为默认经验
<pre>
Custom-exps-to-level-up:
  1: 100
  2: 100
  4: 100
  5: 100
</pre>

新写法(区间写法，仅限ShadowLevels v1.1及以后!)

代替上述原版写法
<pre>
Custom-exps-to-level-up:
  5: 100 #5级以前每升一级要100经验
  6: 1000 #从5级升到6级，需要1000经验
  11: 5000 #6级到11级(包括6级，不包括11级)每升一级要5000经验，11级及以后每升一级要5000经验
</pre>

==自定义奖励==

===如何创建一个奖励===

在控制台输入/sl CreateReward <奖励名> <所属等级系统名>

也可以使用/sl cr <奖励名> <所属等级系统名>

奖励将会自动载入 

===全局物品设置===

奖励菜单默认的物品设置，在Items.yml文件中可更改

若奖励菜单或奖励物品没有自定义奖励物品设置，则使用该配置中的物品(详见下文)

对照:

Previous-Page: 上一页

Next-Page: 下一页

Reward-Unlocked: 奖励（已解锁）

Reward-Locked:奖励（未解锁）

Reward-Received:奖励（已领取）

Reward-NoPermissions:奖励（无权领取）

%rewards%占位符: 每个奖励所包含的内容，需要在每个奖励下单独设置(详见下文)

===编辑你的奖励菜单===

奖励菜单所属的等级系统(请勿随意更改)
<pre>Level-System: Global</pre>

该奖励菜单的标题(默认为Rewards, 请自行修改)
<pre>Title: Rewards</pre>

该奖励菜单的大小(可自行修改, 必须是9的倍数，且不超过54)
<pre>Size: 54</pre>

自行为菜单添加物品(仅装饰)

Custom-Items中默认生成Custom-Border，作为默认奖励菜单的边框

<pre>
Custom-Items:
  Custom-Border:
    Name: '&7Border'
    Material: GRAY_STAINED_GLASS_PANE
</pre>

'''当然，在Custom-Items中我们也可以重写Previous-Page，Next-Page等Items.yml所配置好的物品'''

'''这样奖励菜单调用的将会是Custom-Items中的物品，而不是Items.yml中的物品 (仅在如果该奖励无Custom-Items时, 详见下文)'''

可自行添加一个物品，如下：

<pre>
Custom-Items:
  Custom-Item1:
    Name: '&9自定义物品1'
    Material: DIAMOND
    Lore:
    - '&b这是一颗钻石'
</pre>

然后到Item-Slots中， 填写位置

[[文件:自定义位置.png|无框]]

重载一下，打开菜单，就能看到物品了

===自定义奖励===

一个奖励的基本规范：

<pre>
"奖励名":
   Level: 所需的等级
   Page: 页数
   Slot: 位置
   Rewards: #%reward%所显示的东西
   - '&6Coins x100'
   #Permissions: #启用此项使用权限
   #- '权限'
   Events: #领取奖励后的事件
   - '@EventProperty world'
   - '[CONSOLE_COMMAND] bal give %player% 100'
</pre>

当然，我们也可以自定义当前奖励的物品

这里默认奖励菜单的第三个奖励就是个很好的例子

<pre>
   '3':
      Level: 3
      Page: 2
      Slot: 10
      Rewards:
      - '&6Coins x100'
      Events:
      - '@EventProperty world'
      - '[CONSOLE_COMMAND] bal give %player% 100'
      Custom-Items:
        Reward-Unlocked:
          Name: '&eReward 3★ &f| &aUnlocked'
          Lore:
          - ''
          - '&6Rewards:'
          - '%rewards%'
          - ''
          - '&aClick to claim!'
          Material: CHEST_MINECART
          Amount: 1
          Data: 0
          ItemFlags: HIDE_ENCHANTS
          Enchantments: 'PROTECTION_ENVIRONMENTAL : 1'
          Events:
          - '[msg] &aReceived successfully'
        Reward-Locked:
          Name: '&eReward 3★ &f| &cLocked'
          Lore:
          - ''
          - '&6Rewards:'
          - '%rewards%'
          - ''
          - '&cYou need more levels!'
          Material: CHEST_MINECART
          Amount: 1
          Data: 0
          Events:
          - '[msg] &cThis reward is locked!'
        Reward-Received:
          Name: '&eReward 3★ &f| &cReceived'
          Lore:
          - ''
          - '&6Rewards:'
          - '%rewards%'
          - ''
          - '&cYou''ve already received!'
          Material: MINECART
          Amount: 1
          Data: 0
          Events:
          - '[msg] &cYou''ve already received this reward!'
        Reward-NoPermissions:
          Name: '&eReward 3★ &f| &cLocked'
          Lore:
          - ''
          - '&6Rewards:'
          - '%rewards%'
          - ''
          - '&cYou don''t have permissions!'
          Material: CHEST_MINECART
          Amount: 1
          Data: 0
          Events:
          - '[msg] &cYou don''t have permissions to receive this reward!'
</pre>

我们可以看到, 该奖励所显示的物品， 全在该奖励下Custom-Items中被重写了！

'''如果一个奖励菜单，Custom-Items中重写了Items中的物品， 又有奖励的Custom-Items重写了Items中的物品， 则该奖励默认使用奖励设置中Custom-Items里的物品'''

至此，自定义奖励教程结束

==权限==

'''管理员'''
* ShadowLevels.Commands.SetMultiple - 使用sl mulitiple指令设置玩家经验倍率
* ShadowLevels.Commands.Admin - 使用sl admin指令
* ShadowLevels.Commands.Reload - 使用sl reload重载
* ShadowLevels.Commands.Reset - 使用sl reset重置玩家信息
* ShadowLevels.Commands.AddExps - 使用sl addexps给予玩家经验
* ShadowLevels.Commands.RemoveExps - 使用sl removeexps清除玩家经验
* ShadowLevels.Commands.SetExps - 使用sl setexps设置玩家经验
* ShadowLevels.Commands.AddLevels - 使用sl addlevels给予玩家等级
* ShadowLevels.Commands.RemoveLevels - 使用sl removelevels清除玩家等级
* ShadowLevels.Commands.SetLevels - 使用sl setlevels设置玩家等级
* ShadowLevels.Commands.OpenReward - 使用sl openreward给别人打开奖励菜单