Additions - 多功能插件

注意：此免费版 Additions 已停止更新。 如需获取包含更多功能的最新版本，请访问 AdditionsPlus 页面。

💡重要须知

• 此免费版本将不再接收任何更新或新增功能，所有后续开发将仅针对付费版 Additions+ 进行。
• 我们仍会为免费版提供完整的技术支持。
• 遇到问题请先联系我们，而不是直接留下差评。
• 如果您在聊天中被“请为插件评五星”等消息刷屏，请前往 intervalactions.yml 文件，禁用或修改其中的相关操作。

🎮核心功能概览

Additions 插件允许你通过简单的配置文件，为服务器创建高度自定义的内容，而无需编写代码。

自定义命令

• 注册命令：创建全新的服务器命令。
• 命令参数：为命令设置参数。
• 权限控制：为命令设置使用权限 (permission)。
• 无权限提示：自定义无权限时的提示信息 (noPermission)。
• 冷却时间：为命令设置使用冷却 (cooldown)。
• 冷却提示：自定义冷却时的提示信息 (cooldownMessage)，可使用 %time% 占位符表示剩余时间。
• 执行动作：命令触发时可执行一系列动作 (actions)。

自定义菜单

• 自定义菜单标题：支持颜色代码。
• 标题占位符：在标题中使用占位符（如 %player%）。
• 左键/右键动作：为菜单物品分别设置点击动作。
• 自定义大小：支持 9, 18, 27, 36, 45, 54 格菜单。
• 打开权限：设置打开菜单所需的权限及无权限提示。
• 打开冷却：设置菜单打开冷却时间及提示。
• 打开/关闭动作：菜单打开或关闭时执行的动作。
• 完全可配置的物品：支持自定义材质、名称、描述、附魔等。
• 特殊物品支持：支持使用 ci-ITEMNAME 引用自定义物品，支持 HeadDatabase 插件和玩家头颅 (head-<玩家名>)。

自定义物品

• 完全可配置：所有物品属性均可自定义。
• 物品冷却：为物品使用设置冷却。
• 点击动作：支持左键、右键及通用点击动作。
• 特殊物品支持：支持 HeadDatabase 插件和玩家头颅。
• 附魔效果：可为物品添加附魔。

计分板

• 按世界显示：为不同世界设置不同的计分板。
• 玩家开关：允许玩家自行开关计分板。
• 防闪烁：提供更流畅的显示体验。
• 自定义标签列表：自定义玩家列表（Tab List）。
• 按世界显示标签：为不同世界设置不同的标签列表。
• 自定义标签内玩家名：在标签列表中自定义玩家名称显示。
• 动画效果：支持动态内容。
• 无限分组与排序：支持复杂的分组和排序逻辑。
• 占位符支持：可使用各种占位符。

其他功能

• 自定义书：创建具有自定义标题、作者、生成状态和无限页面的书。
• 间隔动作：以固定时间间隔执行动作，支持随机间隔和无限动作。
• 事件动作：在特定服务器事件（如加入、离开、击杀）发生时执行动作。
• 自定义加入/离开消息：完全自定义玩家的加入、离开和死亡消息。
• 颜色代码支持：在告示牌 (&) 和铁砧界面 (&) 中使用颜色代码。
• 登录物品：可将自定义物品设置为玩家加入时获得的、不可移动和丢弃的物品。

🔧插件集成与依赖

支持的核心插件

• PlaceholderAPI：支持使用其占位符。
• MVdWPlaceholderAPI：支持使用其占位符。
• Vault：用于经济、权限组功能。
• ProtocolLib：用于部分高级功能。
• HeadDatabase：支持使用其自定义头颅。

事件集成

• MinetopiaSDB
• ASkyBlock

依赖本插件的插件

• Recipe Control
• StreakRewards

✨配置教程

事件动作配置

在 events.yml 中配置。系统很简单：写入事件名称，后跟冒号，然后在其下定义 actions 列表。

join:
  actions:
    - '[msg] &a欢迎 %player% 加入服务器！'
    - '[title] &a&l欢迎\n&7请享受游戏'

若要移除某个事件的默认动作，可将 actions 设为空列表 []。

自定义加入、离开、死亡消息

join:
  joinMessage: '&a&l%player% 加入了服务器'
  actions: []
leave:
  leaveMessage: '&c&l%player% 离开了服务器'
  actions: []
dead:
  deathMessage: '&c%player% 不幸牺牲了。'
  actions: []

自定义命令配置

在 commands.yml 中配置。格式与事件类似，但键名是命令（不带斜杠）。

help:
  actions:
    - '[msg] &7--- &b帮助菜单 &7---'
    - '[msg] &b/helpop &7获取管理帮助'
    - '[msg] &f第 1/2 页'

为命令添加权限、冷却和相应提示

rankup:
  permission: yourperm.rankup
  noPermission: '&c你的等级不足以晋升！'
  cooldown: 1200 # 60秒 (1200 ticks)
  cooldownMessage: '&c此命令每分钟只能使用一次。还需等待 %time%'
  actions:
    - '[title] &a&l晋级成功！'
    - '[console] pex user %player% add yourperm.rankup.2'

自定义菜单配置 (v2.8.0+)

在 menus/ 文件夹下为每个菜单创建独立的 .yml 文件。文件名即为菜单名（打开时使用 /additions openmenu 菜单名）。

一个完整的菜单配置示例

# 菜单基本设置
title: '&b&l示例菜单 (%player%)'
size: 9
command: examplemenu # 打开命令（可选）
permission: myperm.examplemenu
noPermission: '&c你没有权限打开此菜单。'
cooldown: 200 # 10秒冷却
cooldownMessage: '&c请等待 %time% 后再打开此菜单。'
openActions:
  - '[msg] &a你打开了菜单！'
closeActions:
  - '[msg] &c你关闭了菜单。'

# 菜单内容
content:
  '1': # 第1格（从1开始计数）
    material: STONE
    displayName: '&7一些随机的 &l石头'
    lore:
      - ''
      - '&7这块石头可以是你的，&b%player%'
    enchantments:
      - DURABILITY:3
      - FIRE_ASPECT:10
    itemFlags:
      - HIDE_ENCHANTS
    unbreakable: true
    left_click_actions:
      - '[msg] &7你左键点击了石头'
    right_click_actions:
      - '[msg] &7你右键点击了石头'
  '2':
    material: head-%player% # 玩家头颅
    displayName: '&b&l你的头颅'
    lore:
      - '&7这是你自己的头'
      - '&7放心，它不是被砍下来的'

自定义物品配置

在 customitems.yml 中配置。物品的配置选项与菜单物品高度相似，并可额外设置物品选项（如禁止移动、丢弃等）。

diamond:
  material: DIAMOND
  slot: 3 # 放入玩家背包的第4格（从0开始）
  displayName: '&b特殊钻石'
  lore:
    - '&7这是一个不可移动的登录物品。'
  itemOptions:
    - DISABLE_INVENTORY_MOVING
    - DISABLE_DROP
  actions:
    - '[msg] &a你点击了特殊钻石！'

设置为登录物品：在 events.yml 的 join 事件中使用 [citem] 动作给予玩家。

join:
  actions:
    - '[citem] diamond' # 给予名为“diamond”的自定义物品
    - '[msg] &b欢迎来到服务器，%player%！'

❓占位符

插件内置了一系列占位符，并支持外部插件。

内置全局占位符

• %player%, %player_name%：玩家名。
• %player_gamemode%：游戏模式。
• %player_x%, %player_y%, %player_z%：坐标。
• %player_world%：世界名。
• %player_uuid%：UUID。
• %player_is_op%：是否为OP。
• %player_health%：生命值。

事件特定占位符

• %dropped% (drop 事件)：掉落物品的类型。
• %fished% (fishing 事件)：钓起物品的类型。
• %killed% (kill 事件)：被杀玩家名；(entitykill 事件)：被杀实体类型。
• %item% (itembreak 事件)：破坏物品的显示名。
• %consumed% (consume 事件)：消耗物品的显示名。

⭐可用动作列表

动作是配置中的核心，用于定义事件或命令触发时发生什么。格式为 [动作类型] 参数。

基础动作

• [command] / [player]：以玩家身份执行命令。例：[player] say 嗨
• [message] / [msg]：向玩家发送消息。例：[msg] &a欢迎 &l%player%
• [console]：以控制台身份执行命令。例：[console] give %player% stick 1
• [title]：向玩家发送标题（用 \n 分隔主副标题）。例：[title] &a&l欢迎！\n&7%player%
• [actionbar] / [action]：向玩家发送动作栏消息。例：[actionbar] &6欢迎来到我们服务器！
• [json]：向玩家发送JSON格式消息。
• [sound]：对玩家播放音效。例：[sound] NOTE_PLING

条件与修饰动作

• [everyone]：对所有在线玩家执行该动作。例：[msg][everyone] &a%player% 加入了服务器！
• [center]：将消息文本居中（仅对 [msg] 有效）。
• [language=""]：仅当玩家使用特定语言时执行。例：[msg][everyone][language="en_us"] &a你的语言是美式英语
• [delay=""]：延迟执行（单位：游戏刻，20刻=1秒）。例：[msg][delay="100"] &7这条消息延迟了5秒
• [permission=""]：仅当玩家拥有特定权限时执行。例：[msg][permission="myperm"] &a你拥有指定权限
• [vgroup=""]：仅当玩家在特定权限组时执行（需Vault）。例：[msg][vgroup="donator"] &d你是捐赠者
• [chance=]：按百分比概率执行。例：[msg][chance=50] &a你有50%几率看到此消息

特殊动作

• [connect]：将玩家连接至另一个BungeeCord子服务器。例：[connect] pvp
• [money]：给予/扣除玩家金钱（需Vault）。例：[money] 10 (给予) 或 [money] -10 (扣除)
• [menu]：为玩家打开自定义菜单。例：[menu] example
• [close]：关闭玩家的库存界面。
• [citem]：给予玩家一个自定义物品。例：[citem] diamond