NEW eRankUP - 全自定义多条件升级插件

RankUp 是一个为 Minecraft 服务器设计的进阶系统插件，允许玩家通过完成特定要求来提升自己的等级（Rank）。它提供了丰富的自定义菜单、进度显示、音效和奖励系统，并支持 PlaceholderAPI 以实现深度集成。

💡重要须知

• 本插件目前处于测试阶段。如遇到任何问题，请通过以下链接联系开发者或进行捐赠支持：
• https://www.paypal.com/donate/?hosted_button_id=ERXFT6ESC943U

✨依赖

• PlaceholderAPI - 必须安装此插件才能使进度条和变量功能正常工作。

🎮权限与命令

玩家命令

• /rankup - 打开当前等级的进阶菜单。
• /ranks - 打开所有等级的浏览菜单。

管理员命令

• /rank reload - 重载插件配置文件。
• 所需权限：rankup.reload
• /forcerank <rank> - 强制将玩家晋升至指定等级。
• 所需权限：rankup.forcerank
• /reset - 重置玩家的等级。
• 所需权限：rankup.reset

🔧变量 (Placeholders)

本插件提供以下变量，可与 PlaceholderAPI 配合使用。

基础变量

• <rank> - 返回玩家当前等级。
• <next> - 返回下一个等级，若已达最高级则返回 lang.yml 中定义的提示语。
• <player> - 返回玩家的显示名称。
• %rankup_rank% - 返回玩家当前等级。
• %rankup_next% - 返回下一个等级，若已达最高级则返回 lang.yml 中定义的提示语。

进度变量

• %bar_all% - 返回所有需求的总进度条。
• %percent_all% - 返回所有需求的总完成百分比。
• %value_all% - 返回所有需求的总完成值。
• %max_all% - 返回所有需求的总目标值。

单项需求变量

将 [requirementName] 替换为配置文件中定义的具体需求名称（例如 mine_0）。

• %value_[requirementName]% - 返回该需求的当前完成值。
• %max_[requirementName]% - 返回该需求的目标值。
• %bar_[requirementName]% - 返回该需求的进度条。
• %percent_[requirementName]% - 返回该需求的完成百分比。

⭐配置设置

MySQL 数据库

MySQL:
  Activated: true
  User: "root"
  Password: ""
  Database: "rankup"
  Host: "localhost"
  Port: "3306"

音效与聊天

• reset-sound: BAT_TAKEOFF - 重置等级时播放的音效。
• reset-sound-error: NOTE_BASS - 无法设置等级时播放的音效。
• chat: true - 如果使用其他聊天插件，请禁用此项。
• chat-format: "<rank><player> &7>> &r<message>" - 服务器聊天格式。

进度条

progress-bar:
  bar: "\u25A0"
  size: 10
  color-1: "&a"
  color-2: "&7"

欢迎消息

join-message:
  first-join: false # 设为 true 则只在首次登录时发送
  clear-chat: true # 设为 true 则在玩家加入时清空其聊天框
  message:
  - ''
  - '&e================={ &6Hypixel &e}================='
  - '      &eHi <player>, welcome to our server.'
  - '&emake friends and build your empire on the server.'
  - '     &ebecome the strongest and most feared.'
  - '&e==========================================='
  - ' '

🔧菜单配置

确认菜单 (Confirm-Menu)

此菜单在玩家尝试进阶时弹出以进行确认。

• enabled: true - 设为 false 可禁用确认菜单。
• 包含 confirm（确认）和 deny（拒绝）两个固定物品，不可删除。

等级浏览菜单 (Rank-Menu)

此菜单用于展示所有可晋升的等级，支持多页面。

• 使用 page-<数字> 的格式来创建新页面（例如 page-1, page-2）。
• 在每个页面的 items 下，使用 rank1, rank2 等键来添加指向具体等级的图标，并设置其 rank（等级标识符）和 slot（物品栏位置）。
• 可添加 next（下一页）、back（上一页）和 close（关闭菜单）等导航物品。

🔧旗帜图案

在配置中创建自定义旗帜时，可使用以下图案代码（例如 SQUARE_TOP_RIGHT 或简写 tr）：

• bl 或 SQUARE_BOTTOM_LEFT - 左下角
• br 或 SQUARE_BOTTEM_RIGHT - 右下角
• tl 或 SQUARE_TOP_LEFT - 左上角
• tr 或 SQUARE_TOP_RIGHT - 右上角
• bs 或 STRIPE_BOTTOM - 底部条纹
• ts 或 STRIPE_TOP - 顶部条纹
• ls 或 STRIPE_LEFT - 左侧条纹
• rs 或 STRIPE_RIGHT - 右侧条纹
• cs 或 STRIPE_CENTER - 中心垂直条纹
• ms 或 STRIPE_MIDDLE - 中部水平条纹
• drs 或 STRIPE_DOWNRIGHT - 右下斜条纹
• dls 或 STRIPE_DOWNLEFT - 左下斜条纹
• ss 或 STRIPE_SMALL - 小垂直条纹
• cr 或 CROSS - 斜交叉
• sc 或 STRAIGHT_CROSS - 正交叉
• bt 或 TRIANGLE_BOTTOM - 底部三角形
• tt 或 TRIANGLE_TOP - 顶部三角形
• bts 或 TRIANGLES_BOTTOM - 底部锯齿三角形
• tts 或 TRIANGLES_TOP - 顶部锯齿三角形
• ld 或 DIAGONAL_LEFT - 左斜线
• rd 或 DIAGONAL_RIGHT - 右斜线
• lud 或 DIAGONAL_LEFT_MIRROR - 镜像左斜线
• rud 或 DIAGONAL_RIGHT_MIRROR - 镜像右斜线
• mc 或 CIRCLE_MIDDLE - 中心圆
• mr 或 RHOMBUS_MIDDLE - 中心菱形
• vh 或 HALF_VERTICAL - 左半垂直
• hh 或 HALF_HORIZONTAL - 上半水平
• vhr 或 HALF_VERTICAL_MIRROR - 右半垂直
• hhb 或 HALF_HORIZONTAL_MIRROR - 下半水平
• bo 或 BORDER - 边框
• cbo 或 CURLY_BORDER - 波浪边框
• cre 或 CREEPER - 苦力怕图案
• gra 或 GRADIENT - 渐变
• gru 或 GRADIENT_UP - 反向渐变
• bri 或 BRICKS - 砖块
• sku 或 SKULL - 头颅
• flo 或 FLOWER - 花朵
• moj 或 MOJANG - Mojang 标志

🔧等级模板

每个等级都在单独的配置文件中定义。以下是关键配置项说明：

基础信息

• name: default - 等级的唯一标识符，请勿使用颜色代码或特殊符号。
• display: "&e[Default] " - 等级的显示名称，可使用颜色和符号。
• order: 0 - 等级的顺序，起始等级设为 0，数字越大代表越高级。顺序不可重复。

音效

• evolve-sound: LEVEL_UP - 玩家成功进阶时对自己播放的音效。设为 DISABLED 可静音。
• evolve-sound-error: NOTE_BASS - 无法进阶时播放的音效。设为 DISABLED 可静音。
• evolve-sound-global: AMBIENCE_THUNDER - 玩家进阶时对全服播放的音效。留空或设为 DISABLED 可移除。

消息与标题

• evolve-message - 进阶时发送给玩家的聊天消息列表。
• evolve-message-global - 进阶时广播给全服的聊天消息。
• action-bar - 进阶时显示给玩家的动作条消息。
• action-bar-all - 进阶时显示给全服玩家的动作条消息。
• title 与 subtitle - 进阶时显示的标题与副标题。

等级专属菜单

在 menu: 下配置，用于展示该等级的详细信息、需求和进阶按钮。

• 包含 rank（等级展示）、requirement_1（需求展示）、evolve（进阶按钮）、back（返回）、close（关闭）等物品。
• 物品的 lore 中可使用进度变量（如 %bar_all%）来动态显示进度。

等级图标

• icon - 在等级浏览菜单中，未完成该等级时显示的图标。
• icon-completed - 在等级浏览菜单中，已完成该等级时显示的图标。

进阶奖励命令

在 commands: 列表中可以配置玩家进阶后执行的命令。

• 格式：give: -material -ammount -data -display -lore[line 1] -lore[line 2].... （给予物品）
• 格式：console: <command> （以控制台身份执行命令）
• 格式：bc: <message> （广播消息）
• 格式：message: <message> （向玩家发送消息）
• 使用 <player> 来指代玩家。

需求配置

在 requirements: 下可以定义多种进阶需求。示例为挖掘需求 (type: MINE)。

• value: 5 - 需要完成的目标值（如挖掘 5 个方块）。
• sound, title, actionbar, message - 完成该单项需求时的反馈。
• item: - 指定需要挖掘或交互的具体物品。