SunLight-Core

欢迎来到SunLight-Core插件百科

插件名
SunLight-Core

作者
NightExpress

兼容版本
1.13-1.14

原文
nexwiki

介绍  · Introduction

这是款轻量级的基础插件,包含了很多对于管理服务器很有用的功能. 插件分成多个模块，你可以随意关闭插件的任意模块.

模块  · Modules

模块

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: []

优化

这个模块添加了简单的优化系统来优化你的服务器性能和提升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

椅子

这个模块可以让玩家坐在半砖、台阶和地毯上.

指令和权限

指令	缩写	描述	是否只能由玩家使用	权限
/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}'
    # 聊天范围，设置为0.0关闭
    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 - 忽略聊天规则检测.

指令	缩写	描述	是否只能由玩家使用	权限
/adminchat	-	切换管理员聊天模式	是	core.chat.admin

经济

这一模块需要安装Vault!

特点:

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

Settings.yml

# /baltop更新间隔
baltop-update: 15
currency:
  # 货币符号
  symbol: '$'
  # 新玩家拥有的钱
  start-balance: 100.0

指令和权限

指令	缩写	描述	是否只能由玩家使用	权限
/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

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:
  - 'auc'
  - 'ah'

权限列表

• core.bypass.creative - 忽略创造限制.

菜单

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

特点:

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

Settings.yml

暂无 :/ 请查看下面的菜单配置

菜单配置

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

想要创建新的菜单你只需复制已有菜单文件并进行修改即可. 新版：

旧版: <spoiler>

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

</spoiler> 译者服务器菜单示例： <spoiler>

title: '&8[&b&k|&r&b&l云阁&b&k|&r&8]'
size: 54
need-permission: false
aliases:
- 'menu'
content:
  filler-panel:
    display:
      default:
        material: 'BLACK_STAINED_GLASS_PANE:1'
        name: '&r'
        conditions: []
    slots: '0,1,2,3,4,5,6,7,8,45,46,47,48,49,50,51,52,53,17,26,35,44,9,18,27,36'
  rules:
    display:
      default:
        material: 'BOOK:1'
        name: '&6&l规则'
        lore:
        - '&7点击查看服务器规则.'
        skull:
          hash: 
          owner: 
        enchanted: true
        hide-flags: true
        potion-effect: 'JUMP'
        leather-color: '255,255,255'
        conditions: []
    slots: '22'
    clicks:
      LEFT:
        conditions: []
        actions:
        - '[PLAYER_COMMAND] rules'
        - '[CLOSE]'
        fail-message: 
  music:
    display:
      default:
        material: 'NOTE_BLOCK:0'
        name: '&7[&8红石音乐&7]'
        lore:
        - '&c&l点击打开红石音乐菜单播放音乐'
        skull:
          hash: 
          owner: 
        enchanted: false
        hide-flags: true
        potion-effect: 'JUMP'
        leather-color: '255,255,255'
        conditions: []
    slots: '20'
    clicks:
      LEFT:
        conditions: []
        actions:
        - '[PLAYER_COMMAND] music'  
        fail-message: 
  pet:
    display:
      default:
        material: 'BONE:0'
        name: '&7[&2宠物&7]'
        lore:
        - '&a使用特制的缰绳可以捕捉宠物'
        - '&a你可以从服务器商店购买特制缰绳'
        - '&a点击打开宠物之家(或输入指令/pet collection)'
        - '&2右击宠物可打开宠物菜单(或输入指令/pet menu)'
        enchanted: true
        hide-flags: true
        potion-effect: 'JUMP'
        leather-color: '255,255,255'
    clicks:
      LEFT:
        conditions: []
        actions:
        - '[PLAYER_COMMAND] pet collection'   
        fail-message:         
    slots: '30' 
  particle:
    display:
      default:
        material: 'BLAZE_POWDER:0'
        name: '&6[&2粒&a子&c特&d效&6]'
        lore:
        - '&6点击打开&2粒&a子&c特&d效&6菜单(或输入指令/pp)'
        enchanted: true
        hide-flags: true
        potion-effect: 'JUMP'
        leather-color: '255,255,255'
    clicks:
      LEFT:
        conditions: []
        actions:
        - '[PLAYER_COMMAND] pp'   
        fail-message:         
    slots: '28'     
  quest:
    display:
      default:
        material: 'PAPER:0'
        name: '&7[&2任务&7]'
        lore:
        - '&a点击打开任务菜单'
        enchanted: false
        hide-flags: true
        potion-effect: 'JUMP'
        leather-color: '255,255,255'
        conditions: []
    clicks:
      LEFT:
        conditions: []
        actions:
        - '[PLAYER_COMMAND] quest'      
        fail-message:             
    slots: '32'   
  em:
    display:
      default:
        material: 'IRON_SWORD:0'
        name: '&7[&2精英怪物&7]'
        lore:
        - '&a点击打开精英怪物菜单'
        enchanted: false
        hide-flags: true
        potion-effect: 'JUMP'
        leather-color: '255,255,255'
        conditions: []
    clicks:
      LEFT:
        conditions: []
        actions:
        - '[OPEN_GUI] em'      
        fail-message:             
    slots: '24'
  mt:
    display:
      default:
        material: 'IRON_PICKAXE:0'
        name: '&7[&2多功能工具&7]'
        lore:
        - '&a点击打开合成多功能工具'
        - '&a将不同类型的工具放入对应格子内，点击羽毛获得多功能工具'
        - '&a或输入指令/mt open打开'
        enchanted: true
        hide-flags: true
        potion-effect: 'JUMP'
        leather-color: '255,255,255'
        conditions: []
    clicks:
      LEFT:
        conditions: []
        actions:
        - '[PLAYER_COMMAND] mt open'      
        fail-message:             
    slots: '10'
  dr:
    display:
      default:
        material: 'GOLD_INGOT:0'
        name: '&7[&6每日奖励&7]'
        lore:
        - '&6点击领取每日奖励'
        enchanted: true
        hide-flags: true
        potion-effect: 'JUMP'
        leather-color: '255,255,255'
        conditions: []
    clicks:
      LEFT:
        conditions: []
        actions:
        - '[PLAYER_COMMAND] dailyrewards'      
        fail-message:             
    slots: '12'
  tp:
    display:
      default:
        material: 'ENDER_PEARL:0'
        name: '&7[&6随机传送&7]'
        lore:
        - '&6点击使用随机传送'
        - '&d或输入/rtp使用随机传送'
        enchanted: false
        hide-flags: true
        potion-effect: 'JUMP'
        leather-color: '255,255,255'
        conditions: []
    clicks:
      LEFT:
        conditions: []
        actions:
        - '[PLAYER_COMMAND] rtp'      
        fail-message:             
    slots: '14'
  game:
    display:
      default:
        material: 'SLIME_BALL:0'
        name: '&7[&2街机游戏&7]'
        lore:
        - '&6点击打开街机游戏并加载资源包'
        - '&d或输入/ab play'
        enchanted: false
        hide-flags: true
        potion-effect: 'JUMP'
        leather-color: '255,255,255'
        conditions: []
    clicks:
      LEFT:
        conditions: []
        actions:
        - '[PLAYER_COMMAND] ab play'      
        fail-message:             
    slots: '16'    
  cv:
    display:
      default:
        material: 'GRASS_BLOCK:0'
        name: '&7[&6城镇文明&7]'
        lore:
        - '&6点击打开城镇文明菜单'
        - '&d也可使用向导书或输入/cv打开'
        enchanted: false
        hide-flags: true
        potion-effect: 'JUMP'
        leather-color: '255,255,255'
        conditions: []
    clicks:
      LEFT:
        conditions: []
        actions:
        - '[PLAYER_COMMAND] cv'      
        fail-message:             
    slots: '34' 
  sd:
    display:
      default:
        material: 'OAK_LOG:0'
        name: '&7[&6官方商店&7]'
        lore:
        - '&6左击建材商店'
        - '&f右击打开羊毛商店'
        - '&5鼠标中键打开主商店页面'
        enchanted: false
        hide-flags: true
        potion-effect: 'JUMP'
        leather-color: '255,255,255'
        conditions: []
    clicks:
      LEFT:
        conditions: []
        actions:
        - '[PLAYER_COMMAND] shop open blocks'      
        fail-message:  
      RIGHT:
        conditions: []
        actions:
        - '[PLAYER_COMMAND] shop open wool'      
        fail-message:     
      MIDDLE:
        conditions: []
        actions:
        - '[PLAYER_COMMAND] shop open'      
        fail-message:          
    slots: '38'        
  fur:
    display:
      default:
        material: 'FURNACE:0'
        name: '&7[&2家具&7]'
        lore:
        - '&6输入指令'
        - '&5/furniture recipe [家具名]  可查看家具合成配方'
        - '&5使用TAB补全家具名'
        enchanted: false
        hide-flags: true
        potion-effect: 'JUMP'
        leather-color: '255,255,255'
        conditions: [] 
    clicks:
      LEFT:
        conditions: []
        actions:
        - '[PLAYER_COMMAND] furniture recipe Table'      
        fail-message:          
    slots: '40'          

</spoiler>

指令和权限

权限列表:

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

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

家

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

特点:

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

Settings.yml

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

指令和权限

指令	缩写	描述	是否只能由玩家使用	权限
/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

general:
  # 是否使用礼包菜单.
  # 设置为 false 则只在聊天框内显示.
  use-gui: false
  # 礼包图标描述.
  # 占位符:
  # - %cost% - 礼包费用
  # - %access% - 显示是否可以领取该礼包
  # - %cd% - 显示礼包冷却.
  # - %cd_left% - 显示剩余冷却时间.
  # - %lore% - 礼包图标描述.
  kit-lore:
  - '&8&m                              '
  - '&7» &f价格: &a%cost%'
  - '&7» &f是否可领取: &f%access%'
  - '&7» &f冷却时间: &6%cd%'
  - '&7» &f剩余冷却时间: &c%cd_left%'
  - '&8&m                              '
  - '%lore%'
gui:
  # 选择礼包菜单
  # 菜单格式请看这里
  select:
    title: '&l礼包'
    size: 54
    pages: 1
    # 你的自定义物品
    content:
      filler:
        material: 'BLACK_STAINED_GLASS_PANE'
        name: ''
        lore: []
        slots: 45,46,47,48,49,50,51,52,53
  # 礼包预览菜单
  preview:
    title: '&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: 'BLACK_STAINED_GLASS_PANE'
        name: ''
        lore: []
        slots: 1,10,19,28,37,46,47,48,49,50,51,52,53

指令和权限

权限列表:

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

指令	缩写	描述	是否只能由玩家使用	权限
/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

# 设置默认世界.
# 玩家可在这个世界内使用随机传送
# 默认输入/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

指令和权限

指令	缩写	描述	是否只能由玩家使用	权限
/rtp	-	随机传送.	是	core.cmd.rtp

计分版

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

需要安装ProtocolLib和PlaceholderAPI!

特点:

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

Settings.yml

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

指令和权限

指令	缩写	描述	是否只能由玩家使用	权限
/board	/scoreboard	开关计分版显示	是	core.cmd.scoreboard

TAB

这个模块可以让你自定义TAB内容.

特点:

• 动态显示 - 创建并使用自定义动态效果.
• 页眉和页脚 - 更改TAB的页眉和页脚.
• 玩家名 - 更改玩家名格式.
• 玩家名标签 - 更改玩家名称号及格式.
• PlaceholderAPI - 支持 PlaceholderAPI (仅限TAB).

Settings.yml

format:
  # 更新间隔.
  # 20 刻 = 1 秒, 1 刻 = 50 毫秒
  update-interval: 1
  # 页眉和页脚.
  # 请使用这个格式来显示动态效果: %animation:[id]%,[id] 为配置内的动画名.
  header:
  - '%animation:servername%'
  - 
  - '&7在线人数:%animation:online% %server_online%'
  - 
  - '&2››› &7时间: &a[%server_time_HH:mm:ss%] &7| &7日期: &a[%server_time_dd.MM.yyyy%] &2‹‹‹'
  - 
  footer:
  - '&7'
  - '&7商店:'
  - '%animation:web%'
  - 
  - '&e玩的愉快! :)'
  - '&6ᚐᚐᚐᚐᚐᚐᚐᚐᚐᚐᚐᚐᚐᚐᚐᚐᚐᚐᚐᚐᚐᚐᚐᚐᚐᚐᚐᚐᚐᚐᚐᚐᚐ'
# 玩家名称和标签格式.
# 玩家权限组由插件自动检测.
# 权限越高的玩家在TAB的位置也越高.
group-format:
  Admins: '&7[&4管理员&7] &4%player%'
  default: '&7[&8玩家&7] &7%player%'
tag-group-format:
  Admins:
    prefix: '&4管理员 &f'
    suffix: 
  default:
    prefix: '&7玩家 &f'
    suffix: 

地标

这个模块为你的服务器提供了简易的地标系统.

特点:

• 地标菜单 - 使用菜单查看地标.
• 地标JSON列表 - 可交互的聊天信息.
• 地标欢迎消息 - 发送消息给传送到地标的玩家.
• 菜单编辑器 - 使用菜单编辑器创建和管理地标.
• 分级地标 - 设置不同权限组的玩家可使用的地标数.
• 地标权限 - 设置传送地标所需权限.
• 地标价格 - 设置传送所需费用.

Settings.yml

general:
  # 是否使用地标菜单.
  # 设置为false则只在聊天框内显示.
  use-gui: false
  # 地标图标描述.
  # 占位符:
  # - %cost% - 传送价格
  # - %access% - 是否可传送到该地标
  # - %owner% - 地标所有者.
  # - %id% - 内部地标名.
  # - %lore% - 地标图标描述.
  warp-lore:
  - '&8&m                        '
  - '&f» &7价格: &a%cost%'
  - '&f» &7是否可用: &f%access%'
  - '&f» &7拥有者: &6%owner%'
  - '&f» &7ID: &6%id%'
  - '&8&m                        '
  - '%lore%'
  # 不同等级的玩家可设置的地标数.
  # 插件自动检测玩家所在权限组.
  warps-by-rank:
    VIP: 2
    Gold: 3
gui:
  # 地标列表菜单
  # 菜单格式请看这里
  title: '&l地标'
  size: 54
  pages: 1
  custom-content:
    filler:
      material: BLACK_STAINED_GLASS_PANE
      name: ''
      lore: []
      slots: 45,46,47,48,49,50,51,52,53
commands:
  setdesc:
    #  /setwarpdesc 指令的每行最大长度和行数
    line-length: 50
    max-lines: 5

指令和权限

权限列表:

• core.warp.[id] - 允许传送到指定地标. [id] 为文件名.
• core.bypass.warp.cost - 忽略传送费用.

指令	缩写	描述	是否只能由玩家使用	权限
/warp	/warps	显示服务器的地标.	是	core.cmd.warp
/warp [warp]/warp [warp] [player]	/warps	传送到地标.	是 否	core.cmd.warp core.cmd.warp.others
/warp editor	/warps	打开地标编辑器.	是	core.cmd.warp.editor
/setwarp [warp]	-	在你所在位置创建地标.	是	core.cmd.setwarp
/delwarp [warp]	-	删除指定地标.	否	core.cmd.delwarp core.cmd.delwarp.others
/setwarpdesc [warp] [text]	-	设置地标描述. [text] 可使用 /n 分成多行.	否	core.cmd.setwarpdesc core.cmd.setwarpdesc.others
/setwarpicon [warp] [material]	-	更改地标图标.	否	core.cmd.setwarpicon core.cmd.setwarpicon.others
/setwarpname [warp] [name]	-	更改地标名.（不是id）	否	core.cmd.setwarpname core.cmd.setwarpname.others
/setwarpwelcome [warp] [text]	-	设置地标欢迎消息.[text] 可使用 /n 分成多行.	否	core.cmd.setwarpwelcome core.cmd.setwarpwelcome.others

欢迎消息

这个模块提供了欢迎玩家的功能.

特点:

• 欢迎萌新 - 在新玩家进入服务器时发送广播.
• 加入行为 - 自定义玩家加入服务器时触发的行为.
• 动态标题 - 在玩家加入时显示动态标题.
• PlaceholderAPI - 支持 PlaceholderAPI.

Settings.yml

# 萌新加入服务器时显示的消息.
# 留空关闭.
newbie-broadcast: '&e欢迎&6%player%&e来到我们的服务器!'

# 欢迎萌新
newbies:
  # 自定义行为.
  join-actions:
  - '[PLAYER_COMMAND] motd'
  - '[FIREWORK]'
  animated-titles:
    # 是否启用标题.
    enabled: true
    # 动态间隔. 20 = 1 秒.
    interval: 2
    # 框架
    # 支持在这使用PlaceholderAPI!
    title:
    - '&6«»'
    - '&6« »'
    - '&6« &e&lH &6»'
    - '&6« &e&lHe &6»'
    - '&6« &e&lHel &6»'
    - '&6« &e&lHell &6»'
    - '&6« &e&lHello &6»'
    - '&6« &e&lHello! &6»'
    # 子标题框架.
    subtitle: []

# 欢迎已注册的玩家.
users:
  # 自定义行为.
  join-actions:
  - '[PLAYER_COMMAND] motd'
  - '[FIREWORK]'
  animated-titles:
    enabled: true
    interval: 2
    title:
    - '&6«»'
    - '&6« »'
    - '&6« &e&lH &6»'
    - '&6« &e&lHe &6»'
    - '&6« &e&lHel &6»'
    - '&6« &e&lHell &6»'
    - '&6« &e&lHello &6»'
    - '&6« &e&lHello! &6»'
    subtitle: []

多世界管理

这个模块为你的服务器添加了简易的多世界系统.

特点:

• 加载/卸载 - 使用指令加载或卸载自定义世界.
• 创建/删除 - 使用指令创建或删除自定义世界.
• 传送 - 使用指令传送到其他世界.

生成器:

• NORMAL - 默认原版地形生成器.
• EMPTY - 虚空世界生成器.
• [PLUGIN] - 插件生成器.

Settings.yml

暂无 :/

指令和权限

指令	缩写	描述	是否只能由玩家使用	权限
/worlds	-	世界列表	否	core.cmd.worlds
/goto [world]	-	传送到指定的世界	是	core.cmd.goto
/move [player] [world]	-	传送玩家到指定的世界	否	core.cmd.move
/createworld [name] (ENV) (GEN) (TYPE) (DIFF) (SEED) (STRUCTURES)	-	创建自定义设置的世界	否	core.cmd.createworld
/deleteworld [world]	-	删除指定的自定义世界	否	core.cmd.deleteworld
/loadworld [world]	-	加载指定的自定义世界	否	core.cmd.loadworld
/unloadworld [world]	-	卸载指定的自定义世界	否	core.cmd.unloadworld

配置

自定义文本

在插件文件夹内你可以找到 /custom_text/ 文件夹,你可以在这个文件夹内创建自定义文本.

所有文件必须使用.txt格式.文件名就是指令名.

当你输入这个指令你就可以看到文件内的文本消息.

示例: 对于默认的 rules.txt 文件, 你可以在游戏内输入 /rules指令查看服务器规则.

每个文本文件的权限为 core.cmd.ctext.(file). 比如: core.cmd.ctext.rules - 为 rules.txt 的权限

数据

数据库存储设置.

data:
  # 自动保存间隔.单位为分钟.
  auto-save: 15
  storage:
    # 存储类型. SQLite 或 MySQL
    type: sqlite
    #以下设置仅限MySQL.
    username: none
    password: none
    host: none
    database: none
  purge:
    # 是否清除数据库老旧数据.
    enabled: false
    # 多久前的数据会被清除.
    days: 60

全局

全局设置.

general:
  # 关闭服务器下雨天气.
  disable-rain: false

指令

插件指令额外设置.

commands:
  # 禁用的插件指令. 可使用指令缩写.
  # 
  disabled: []
  # 传送请求过期时间.
  tpa-time: 30
  # /near 指令的搜索范围.
  near-radius: 100
  # 指令冷却. 支持其他插件的指令及其缩写.
  #
  cooldowns:
    rtp: 60
  # 设置 /time 指令的缩写.
  # 默认添加了两个指令: /day 和 /night
  # 时间必须是游戏刻数.
  time:
    day: 0
    night: 13000
  # /nick 指令.
  nick:
    max-lenght: 20
    min-lenght: 3
    black-list:
    - Admin
  # /tell 指令音效.
  sms:
    sounds:
      send: UI_BUTTON_CLICK
      get: BLOCK_NOTE_BLOCK_BELL
  # 设置 /list 指令格式.
  # 插件自动检测玩家权限组.
  list:
    rank-format:
      Admins: '%color%›› &f管理员: %players%'
      Users: '%color%›› &f玩家: %players%'
    rank-color:
      Admins: '&4'
      Users: '&7'
    format:
    - '&8&m----------------&e&l 玩家列表 &8&m----------------'
    - '%Admins%'
    - '%Users%'
    - '&6共有&e%total%名&6玩家在线.'

控制

control:
  fly:
    # 是否启用控制.
    enabled: true
    # 关闭飞行的世界列表.
    worlds:
    - events
  gamemode:
    # 是否启用游戏模式控制.
    enabled: true
    # 禁止使用的游戏模式.
    disallow:
    - SPECTATOR
  spawning:
    # 是否启用生成控制.
    enabled: false
    # 不会生成怪物的世界列表.
    worlds:
      some_world:
        NATURAL: false # 在此世界关闭自然生成生物.
  god-mode:
    worlds:
    - events

指令和权限

所有权限:

• 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 - 死亡保留物品.

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

[] - 为必须, () - 为可选.

指令	缩写	描述	仅限玩家	权限
/air [数量] /air [数量] (玩家名)	-	恢复氧气.	是 否	core.cmd.air core.cmd.air.others
/anvil /anvil (玩家名)	-	打开铁砧.	是 否	core.cmd.anvil core.cmd.anvil.others
/armor [玩家名]	-	查看和更换玩家的装备.	是	core.cmd.armor
/back /back [玩家名]	-	传送回上一个地方.	是 否	core.cmd.back core.cmd.back.others
/broadcast [文本]	/bc	广播消息.	否	core.cmd.broadcast
/burn [玩家名] [持续时间]	/ignite	点燃玩家.	否	core.cmd.burn
/clearchat	/cchat	清空聊天框.	否	core.cmd.clearchat
/clearinventory /clearinventory (玩家名)	/clearinv, /clear, /ci	清空玩家背包(包括装备)	是 否	core.cmd.clearinventory core.cmd.clearinventory.others
/core	/sl, /sunlight	插件主指令.	否	core.cmd.admin
/delspawn (spawn)	/deletespawn	删除特定的(或默认的)传送点.	否	core.cmd.delspawn
/enchant [附魔名] [附魔等级]	/ench	附魔或驱魔你手中物品.	是	core.cmd.enchant
/enchanting	-	打开附魔台.	是	core.cmd.enchanting
/enderchest /enderchest (玩家名)	/echest, /ec	打开末影箱.	是	core.cmd.enderchest core.cmd.enderchest.others
/exp [set/give] [数量] /exp [set/give] [玩家名] [数量]	/xp	修改玩家的经验值.	是 否	core.cmd.exp core.cmd.exp.others
/extinguish /extinguish (玩家名)	/ext	熄灭玩家身上的火焰.	是 否	core.cmd.ext core.cmd.ext.others
/feed /feed (玩家名)	-	恢复玩家的饥饿度.	是 否	core.cmd.feed core.cmd.feed.others
/fly (0/1) /fly (0/1) (玩家名)	-	切换飞行模式.	是 否	core.cmd.fly core.cmd.fly.others
/gm (0/1/2/3) /gm (0/1/2/3) (玩家名)	/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 (玩家名) [material] (amount)	/item, /i	给予玩家物品.	是 否	core.cmd.give
/god (0/1) /god (0/1) (玩家名)	-	切换玩家的上帝模式.	是 否	core.cmd.god core.cmd.god.others
/hat	-	戴帽子.	是	core.cmd.hat
/heal /heal (玩家名)	-	治疗玩家.	是 否	core.cmd.heal core.cmd.heal.others
/ignore [玩家名]	-	屏蔽玩家.	是	core.cmd.ignore
/invsee [玩家名]	/inv	查看玩家背包.	是	core.cmd.inv core.cmd.inv.others
/itemname [物品名	/rename	重命名手中物品.	是	core.cmd.itemname
del|clear]	/relore	修改手中物品的lore.	是	core.cmd.itemlore
/list	/online, /players	显示在线玩家.	否	core.cmd.list
/me [action]	-	在聊天内执行行为.	是	core.cmd.me
/mobkill [type]	/killmob	击杀附近的实体.	是	core.cmd.mobkill
/more	-	增加物品堆叠数至64.	是	core.cmd.more
/near (范围)	/nearby	显示附近的玩家.	是	core.cmd.near
/nick (nick)/nick [玩家名] [nick]	/name, /nickname	修改玩家昵称.	是 否	core.cmd.nick core.cmd.nick.others
/nophantom/nophantom [玩家名]	/antiphantom	关闭玩家附近的幻翼生成.	是 否	core.cmd.nophantom core.cmd.nophantom.others
/playerinfo [玩家名]	/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 [玩家名]	-	查看玩家最后在线时间.	否	core.cmd.seen
/setspawn (名称)	-	设置传送点.	是	core.cmd.setspawn
/skull [玩家名]	/head	获得玩家头颅.	是	core.cmd.skull
/sms [玩家名] [text]	/tell, /t, /m, /msg, /message, /w, /whisper, /pm	发送私聊消息给其他玩家.	否	core.cmd.tell
/socialspy (0/1) /socialspy (0/1) (玩家名)	-	切换侦查私聊模式.	是 否	core.cmd.socialspy core.cmd.socialspy.others
/spawn (spawn) /spawn [玩家名] (spawn)	-	强制玩家传送到传送点.	是 否	core.cmd.spawn core.cmd.spawn.others
/spawner [type]	-	更改刷怪笼实体类型.	是	core.cmd.spawner core.cmd.spawner.[type]
/spawnmob [type] [数量]	/mob	刷怪.	是	core.cmd.spawnmob core.cmd.spawnmob.[type]
/speed (amount) /speed (amount) (玩家名)	-	更改玩家速度.	是 否	core.cmd.speed core.cmd.speed.others
/sudo [玩家名] [command] /sudo [玩家名] c:[text]	-	强制玩家执行指令或发送聊天消息.	是 否	core.cmd.sudo
/suicide	/killme, /killmeplease	自杀.	是	core.cmd.suicide
/summon [玩家名]	/s	传送玩家到你身边(相当于Essentials的/tphere).	是	core.cmd.summon
/system	/tps, /gc, /mem	系统信息.	否	core.cmd.system
/thunder /thunder (玩家名)	/smite	雷击玩家或你看着的方块.	是 否	core.cmd.thunder core.cmd.thunder.others
/top /top (玩家名)	/up	传送到顶部.	是 否	core.cmd.top core.cmd.top.others
/tpaccept /tpaccept (玩家名)	-	接受传送请求.	是	core.cmd.tpaccept
/tpa [玩家名]	/call	发送传送请求.	是	core.cmd.tpa
/tp [玩家名] /tp [who] [to]	-	传送一名玩家到另一名玩家身边.	是 否	core.cmd.tp core.cmd.tp.others
/tpdeny /tpdeny [玩家名]	-	拒绝其他玩家的传送请求.	是 否	core.cmd.tpdeny core.cmd.tpdeny.others
/tppos [x] [y] [z] /tppos [x] [y] [z] [玩家名]	-	传送到指定坐标.	是 否	core.cmd.tppos core.cmd.tppos.others
/tptoggle	-	开关接受传送请求.	是 否	core.cmd.tptoggle
/unignore [玩家名]	-	不再屏蔽一名玩家.	是 否	core.cmd.unignore
/vanish /vanish [玩家名]	/v	切换隐身模式.	是 否	core.cmd.vanish core.cmd.vanish.others
/workbench	/wb	打开工作台.	是	core.cmd.workbench

实用功能

新版： 模板:Please leave this line alone and write below (this is the coloured heading)

Custom Actions Engine

Allows you to create custom effects and actions on item usage and in other cases.

Example Format:

actions:
  # Action Name, must be unique
  example:
  # Defines the targets for 'action-executors'
    target-selectors:
      # Target selector name. Used in 'action-executors' to define the action target.
      any:
      - '[RADIUS] ~distance: 20; ~allow-self: false; ~entity-type: pig;'
      self:
      - '[SELF]'
    # Defines custom conditions for 'action-executors'
    conditions:
      # Conditions list
      # For each condition you can provide 'message' parameter to send custom message for each condition in case of failure.
      list:
      - '[WORLD_TIME] ~amount: >12000;'
      # Here you can provide Action Name to switch to another actions list in case of conditions failure.
      actions-on-fail: fail
    # Executes the specified actions with custom parameters.
    action-executors:
    - '[COMMAND_CONSOLE] ~message: smite %target%; ~target: any;'
    - '[PROJECTILE] ~name: SHULKER_BULLET; ~target: any; ~speed: 3.5;'
    - '[PARTICLE_LINE] ~offset: 0.1,0,0.1; ~speed: 0; ~name: FLAME; ~target: any; ~amount: 50;'
    - '[POTION] ~name: JUMP; ~amount: 2; ~duration: 200; ~target: any;'
    - '[BURN] ~duration: 0; ~target: any;'
    - '[SOUND] ~name: ENTITY_WOLF_AMBIENT; ~target: any;'
  
  # These actions will be executed if conditions of actions above are failed,
  # because we put 'fail' name in 'actions-on-fail'.
  fail:
    target-selectors:
      self:
      - '[SELF]'
    # You can even provide more conditions here, but we don't need it now.
    conditions: {}
    action-executors:
    - '[MESSAGE] ~message: Conditions failed! Jumped to another actions.; ~target: self;'

Target Selectors

Defines the targets for action executors. You can define as many as you want.

Target Selector Format:

Every target parameter name MUST starts with '~' and ends with ':'

Parameter value MUST ends with ';'

target-selectors:
  # Custom target selector name. Used in action executor's target parameter.
  any:
  - '[RADIUS] ~distance: 20; ~allow-self: true; ~entity-type: pig;'
  self:
   - '[SELF]'

123

Available Target Selectors:

名称	Prefix	描述	参数 加粗 = 必填参数	用法示例
From Sight	[FROM_SIGHT]	选择执行者视野内的目标。	Distance Allow Self Attackable Entity Type Entity Health	[FROM_SIGHT] ~distance: 25; ~attackable: true; ~allow-self: false; ~entity-type: zombie;
Radius	[RADIUS]	选择执行者一定范围内的目标。	Distance·距离 Allow Self·是否包括执行者自身 Attackable·是否可攻击 Entity Type·实体类型 Entity Health··实体血量	[RADIUS] ~distance: 5; ~attackable: true; ~allow-self: false;
Self	[SELF]	将执行者视为目标。	Entity Health	[SELF] ~entity-health: >50%; ~party-member: false;

Condition Validators

Defines custom conditions before the action-executors will process.

Also: In some plugin configs you can use conditions out of the total actions, in this case condition target parameter is not needed.

Condition Format:

Every condition parameter name MUST starts with '~' and ends with ':'

Parameter value MUST ends with ';'

conditions:
  list:
  - '[WORLD_TIME] ~amount: >12000; ~message: It must be night!;'
  actions-on-fail: another

Available Conditions:

Name	Prefix	描述	Parameters RED = Required	Usage Example
Permission	[PERMISSION]	Requires the target to (not) have specified permission. You can provide negative permission to reverse this condition effect.	Target Name Message	[PERMISSION] ~name: -core.actions.test; ~message: You must have not permission!; ~target: self; [PERMISSION] ~name: core.actions.test; ~message: You must have permission!; ~target: self;
Vault Balance	[VAULT_BALANCE]	Requires the target to have specified money amount on balance.	Target Amount Message	[VAULT_BALANCE] ~amount: =100; ~message: You must have $100!; ~target: self; [VAULT_BALANCE] ~amount: <100; ~message: You must have < $100!; ~target: self; [VAULT_BALANCE] ~amount: >100; ~message: You must have > $100!; ~target: self;
World Time	[WORLD_TIME]	Requires the target's world time to be in specified range.	Target Amount Message	[WORLD_TIME] ~amount: >12000; ~message: It must be night!;

Action Executors

Defines the action type and parameters.

Action Executor Format:

Every action parameter name MUST starts with '~' and ends with ':'

Parameter value MUST ends with ';'

action-executors:
- '[PREFIX] ~param1: value; ~param2: value text;'

action-executors:
- '[POTION] ~name: JUMP; ~amount: 2; ~duration: 200; ~target: any;' # Adds Jump II potion effect for 10 seconds.

Available Action Executors:

名称	前缀	描述	参数 加粗 = 必填参数	用法
Action Bar	[ACTION_BAR]	Sends message to target's action bar.	§  Delay §  Target §  Message	[ACTION_BAR] ~message: &aHello, %executor%!; ~target: self;
Broadcast	[BROADCAST]	Broadcasts the message.	§  Delay §  Message	[BROADCAST] ~message: &aHello everyone!;
Burn	[BURN]	Burns the target.	§  Delay §  Target §  Duration	[BURN] ~duration: 100; ~target: pigs;
Command Player	[COMMAND_PLAYER]	Executes a command by action executor.	§  Delay §  Target §  Message	[COMMAND_PLAYER] ~message: smite %target%; ~target: players;
Command Console	[COMMAND_CONSOLE]	Executes a command by console.	§  Delay §  Target §  Message	[COMMAND_CONSOLE] ~message: smite %target%; ~target: players;
Command Op	[COMMAND_OP]	Executes a command by action executor as OP.	§  Delay §  Target §  Message	[COMMAND_OP] ~message: smite %target%; ~target: players;
Firework	[FIREWORK]	Launch firework at the target location.	§  Delay §  Target	[FIREWORK] ~target: self; ~delay: 20;
Hook	[HOOK]	Hooks target to the executor.	§  Delay §  Target	[HOOK] ~target: pigs;
Message	[MESSAGE]	Sends message to target.	§  Delay §  Target §  Message	[MESSAGE] ~message: &cYo, %target%; ~target: players;
Lightning	[LIGHTNING]	Summons lightning at the target location.	§  Delay §  Target	[LIGHTNING] ~target: pigs;
Go To	[GOTO]	Jumps to another actions section.	§  Delay §  Name	[GOTO] ~name: actions-name;
Particle Simple	[PARTICLE_SIMPLE]	Creates simple particle effect.	§  Delay §  Target §  Name §  Offset §  Speed §  Amount	[PARTICLE_SIMPLE] ~name:REDSTONE; ~offset: 0.1,0.1,0.1; ~speed: 0.1; ~amount: 30; ~target: pigs;
Potion	[POTION]	Adds a potion effect to target.	§  Delay §  Target §  Name §  Duration §  Amount	Amount = Level [POTION] ~name:JUMP; ~amount: 2; ~duration: 300; ~target: self;
Progress Bar	[PROGRESS_BAR]	Displays title progress bar.	§  Delay §  Target §  Title §  SubTitle §  Duration §  Color Empty §  Color Filled	SubTitle = Bar Symbol [PROGRESS_BAR] ~title: &cBar; ~subtitle: •; ~color-empty: &7; ~color-fill: &c; ~duration: 200; ~target: self;
Projectile	[PROJECTILE]	Launch projectile to the target.	§  Delay §  Target §  Name §  Speed	Name = EntityType [PROJECTILE] ~name: ARROW; ~speed: 3.5; ~target: around;
Sound	[SOUND]	Plays sound to the target.	§  Delay §  Target §  Name	[SOUND] ~name: ENTITY_WOLF_AMBIENT; ~target: around;
Teleport	[TELEPORT]	Teleports target to the specified location.	§  Delay §  Target §  Locatinon	[TELEPORT] ~location: world,25,10,25; ~target: self; [TELEPORT] ~location: %executor.world%,%executor.x%,%executor.y%,%executor.z%; ~target: around;
Throw	[THROW]	Throws target away from the executor.	§  Delay §  Target	[THROW] ~target: around; ~delay: 10;
Titles	[TITLES]	Sends titles to the target.	§  Delay §  Target §  Title §  SubTitle §  Fade In §  Stay §  Fade Out	[TITLES] ~title: &cTitle Text!; ~subtitle: &6SubTitle Text!; ~fadeIn: 10; ~stay: 50; ~fadeOut: 10; ~target: self;
Vault Add	[VAULT_ADD]	Adds or takes money from target's vault balance.	§  Delay §  Target §  Amount	[VAULT_ADD] ~amount: 100; ~target: self; [VAULT_ADD] ~amount: -100; ~target: self;

Action Parameters

Available Parameters:

名称	标志	Destination	描述	Usage Example
Allow Self	allow-self	Target Selector	Allows/Disallows to select the executor in target selector as a target. False by default.	~allow-self: false; | ~allow-self: true;
Amount	amount	All	Defines the object amount for specified action. Negative values are allowed.	~amount: 10; | ~amount: -5;
Attackable	attackable	Target Selector	Defines if target should be available to receive damage from the executor. This parameter only checks the WorldGuard and Residence flags and if target is a Citizens NPC. If this parameter is not provided, any entity will be selected.	~attackable: false; | ~attackable: true;
Delay	delay	Action Executor	Delay in ticks (20 ticks = 1 second), before the action will be executed.	~delay: 100;
Distance	distance	All	Defines the distance (in blocks) from the executor to target OR distance for specified action.	~distance: 30;
Duration	duration	Action Executor	Defines the action duration in ticks (20 ticks = 1 second).	~duration: 250;
Entity Health	entity-health	Target Selector, Conditions	You can use '>', '<' or '='. You can add '%' to check the current health of max. health. You can use decimal numbers.	~entity-health: 100%; ~entity-health: <25%; ~entity-health >0;
Entity Type	entity-type	Target Selector, Conditions	Defines the entity type for target selector. If no type provided, target selector will select any entity type. You can provide multiple types.	~entity-type: pig; ~entity-type: player,zombie,villager;
Location	location	Action Executor	Defines the location for action. Placeholders: §  %executor.world%, %executor.x%, %executor.y%, %executor.z% §  %target.world%, %target.x%, %target.y%, %target.z% Target placeholders replaces for the first target in a list.	~location:world,10,20,30;
Message	message	Action Executor, Conditions	设置消息文本. Placeholders: §  %executor% - Executor name §  %target% - Target name.	~message: &a你好!;
Name	name	All	设置指定行为的目标名。	~name: CLOUD;
Offset	offset	Action Executor	Defines the object offset for specified action. Format: X,Y,Z.	~offset: 0.1,0.1,0.1; ~offset: 0,0,0;
Speed	speed	Action Executor	Defines the object speed for specified action.	~speed: 0.5;
Target	target	Action Executor, Conditions	Defines the target selector for action. You can provide multiple targets. Use target selector names	~target: selector-1; ~target: pigs,cows;
Title	title	Action Executor	Defines the title text. Placeholders: §  %executor% - Executor name §  %target% - Target name.	~title: &lHello, &f%executor%&e!;
SubTitle	subtitle	Action Executor	Defines the subtitle text. Placeholders: §  %executor% - Executor name §  %target% - Target name.	~subtitle: &lHello, &f%executor%&e!;
Fade In	fadeIn	Action Executor	Defines the fade in time (in ticks) for titles.	~fadeIn: 10;
Stay	stay	Action Executor	Defines the stay time (in ticks) for titles.	~stay: 40;
Fade Out	fadeOut	Action Executor	Defines the fade out time (in ticks) for titles.	~fadeOut: 10;
Color Empty	color-empty	Action Executor	Defines the color for unfilled elements of progress bar.	~color-empty: &7;
Color Filled	color-fill	Action Executor	Defines the color for filled elements of progress bar.	~color-fill: &a;

1

旧版： <spoiler>

自定义行为

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

支持在这里使用PlaceholderAPI!

配置行为格式:

actions:
- '[ACTION] ARGUMENTS [CHANCE]'
actinos:
- '[PLAYER_COMMAND] rules %25.0' # 有25%的几率强制玩家执行 /rules 指令.

行为几率:

如果你想要以一定几率触发行为,你只需在行为后面加上%NUM .NUM 为小数几率.

行为类型:

• [CONSOLE_COMMAND] {CMD} - 从控制台执行指定指令. Cmd = 指令. 占位符: %p - 执行者名称
• [OP_COMMAND] {CMD} - 以OP权限执行指令. Cmd = 指令. 占位符: %p - 执行者名称
• [PLAYER_COMMAND] {CMD} - 以玩家权限执行指令. Cmd = 指令. 占位符: %p - 执行者名称
• [TELEPORT] {WORLD} {X} {Y} {Z} - 传送目标到指定世界指定地点.
• [TAKE_ITEM] (TYPE) (AMOUNT) (NAME) (LORE) - 从目标玩家的背包内拿走指定类型的物品.
• [TAKE_ARMOR] {HELMET·头盔 / CHESTPLATE·胸甲 / LEGGINGS·护腿 / BOOTS·鞋子 / ALL·所有装备} - 从玩家身上拿走指定装备.
• [TAKE_ECO] {AMOUNT} - 扣玩家的钱.
• [MESSAGE] {TEXT} - 发送消息给目标.
• [ACTION_BAR] {TEXT} - 发送actionbar消息给目标.
• [TITLES] {TITLE_TEXT} {SUB_TITLE_TEXT} - 发送标题消息给目标. 空格 分离标题和子标题. 请使用 _ 作为空格. 示例: [TITLES] Hello_Player! This_is_subtitle!
• [SOUND] {NAME} - 在指定地点播放音效. Name = 音效名.
• [FIREWORK] - 发射随机的烟花.
• [OPEN_GUI] {ID} - 打开指定ID的菜单.
• [CLOSE] - 关闭菜单.
• [DELAY] {TIME} - 行为之间的间隔. Time = 持续时间, 20 刻 = 1 秒.

自定义条件

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

条件格式:

conditions:
- '[CONDITION] ARGUMENTS'
条件:
- '[PERMISSION] core.custom' # 需要 require core.custom 权限.

条件类型:

• [OP] {true/false} - 需要玩家为管理员.
• [PERMISSION] {permission} - 需要玩家拥有指定的权限.
• [LEVEL] {AMOUNT} - 需要玩家有指定的经验等级.
• [ITEM] (TYPE) (AMOUNT) (NAME) (LORE) - 需要玩家背包内有指定类型的物品.
• [MONEY] {AMOUNT} - 需要玩家拥有指定数量的钱.

</spoiler>