查看“SunLight-Core”的源代码

[[Category:机械]]
<!--HEAD-->
    <div style="float:none;-webkit-border-image: none;color: #333;height: auto;margin: 0 0 35px 0;min-height: 20px;background-color: #f8f8f8;box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-webkit-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-moz-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);">
<!--标题-->
        <p style="color:#ffffff;font-size: 26px;text-align: center;margin:0; padding:14px;background-color: #3385ff;">
            欢迎来到SunLight-Core插件百科
        </p>
        <div style="float:none;-webkit-border-image: none;height: auto;line-height: 20px;background-color:#74c0ff;display:table;width:100%;color:#ffffff;">
 <!--内容-->
            <p style="float:none;font-size: 16px;text-align: center;padding:10px 0;display:table-cell;border-right:1px solid white;">
                <big>插件名<br>'''SunLight-Core</big>'''
            </p>
            <p style="float:none;font-size: 16px;text-align: center;padding:10px 0;display:table-cell;border-right:1px solid white;">
                <big>作者<br>'''NightExpress</big>'''
            </p>
            </p>
            <p style="float:none;font-size: 16px;text-align: center;padding:10px 0;display:table-cell;border-right:1px solid white;">
                <big>兼容版本<br>'''1.13-1.14</big>'''
            </p>
            <p style="float:none;font-size: 16px;text-align: center;padding:10px 0;display:table-cell;border-right:1px solid white;">
                <big>原文<br>'''[http://nexwiki.info/suncore/index.php nexwiki]</big>'''
            </p>
         </div>
    </div>
<div style="float:none;-webkit-border-image: none;color: #333;height: auto;line-height: 20px;margin: 35px 0 0 0;min-height: 20px;background-color: #f8f8f8;box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-webkit-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-moz-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);width:100%;">
        <!--标题-->
        <p style="color:#ffffff;font-size: 22px;text-align: center;margin:0; padding:16px;background-color: #3385ff;">介绍 {{·}} Introduction</p>
        <div style="padding:10px 20px;">
这是款轻量级的基础插件,包含了很多对于管理服务器很有用的功能. 插件分成多个模块，你可以随意关闭插件的任意模块.
        <!--标题-->
        <p style="color:#ffffff;font-size: 22px;text-align: center;margin:0; padding:16px;background-color: #3385ff;">模块 {{·}} Modules</p>
        <div style="padding:10px 20px;">
=模块=
==AFK==
===settings.yml===
 general:
   # 多久后玩家进入离开游戏状态
   # 需要权限: core.cmd.afk
   afk-time: 600
   # AFK多久后玩家会被踢出服务器. 设置为 -1 关闭.
   # 无视被踢的权限为: core.bypass.afk.kick
   kick-time: 1200
   # 检测间隔.
   check-interval: 5
   # 行为列表, 对进入/离开AFK模式的玩家执行.
   # 行为列表.
   enter-afk-actions: []
   exit-afk-actions: []
==Anti-Lagg==
这个模块添加了简单的优化系统来优化你的服务器性能和提升TPS.

当前特性:
'''实体限制''' - 限制每个区块的实体数.
===Settings.yml===
 entity-chink-limit:
   # 是否启用区域限制.
   enabled: true
   # 是否自动检测区块
   inspection-enabled: true
   # 检测间隔.
   inspection-frequency: 300
   # 每个区块的实体限制.
   limits:
     ANIMAL: 50
     MONSTER: 50
     NPC: 20
     AMBIENT: 10
     WATER: 20
     OTHER: 50

==椅子==
这个模块可以让玩家坐在半砖、台阶和地毯上.
<br />

=== '''指令和权限''' ===
{| class="wikitable"
!指令
!缩写
!描述
!是否只能由玩家使用
!权限
|-
|'''/chairs'''
| -
|切换座椅模式.
|是
|core.cmd.chairs
|}

==聊天==


这个模块可以让你管理聊天消息.

'''玩家聊天消息不支持JSON!'''

'''特性:'''

* '''防大写''' - 防止全大写英文消息.
* '''防刷屏''' - 防止消息和指令刷屏.
* '''加入和退出服务器的消息''' - 根据分组显示不同的加入和退出服务器的消息.
* '''死亡消息''' - 更改玩家死亡消息.
* '''物品展示''' - 在聊天框内展示你的物品.
* '''全服和本地聊天''' - 可配置聊天范围.
* '''管理员聊天''' - 管理员聊天频道.
* '''支持PlaceholderAPI.'''
* '''聊天规则和惩罚''' - 使用正则表达式检测聊天内容并进行惩罚!
* '''自动公告''' - 每隔一段时间发送公告. 支持 JSON.

=== '''Settings.yml''' ===
 anti-caps:
   # 是否启用防大写功能（对中文无效，译者已关闭该功能）
   enabled: false
   # 启用该功能的指令.
   in-commands:
   - me
   - broadcast
   - tell
   # 检测的最短消息长度
   min-length: 3
   # 多少百分比的大小字母会被改成小写.
   percentage: 70
   # 单词白名单
   whitelist:
   - OMG
   - LOL
   - WTF
   - WOW
   - ROFL
 
 anti-spam:
   # 聊天冷却.
   chat-delay: 3
   # 指令冷却.
   cmd-delay: 3
   # 检测的消息/指令相似度.
   percentage: 90
   # 指令白名单.
   whitelist:
   - 'tell'
   - 'spawn'
   - 'home'
   - 'sethome'
   - 'reply'
   - 'stats'
   - 'kit'
   - 'warp'
   
 join-and-quit:
   # 是否启用自定义进出游戏消息.
   enabled: true
   # 特定权限组的进出游戏消息.
   # 插件会自动检测权限组插件的分组.
   join-groups:
     Admins: '&7[&2+&7] &7管理员 &2%player% &7加入了游戏.'
   quit-groups:
     Admins: '&7[&4-&7] &7管理员 &4%player% &7离开了游戏.'
 
 item-link:
   # 是否启用在聊天内展示物品.
   enabled: true
   # 替换物品的变量.
   keyword: '@hand'
   # 物品名格式.
   format: '&7<&f%item%&7>&f'
 
 death-messages:
   # 是否启用自定义死亡信息.
   enabled: true
   # 指定死因的死亡消息列表.
   # 同一死因可添加多条消息.
   # 如果玩家死因不在列表内,则不会显示死亡信息.
   by-cause:
     LAVA:
     - '&7(&c☠&7) &c%player% &7尝试在岩浆里游泳.'
     BLOCK_EXPLOSION:
     - '&7(&c☠&7) &c%player% &7炸了!'
   # 同上，由实体造成的死亡.
   by-entity:
     PLAYER:
     - '&7(&c⚔&7) &c%damager% &7杀死了 &c%player%'
     ZOMBIE:
     - '&7(&c☠&7) &c%player%&7的脑子被僵尸吃了.'
 
 chat:
   format:
     # 占位符:
     # {player_prefix} - 玩家组前缀.
     # {player_suffix} - 玩家组后缀.
     # {name} - 玩家名.
     # {display_name} - 自定义玩家名 (来自 /nick 的昵称等).
     # {message} - 玩家消息.
     # 可以在这使用PlaceholderAPI! 请使用 {} 而不是 %.
     local: '&3[本地] &7{player_prefix}{display_name}{player_suffix}&f: {message}'
     global: '&6[全服] &7{player_prefix}{display_name}{player_suffix}&f: {message}'
     spy: '&c侦查&7 | {world} {name}&7: {message}'
     admin: '&7[&b管理员聊天&7] &7{player_prefix}{display_name}{player_suffix}&f: {message}'
     # Local chat range.
     range: 100.0
 
 # 聊天规则部分.
 rules:
   # 规则名
   swear:
     dick:
       # 正则表达式.
       # 可使用这个网站测试正则表达式: http://myregexp.com/
       match: '((D|d)+([^a-zA-ZА-Яа-я]|\s)*(i|I|1|!)+([^a-zA-ZА-Яа-я]|\s)*(c|C)+([^a-zA-ZА-Яа-я]|\s)*(k|K)+([^a-zA-ZА-Яа-я]|\s)*)'
       # 检测行为.
       # 可用:
       # REPLACE - 替换脏话.
       # REPLACE_FULL - 替换整条消息/指令.
       # DENY - 取消消息/指令.
       action: REPLACE
       # 替换后的消息.
       replace-with: '***'
       # 无视规则的单词.
       # 可用于好话里的脏话.
       ignore-strings:
       - 'dickon'
     shit:
       match: '((s|S|$)+([^a-zA-ZА-Яа-я]|\s)*(h|H)+([^a-zA-ZА-Яа-я]|\s)*(i|I|1|!)+([^a-zA-ZА-Яа-я]|\s)*(T|t|7)+([^a-zA-ZА-Яа-я]|\s)*)'
       action: REPLACE_FULL
       replace-with: '这服真好玩!'
       ignore-strings: []
   adv:
     ips:
       match: '\b[0-9]{1,3}(\.|dot|\(dot\)|-|;|:|,|(\W|\d|_)*\s)+[0-9]{1,3}(\.|dot|\(dot\)|-|;|:|,|(\W|\d|_)*\s)+[0-9]{1,3}(\.|dot|\(dot\)|-|;|:|,|(\W|\d|_)*\s)+[0-9]{1,3}\b'
       action: DENY
       replace-with: '***'
       ignore-strings:
       - '127.0.0.1'
     domain:
       match: '[a-zA-Z0-9\-\.]+\s?(\.|dot|\(dot\)|-|;|:|,)\s?(com|org|net|cz|co|uk|sk|biz|mobi|xxx|eu|me|io|ru|su|tk|ua)\b'
       action: DENY
       replace-with: '***'
       ignore-strings:
       - 'yandex.ru'
       - 'google.com'
       - 'spigotmc.org'
 
 # 惩罚措施
 rules-punish:
   # 上面的规则名.
   swear:
     # 发送消息
     message: '&c聊天 &4║ &f你的消息被更改了，原因: &c粗鄙之语&f.'
     # 执行指令. 留空关闭.
     command: 'warn %player% 禁止粗鄙之语'
   adv:
     message: '&c聊天 &4║ &f你的消息被取消发送了，原因: &c打广告&f.'
     command: ''
 
 # 自动公告
 announcer:
   # 间隔
   time: 180
   # 消息列表. 使用 /n 来换行.
   list:
   - '/n &6» &e查看插件百科:&6 {json: hint=&b点击前往!; url=http://mineplugin.org/SunLight-Core}[戳我]{end-json} /n '
   - '/n &6» &e支持 JSON 消息:&a {json: hint=&b你好, %player%!}[这是个按钮]{end-json} /n '

=== '''指令和权限''' ===
'''权限列表:'''

* '''core.chat.color''' - 允许在聊天消息内使用颜色代码.
* '''core.chat.spy''' - 允许查看本地聊天.
* '''core.chat.admin''' - 允许查看和使用管理员聊天.
* '''core.bypass.chat.delay.msg''' - 忽略聊天冷却.
* '''core.bypass.chat.delay.cmd''' - 忽略指令冷却.
* '''core.bypass.chat.caps''' - 忽略防大写检测.
* '''core.bypass.chat.spam''' - 忽略复读检测.
* '''core.bypass.chat.rules''' - 忽略聊天规则检测.

{| class="wikitable"
!指令
!缩写
!描述
!是否只能由玩家使用
!权限
|-
|'''/adminchat'''
| -
|切换管理员聊天模式
|是
|core.chat.admin
|}

==经济==
'''这一模块需要安装Vault!'''

'''特点:'''

* '''支持离线玩家''' - 设置/给予/拿走 离线玩家的金钱.

=== '''Settings.yml''' ===
 <code># /baltop更新间隔
 '''baltop-update:''' '''15'''
 '''currency:'''
   # 货币符号
   '''symbol:''' '''<nowiki/>'$''''
   # 新玩家拥有的钱
   '''start-balance:''' '''100.0'''</code>

=== 指令和权限 ===
{| class="wikitable"
!指令
!缩写
!描述
!是否只能由玩家使用
!权限
|-
|'''/balance (player)'''
|/bal, /money, /cash
|查看玩家有多少钱
|否
|core.eco.balance
|-
|'''/balancetop (page)'''
|/baltop, /moneytop
|金钱排行榜
|否
|core.eco.balancetop
|-
|'''/pay [player] [amount]'''
| -
|支付给玩家金钱
|是
|core.eco.pay
|-
|'''/eco give [player] [amount]'''
|/economy give
|给予玩家金钱
|否
|core.eco + core.eco.give
|-
|'''/eco take [player] [amount]'''
|/economy take
|拿走玩家的钱
|否
|core.eco + core.eco.take
|-
|'''/eco set [player] [amount]'''
|/economy give
|设置玩家的金钱
|否
|core.eco + core.eco.set
|}

==补丁==
这个模块修复了一些漏洞.

'''特点:'''

* '''Fishing Farm''' - 防止挂机钓鱼.
* '''Bed GUI''' - 防止在床上时打开菜单.
* '''Ender Farm''' - 防止使用末影螨建造小黑塔.
* '''IP Limit''' - 限制同一IP加入的玩家上限.
* '''Creative Limiter''' - 防止玩家从创造模式中拿取物品.

=== '''Settings.yml''' ===
 <code>'''patcher:'''
   # 防钓鱼农场
   '''fishing:''' '''true'''
   # 防止在床上时打开菜单
   '''bed-gui:''' '''true'''
   #  防止使用末影螨建造小黑塔
   '''ender-farm:''' '''true'''
   # 限制同一IP加入的玩家上限.
   '''limit-ip:''' '''true'''
   # 防止玩家从创造模式中拿取物品.
   '''limit-creative:''' '''true'''
 
 '''limit-creative:'''
   # 创造模式限制的物品.
   '''item-blacklist:'''
   '''-''' '''SPLASH_POTION'''
   '''-''' '''TNT'''
   '''-''' '''EXPERIENCE_BOTTLE'''
   '''-''' '''TRIDENT'''
   '''-''' '''LINGERING_POTION'''
   '''-''' '''ENDER_EYE'''
   '''-''' '''BEDROCK'''
   '''-''' '''END_PORTAL_FRAME'''
   '''-''' '''ITEM_FRAME'''
   '''-''' '''WITHER_SKELETON_SKULL'''
   # 创造模式指令黑名单
   '''cmd-blacklist:'''
   '''-''' '''<nowiki/>'auc''''
   '''-''' '''<nowiki/>'ah'<nowiki/>'''</code>

=== 权限列表 ===

* '''core.bypass.creative''' - 忽略创造限制.

==菜单==
这个模块可以让你创建自定义菜单.

'''特点:'''

* '''菜单指令''' - 每个菜单可使用不同的指令打开.
* '''权限''' - 每个菜单可需要不同的权限才能打开.
* '''显示条件''' - 根据条件显示或隐藏指定的菜单物品.
* '''点击条件''' - 满足条件才能点击物品.
* '''点击类型''' - 5种不同的点击类型.
* '''点击行为''' - 自定义的点击物品触发行为.
* '''支持PlaceholderAPI.'''

=== '''Settings.yml''' ===
暂无 :/ 请查看下面的菜单配置
 

=== 菜单配置 ===
在模块文件夹你可以找到 '''/gui/''' 子文件夹. 所有菜单都在这个文件夹内.

想要创建新的菜单你只需复制已有菜单文件并进行修改即可.
 <code># 菜单标题
 '''title:''' '''<nowiki/>'&8[&2SunLight GUI&8]''''
 # 菜单尺寸. 可用数值: '''9/18/27/36/45/54'''
 '''size:''' '''54'''
 # 是否需要权限打开菜单?
 # 权限为 '''core.gui.[id]''' ，[id] 为文件名.
 '''need-permission:''' '''false'''
 # 菜单指令缩写
 '''aliases:'''
 '''-''' '''<nowiki/>'menu''''
 '''-''' '''<nowiki/>'servermenu''''
 # 菜单物品
 '''content:'''
   '''rank-item:'''
     # 物品显示设置.
     # '''提醒: 显示顺序很重要'''! 位于下方的物品优先度更高.
     '''display:'''
       # '''default''' 为常时显示, 但你可以删除这个来使其在满足条件后显示.
       '''default:'''
         # 物品材料名. 
         # 格式: '''Material:Data:Amount'''
         '''material:''' '''<nowiki/>'COAL:0:1''''
         # 物品名
         # 支持 '''PlaceholderAPI'''
         '''name:''' '''<nowiki/>'&7[&8Coal&7]''''
         # 物品描述
         # 支持 '''PlaceholderAPI'''
         '''lore:'''
         '''-''' '''<nowiki/>'&7默认所有人都看得见的物品''''
         '''-''' '''<nowiki/>'&7玩家不需要满足条件就看得见.''''
         # 头的皮肤.
         # 你可以使用 '''%player%''' 代表使用者.
         '''skull:'''
           '''hash:''' '''<nowiki>''</nowiki>'''
           '''owner:''' '''<nowiki>''</nowiki>'''
         # 附魔光效
         '''enchanted:''' '''true'''
         # 隐藏物品的所有属性.
         '''hide-flags:''' '''true'''
         # 设置药水的药水效果.
         '''potion-effect:''' '''<nowiki/>'JUMP''''
         # 设置皮革装备的RGB颜色.
         '''leather-color:''' '''<nowiki/>'255,255,255''''
         # 设置显示物品的条件.
         # '''条件列表'''.
         '''conditions:'''
         '''-''' '''<nowiki/>'[PERMISSION] core.gui.user''''
       '''vip:'''
         '''material:''' '''<nowiki/>'GOLD_INGOT:0:1''''
         '''name:''' '''<nowiki/>'&7[&eGold&7]''''
         '''lore:'''
         '''-''' '''<nowiki/>'&7这件物品只有拥有ecore.gui.vip权限的玩家看得到''''
         '''skull:'''
           '''hash:''' '''<nowiki>''</nowiki>'''
           '''owner:''' '''<nowiki>''</nowiki>'''
         '''enchanted:''' '''true'''
         '''hide-flags:''' '''true'''
         '''potion-effect:''' '''<nowiki/>'JUMP''''
         '''leather-color:''' '''<nowiki/>'255,255,255''''
         '''conditions:'''
         '''-''' '''<nowiki/>'[PERMISSION] core.gui.vip''''
       '''emerald:'''
         '''material:''' '''<nowiki/>'EMERALD:0:1''''
         '''name:''' '''<nowiki/>'&7[&aEmerald&7]''''
         '''lore:'''
         '''-''' '''<nowiki/>'&7这件物品只一拥有&acore.gui.emerald权限的玩家看得到''''
         '''-''' '''<nowiki/>'&7''''
         '''-''' '''<nowiki/>'&7越往下的物品优先度越高,''''
         '''-''' '''<nowiki/>'&7拥有 &acore.gui.vip &7和 &acore.gui.emerald权限的玩家''''
         '''-''' '''<nowiki/>'&7只看得到绿宝石.''''
         '''skull:'''
           '''hash:''' '''<nowiki>''</nowiki>'''
           '''owner:''' '''<nowiki>''</nowiki>'''
         '''enchanted:''' '''true'''
         '''hide-flags:''' '''true'''
         '''potion-effect:''' '''<nowiki/>'JUMP''''
         '''leather-color:''' '''<nowiki/>'255,255,255''''
         '''conditions:'''
         '''-''' '''<nowiki/>'[PERMISSION] core.gui.emerald''''
     # 物品格子序数.
     # 可用逗号分隔多个位置.
     '''slots:''' '''<nowiki/>'20,22,24''''
     # 物品点击行为.
     '''clicks:'''
       # 点击类型.
       # 可用类型:
       # '''- LEFT'''
       # '''- RIGHT'''
       # '''- MIDDLE'''
       # '''- SHIFT_LEFT'''
       # '''- SHIFT_RIGHT'''
       '''LEFT:'''
         # 点击条件.
         # '''条件列表'''.
         '''conditions:''' '''[]'''
         # 点击触发行为.
         # '''行为列表'''.
         '''actions:'''
         '''-''' '''<nowiki/>'[MESSAGE] &请左击!''''
         # 发送给不满足条件的玩家的消息.
         # 留空则不显示.
         '''fail-message:''' '''<nowiki/>'你必须满足条件!''''
       '''RIGHT:'''
         '''conditions:''' '''[]'''
         '''actions:'''
         '''-''' '''<nowiki/>'[MESSAGE] &e请右击!''''
         '''fail-message:''' '''<nowiki/>'你必须满足条件!''''
       '''MIDDLE:'''
         '''conditions:''' '''[]'''
         '''actions:'''
         '''-''' '''<nowiki/>'[MESSAGE] &e请使用鼠标中键!''''
         '''fail-message:''' '''<nowiki/>'你必须满足条件!''''
       '''SHIFT_LEFT:'''
         '''conditions:''' '''[]'''
         '''actions:'''
         '''-''' '''<nowiki/>'[MESSAGE] &e请Shift+左击!''''
         '''fail-message:''' '''<nowiki/>'你必须满足条件!''''
       '''SHIFT_RIGHT:'''
         '''conditions:''' '''[]'''
         '''actions:'''
         '''-''' '''<nowiki/>'[MESSAGE] &e请Shift+右击!''''
         '''fail-message:''' '''<nowiki/>'你必须满足条件!'<nowiki/>'''</code>

=== 指令和权限 ===
'''权限列表:'''

* '''core.gui.[id]''' - 允许打开指定'''[id]''' 的菜单.

{| class="wikitable"
!指令
!缩写
!描述
!是否只能由玩家使用
!权限
|-
|'''/gui [id]/gui [id] [player]'''
| -
|忽略权限强制玩家打开指定菜单.
|是
否
|core.cmd.gui
core.cmd.gui.others
|}

==家==
这个模块可以让玩家设置家和传送回家.

'''特点:'''

* '''不同权限不同家上限''' - 不同权限组的玩家的家上限不同.
* '''世界黑名单''' -防止玩家在特定的世界设置家.
* '''在家里重生''' - 玩家死亡后可以在家里重生.

=== '''Settings.yml''' ===
 <code># 是否在设置的家重生.
 '''respawn-at-home:''' '''true'''
 # 玩家无法设置家的世界.
 '''world-blacklist:'''
 '''-''' '''events'''
 '''-''' '''spawn'''
 # 不同权限组可拥有的家上限.
 # 插件自动检测权限组插件.
 '''homes-by-rank:'''
   '''VIP:''' '''2'''
   '''Gold:''' '''3'''</code>

=== '''指令和权限''' ===
{| class="wikitable"
!指令
!缩写
!描述
!是否只能由玩家使用
!权限
|-
|'''/home (home)/home (player) (home)'''
| -
|传送玩家回家
|是
|core.cmd.home
core.cmd.home.others
|-
|'''/homes/homes (player)'''
| -
|列出玩家的家
|是
否
|core.cmd.homes
core.cmd.homes.others
|-
|'''/sethome (home)'''
| -
|设置家
|是
|core.cmd.sethome
|-
|'''/delhome (home)/delhome (player) (home)'''
| -
|拆家
|是
|core.cmd.delhome
core.cmd.delhome.others
|}

==礼包==
这个模块提供了简易的礼包功能.

'''特点:'''

* '''礼包菜单''' - 用菜单来查看和获取礼包.
* '''礼包JSON列表''' - 可在聊天框内点击领取礼包.
* '''自定义物品''' - 支持任何自定义物品.
* '''菜单编辑器''' - 通过菜单编辑器创建和管理礼包.
* '''礼包预览菜单''' - 通过菜单预览礼包内容.
* '''礼包权限''' - 设置获取礼包所需权限.
* '''礼包指令''' - 设置获取礼包时执行的指令.
* '''礼包价格''' - 设置获取礼包所需费用.
* '''礼包冷却''' - 设置礼包冷却.

=== '''Settings.yml''' ===
 <code>'''general:'''
   # 是否使用礼包菜单.
   # 设置为 '''false''' 则只在聊天框内显示.
   '''use-gui:''' '''false'''
   # 礼包图标描述.
   # 占位符:
   # '''- %cost%''' - 礼包费用
   # '''- %access%''' - 显示是否可以领取该礼包
   # '''- %cd%''' - 显示礼包冷却.
   # '''- %cd_left%''' - 显示剩余冷却时间.
   # '''- %lore%''' - 礼包图标描述.
   '''kit-lore:'''
   '''-''' '''<nowiki/>'&8&m                              ''''
   '''-''' '''<nowiki/>'&7» &f价格: &a%cost%''''
   '''-''' '''<nowiki/>'&7» &f是否可领取: &f%access%''''
   '''-''' '''<nowiki/>'&7» &f冷却时间: &6%cd%''''
   '''-''' '''<nowiki/>'&7» &f剩余冷却时间: &c%cd_left%''''
   '''-''' '''<nowiki/>'&8&m                              ''''
   '''-''' '''<nowiki/>'%lore%''''
 '''gui:'''
   # 选择礼包菜单
   # 菜单格式请看这里
   '''select:'''
     '''title:''' '''<nowiki/>'&l礼包''''
     '''size:''' '''54'''
     '''pages:''' '''1'''
     # 你的自定义物品
     '''content:'''
       '''filler:'''
         '''material:''' '''<nowiki/>'BLACK_STAINED_GLASS_PANE''''
         '''name:''' '''<nowiki>''</nowiki>'''
         '''lore:''' '''[]'''
         '''slots:''' '''45,46,47,48,49,50,51,52,53'''
   # 礼包预览菜单
   '''preview:'''
     '''title:''' '''<nowiki/>'&l预览礼包''''
     '''size:''' '''54'''
     # 显示礼包物品的格子.
     '''item-slots:''' '''45,2,3,4,5,6,7,8,11,12,13,14,15,16,17,20,21,22,23,24,25,26,29,30,31,32,33,34,35,38,39,40,41,42,43,44'''
     # 关闭礼包装备的格子.
     '''armor-slots:'''
       '''HELMET:''' '''0'''
       '''CHESTPLATE:''' '''9'''
       '''LEGGINGS:''' '''18'''
       '''BOOTS:''' '''27'''
       '''OFF_HAND:''' '''36'''
     # 你的自定义物品.
     '''content:'''
       '''filler:'''
         '''material:''' '''<nowiki/>'BLACK_STAINED_GLASS_PANE''''
         '''name:''' '''<nowiki>''</nowiki>'''
         '''lore:''' '''[]'''
         '''slots:''' '''1,10,19,28,37,46,47,48,49,50,51,52,53'''</code>

=== '''指令和权限''' ===
'''权限列表:'''

* '''core.kit.[id]''' - 允许使用指定id的礼包，id为玩家名.
* '''core.bypass.kit''' - 忽略礼包价格和冷却.

{| class="wikitable"
!指令
!缩写
!描述
!是否只能由玩家使用
!权限
|-
|'''/kit'''
|/kits
|显示礼包列表.
|是
|core.cmd.kit
|-
|'''/kit [kit]/kit [kit] [player]'''
|/kits
|领取或给予玩家礼包
|是
否
|core.cmd.kit
core.cmd.kit.others
|-
|'''/kit editor'''
|/kits
|打开礼包编辑器菜单.
|是
|core.cmd.kit.editor
|-
|'''/kit preview [kit]'''
|/kits
|打开礼包预览菜单.
|是
|core.cmd.kit
|}

==随机传送==
这个模块可以让玩家使用随机传送

'''特点:'''

* '''多世界''' - 可在不同世界启用或关闭随机传送.
* '''方块黑名单''' - 玩家不会传送到这些方块上.
* '''传送动画''' - 地点搜索进度动画.

=== '''Settings.yml''' ===
 
 <code># 设置默认世界.
 # 玩家可在这个世界内使用随机传送
 # 默认输入/rtp在此世界随机传送.
 '''default-world:''' '''world'''
 # 强制传送玩家到默认世界.
 # 设置为 '''false'''时在其他世界使用/rtp 会被取消传送.
 '''force-to-default:''' '''false'''
 # 最大搜索尝试次数.
 '''max-attempts:''' '''5'''
 # 玩家不会传送到的方块上.
 '''block-blacklist:'''
 '''-''' '''LAVA'''
 '''-''' '''WATER'''
 # 随机传送范围.
 '''worlds:'''
   '''world:'''
     '''x1:''' '''-5000'''
     '''x2:''' '''5000'''
     '''z1:''' '''-5000'''
     '''z2:''' '''5000'''</code>
 

=== '''指令和权限''' ===
{| class="wikitable"
!指令
!缩写
!描述
!是否只能由玩家使用
!权限
|-
|'''/rtp'''
| -
|Random teleport.
|是
|core.cmd.rtp
|}

==计分版==
这个模块提供了简易的计分版功能.

'''需要安装ProtocolLib和PlaceholderAPI!'''

'''特点:'''

* '''动态显示''' - 在计分版显示动态文本.
* '''轻量''' - 占用很少服务器资源.

=== '''Settings.yml''' ===
 <code>'''board:'''
   # 更新间隔.
   # 20刻 = 1 秒
   '''update-interval:''' '''20'''
   # 计分版标题
   '''title:''' '''<nowiki/>'&e&l服务器名''''
   # 计分版内容
   '''lines:'''
   '''-''' '''<nowiki/>'&c┃┃ &f内存: &c%server_ram_max% MB''''
   '''-''' '''<nowiki/>'&c┃┃ &f在线玩家: &c%server_online%''''
   '''-''' '''<nowiki/>'&c┃┃ &f时间: &c%server_time_kk:mm:ss%''''
   '''-''' '''<nowiki>''</nowiki>'''
   '''-''' '''<nowiki/>'&e┃┃ &f称号: &e%vault_prefix%''''
   '''-''' '''<nowiki/>'&e┃┃ &f金钱: &e%vault_eco_balance_formatted%''''
   '''-''' '''<nowiki/>'&e┃┃ &f位置: &e%player_x%&7, &e%player_y%&7, &e%player_z%''''
   '''-''' '''<nowiki>''</nowiki>'''
   '''-''' '''<nowiki/>'&a┃┃ &f击杀: &a%statistic_player_kills%''''
   '''-''' '''<nowiki/>'&a┃┃ &f死亡: &a%statistic_deaths%''''
   '''-''' '''<nowiki/>'&a┃┃ &f在线时间: &a%statistic_days_played%''''
   '''-''' '''<nowiki>''</nowiki>'''
   '''-''' '''<nowiki/>'&bplay.servermc.com'<nowiki/>'''</code>

=== '''指令和权限''' ===
{| class="wikitable"
!指令
!缩写
!描述
!是否只能由玩家使用
!前置
|-
|'''/board'''
|/scoreboard
|开关计分版显示
|是
|core.cmd.scoreboard
|}

==TAB==
==地标==
==欢迎消息==
==多世界管理==
=配置=
=指令和权限=
'''所有权限:'''

* '''core.bypass.afk.kick''' - 挂机不会被自动踢出服务器.
* '''core.bypass.nick''' - 跳过 /nick 昵称限制.
* '''core.bypass.gm''' - 忽略游戏模式控制.
* '''core.bypass.fly''' - 忽略飞行控制.
* '''core.bypass.kit''' - 忽略礼包冷却和花费.
* '''core.bypass.creative''' - 忽略创造限制.
* '''core.bypass.warp.cost''' - 忽略传送费用.
* '''core.bypass.chat.delay.msg''' - 忽略聊天冷却.
* '''core.bypass.chat.delay.cmd''' - 忽略指令冷却.
* '''core.bypass.chat.caps''' - 忽略聊天防大写.
* '''core.bypass.chat.spam''' - 忽略聊天内容相似度检测.
* '''core.bypass.chat.rules''' - 忽略聊天规则检测.
* '''core.bypass.vanish.see''' - 可以看到隐身的玩家.
* '''core.bypass.command.cooldown''' - 忽略所有指令的冷却.
* '''core.admin''' - 管理员权限.
* '''core.save.level''' - 死亡保留经验值.
* '''core.save.items''' - 死亡保留物品.

'''仅限玩家'''意味着只能通过玩家在游戏内执行.

'''[]''' - 为必须, '''()''' - 为可选.
{| class="wikitable"
!指令
!缩写
!描述
!仅限玩家
!权限
|-
|'''/air [amount]/air [amount] (player)'''
| -
|更改空气等级.
|是
否
|core.cmd.air
core.cmd.air.others
|-
|'''/anvil/anvil (player)'''
| -
|打开铁砧.
|是
否
|core.cmd.anvil
core.cmd.anvil.others
|-
|'''/armor [player]'''
| -
|查看和更换玩家的装备.
|是
|core.cmd.armor
|-
|'''/back/back [player]'''
| -
|传送回上一个地方.
|是
否
|core.cmd.back
core.cmd.back.others
|-
|'''/broadcast [text]'''
|/bc
|广播消息.
|否
|core.cmd.broadcast
|-
|'''/burn [player] [time]'''
|/ignite
|点燃玩家.
|否
|core.cmd.burn
|-
|'''/clearchat'''
|/cchat
|Clears chat.
|否
|core.cmd.clearchat
|-
|'''/clearinventory/clearinventory (player)'''
|/clearinv, /clear, /ci
|清空玩家背包(包括装备)
|是
否
|core.cmd.clearinventory
core.cmd.clearinventory.others
|-
|'''/core'''
|/sl, /sunlight
|插件主指令.
|否
|core.cmd.admin
|-
|'''/delspawn (spawn)'''
|/deletespawn
|删除特定的(或默认的)传送点.
|否
|core.cmd.delspawn
|-
|'''/enchant [enchant] [level]'''
|/ench
|附魔或驱魔你手中物品.
|是
|core.cmd.enchant
|-
|'''/enchanting'''
| -
|打开附魔台.
|是
|core.cmd.enchanting
|-
|'''/enderchest/enderchest (player)'''
|/echest, /ec
|打开末影箱.
|是
|core.cmd.enderchest
core.cmd.enderchest.others
|-
|'''/exp [set/give] [amount]/exp [set/give] [player] [amount]'''
|/xp
|修改玩家的经验值.
|是
否
|core.cmd.exp
core.cmd.exp.others
|-
|'''/extinguish/extinguish (player)'''
|/ext
|熄灭玩家身上的火焰.
|是
否
|core.cmd.ext
core.cmd.ext.others
|-
|'''/feed/feed (player)'''
| -
|恢复玩家的饥饿度.
|是
否
|core.cmd.feed
core.cmd.feed.others
|-
|'''/fly (0/1)/fly (0/1) (player)'''
| -
|切换飞行模式.
|是
否
|core.cmd.fly
core.cmd.fly.others
|-
|'''/gm (0/1/2/3)/gm (0/1/2/3) (player)'''
|/gamemode, /gmc, /gms, /gma
|更改玩家的游戏模式.
|是
否
|core.cmd.gamemode
core.cmd.gamemode.survival
core.cmd.gamemode.creative
core.cmd.gamemode.adventure
core.cmd.gamemode.spectator
core.cmd.gamemode.others
|-
|'''/give [material] (amount)/give (player) [material] (amount)'''
|/item, /i
|给予玩家物品.
|是
否
|core.cmd.give
|-
|'''/god (0/1)/god (0/1) (player)'''
| -
|切换玩家的上帝模式.
|是
否
|core.cmd.god
core.cmd.god.others
|-
|'''/hat'''
| -
|戴帽子.
|是
|core.cmd.hat
|-
|'''/heal/heal (player)'''
| -
|治疗玩家.
|是
否
|core.cmd.heal
core.cmd.heal.others
|-
|'''/ignore [player]'''
| -
|屏蔽玩家.
|是
|core.cmd.ignore
|-
|'''/invsee [player]'''
|/inv
|查看玩家背包.
|是
|core.cmd.inv
core.cmd.inv.others
|-
|'''/itemname [name]'''
|/rename
|重命名手中物品.
|是
|core.cmd.itemname
|-
|'''/list'''
|/online, /players
|显示在线玩家.
|否
|core.cmd.list
|-
|'''/me [action]'''
| -
|在聊天内执行行为.
|是
|core.cmd.me
|-
|'''/mobkill [type]'''
|/killmob
|击杀附近的实体.
|是
|core.cmd.mobkill
|-
|'''/more'''
| -
|增加物品堆叠数至64.
|是
|core.cmd.more
|-
|'''/near (radius)'''
|/nearby
|显示附近的玩家.
|是
|core.cmd.near
|-
|'''/nick (nick)/nick [player] [nick]'''
|/name, /nickname
|修改玩家昵称.
|是
否
|core.cmd.nick
core.cmd.nick.others
|-
|'''/nophantom/nophantom [player]'''
|/antiphantom
|关闭玩家附近的幻翼生成.
|是
否
|core.cmd.nophantom
core.cmd.nophantom.others
|-
|'''/playerinfo [player]'''
|/pinfo
|显示玩家信息. 支持 '''PlaceholderAPI'''.
|否
|core.cmd.playerinfo
|-
|'''/powetool [command]'''
|/pt, /itemcmd
|给手中物品添加指令.
|是
|core.cmd.powetool
|-
|'''/repair (all)'''
|/fix
|修复手中或背包内的物品.
|是
|core.cmd.repair
|-
|'''/reply [text]'''
|/r
|回复玩家的私聊.
|是
|core.cmd.reply
|-
|'''/seen [player]'''
| -
|查看玩家最后在线时间.
|否
|core.cmd.seen
|-
|'''/setspawn (spawn)'''
| -
|设置传送点.
|是
|core.cmd.setspawn
|-
|'''/skull [player]'''
|/head
|获得玩家头颅.
|是
|core.cmd.skull
|-
|'''/sms [player] [text]'''
|/tell, /t, /m, /msg, /message, /w, /whisper, /pm
|发送私聊消息给其他玩家.
|否
|core.cmd.tell
|-
|'''/socialspy (0/1)/socialspy (0/1) (player)'''
| -
|切换侦查私聊模式.
|是
否
|core.cmd.socialspy
core.cmd.socialspy.others
|-
|'''/spawn (spawn)/spawn [player] (spawn)'''
| -
|强制玩家传送到传送点.
|是
否
|core.cmd.spawn
core.cmd.spawn.others
|-
|'''/spawner [type]'''
| -
|更改刷怪笼实体类型.
|是
|core.cmd.spawner
core.cmd.spawner.[type]
|-
|'''/spawnmob [type] [amount]'''
|/mob
|刷怪.
|是
|core.cmd.spawnmob
core.cmd.spawnmob.[type]
|-
|'''/speed (amount)/speed (amount) (player)'''
| -
|更改玩家速度.
|是
否
|core.cmd.speed
core.cmd.speed.others
|-
|'''/sudo [player] [command]/sudo [player] c:[text]'''
| -
|强制玩家执行指令或发送聊天消息.
|是
否
|core.cmd.sudo
|-
|'''/suicide'''
|/killme, /killmeplease
|自杀.
|是
|core.cmd.suicide
|-
|'''/summon [player]'''
|/s
|传送玩家到你身边(相当于Essentials的/tphere).
|是
|core.cmd.summon
|-
|'''/system'''
|/tps, /gc, /mem
|系统信息.
|否
|core.cmd.system
|-
|'''/thunder/thunder (player)'''
|/smite
|雷击玩家或你看着的方块.
|是
否
|core.cmd.thunder
core.cmd.thunder.others
|-
|'''/top/top (player)'''
|/up
|Teleport to the highest block above you.
|是
否
|core.cmd.top
core.cmd.top.others
|-
|'''/tpaccept/tpaccept (player)'''
| -
|Accepts teleport request.
|是
|core.cmd.tpaccept
|-
|'''/tpa [player]'''
|/call
|Send teleport request.
|是
|core.cmd.tpa
|-
|'''/tp [player]/tp [who] [to]'''
| -
|Teleports to player or teleport one player to another.
|是
否
|core.cmd.tp
core.cmd.tp.others
|-
|'''/tpdeny/tpdeny [player]'''
| -
|Declines teleport request.
|是
否
|core.cmd.tpdeny
core.cmd.tpdeny.others
|-
|'''/tppos [x] [y] [z]/tppos [x] [y] [z] [player]'''
| -
|Teleport to specified coordinates.
|是
否
|core.cmd.tppos
core.cmd.tppos.others
|-
|'''/tptoggle'''
| -
|Toggle teleport requests.
|是
否
|core.cmd.tptoggle
|-
|'''/unignore [player]'''
| -
|Removes player from ignore list.
|是
否
|core.cmd.unignore
|-
|'''/vanish/vanish [player]'''
|/v
|Toggle vanish mode.
|是
否
|core.cmd.vanish
core.cmd.vanish.others
|-
|'''/workbench'''
|/wb
|打开工作台.
|是
|core.cmd.workbench
|}

=实用功能=
<br />

== '''自定义行为''' ==
这些行为可用于插件的部分模块, 特别是是菜单.

支持在这里使用'''PlaceholderAPI'''!

'''配置行为格式:'''
 <code>'''actions:'''
 '''-''' '''<nowiki/>'[ACTION] ARGUMENTS [CHANCE]''''
 '''行为:'''
 '''-''' '''<nowiki/>'[PLAYER_COMMAND] rules %25.0'<nowiki/>''' # Force player to execute /rules command with 25% chance.</code>
'''Action chance:'''

To make the action have a chance to execute, add '''%NUM''' at the end of action. Where '''NUM''' is chance decimal.

'''行为类型:'''

* '''[CONSOLE_COMMAND] {CMD}''' - Executes the specified command by console. '''Cmd''' = Command. Placeholders: '''%p''' - Executor name
* '''[OP_COMMAND] {CMD}''' - Executes the specified command by target as OP. '''Cmd''' = Command. Placeholders: '''%p''' - Executor name
* '''[PLAYER_COMMAND] {CMD}''' - Executes the specified command by target. '''Cmd''' = Command. Placeholders: '''%p''' - Executor name
* '''[TELEPORT] {WORLD} {X} {Y} {Z}''' - Teleport target on specified coordinates.
* '''[TAKE_ITEM] (TYPE) (AMOUNT) (NAME) (LORE)''' - Takes specified amount of items from player's inventory.
* '''[TAKE_ARMOR] {HELMET / CHESTPLATE / LEGGINGS / BOOTS / ALL}''' - Takes specified armor from player's inventory.
* '''[TAKE_ECO] {AMOUNT}''' - Takes specified amount of money from player's balance.
* '''[MESSAGE] {TEXT}''' - Sends message to target.
* '''[ACTION_BAR] {TEXT}''' - Sends action bar message to target.
* '''[TITLES] {TITLE_TEXT} {SUB_TITLE_TEXT}''' - Sends title message to target. '''Space''' separates the titles and subtitles. Use '''_''' as a space. Example: '''[TITLES] Hello_Player! This_is_subtitle!'''
* '''[SOUND] {NAME}''' - Plays sound at target location. '''Name''' = Sound name.
* '''[FIREWORK]''' - Launch random firework.
* '''[OPEN_GUI] {ID}''' - Opens GUI with specified ID.
* '''[CLOSE]''' - Closes GUI.
* '''[DELAY] {TIME}''' - Delay between the actions. '''Time''' = Duration in Ticks, 20 ticks = 1 second.

== '''自定义条件''' ==
这些条件可用于插件的部分模块, 特别是是菜单.

'''Condition format:'''
 <code>'''conditions:'''
 '''-''' '''<nowiki/>'[CONDITION] ARGUMENTS''''
 '''条件:'''
 '''-''' '''<nowiki/>'[PERMISSION] core.custom'<nowiki/>''' # Will require core.custom permission.</code>
'''Condition Types:'''

* '''[OP] {true/false}''' - Requires players to be (de)OP.
* '''[PERMISSION] {permission}''' - Requires player to have specified permission.
* '''[LEVEL] {AMOUNT}''' - Requires player to have specified exp level.
* '''[ITEM] (TYPE) (AMOUNT) (NAME) (LORE)''' - Requires specified amount of items to be in player's inventory.
* '''[MONEY] {AMOUNT}''' - Requires specified amount of money to be on player's balance.