YKRanks
源自 Rankup3 风格的 Minecraft 等级进阶插件
什么是 YKRanks?
YKRanks 是一款轻量级但功能强大的等级进阶插件,灵感源自 Rankup3。它为你的服务器提供了一个完整的等级阶梯系统,玩家通过完成可配置的要求(如赚取金钱、挖掘资源、获得经验值或持有特定物品)来晋升等级。每个等级都可以提供奖励,包括命令、物品、权限和特殊效果。
除了简单的排名系统外,YKRanks 还包含一个声望系统,允许玩家将等级重置回起点,以换取永久的声望等级及其专属加成。自动升级功能会定期检测玩家资格并在符合条件时立即提升其等级,而聊天点击提示会在玩家加入服务器及设定的时间间隔内显示带有 [RANKUP](升级)和 [DECLINE](拒绝)按钮的消息。
完全可编辑的等级列表和确认对话框支持每项操作的点击动作、占位符以及基于权限的查看要求。插件内置 4 种语言的消息文件,新增语言只需复制一个文件即可。进度条、PlaceholderAPI 占位符、Vault 经济系统与权限集成、基于 HikariCP 的 SQLite 存储以及丰富的奖励系统,使 YKRanks 成为适用于任何现代 Minecraft 服务器的完整且生产就绪的等级进阶解决方案。
功能特性
| 功能 |
描述 |
| 等级进阶 |
无限等级,支持自定义要求(金钱、经验值、物品、等级、权限、占位符)与奖励 |
| 声望系统 |
重置至第 1 级并获得永久声望等级,每个层级都有自定义要求和奖励 |
| 自动升级 |
当满足要求时自动为玩家升级,支持配置检查间隔 |
| 聊天点击提示 |
在加入服务器及设定时间间隔时显示 [RANKUP] / [DECLINE] 可点击消息 |
| DeluxeMenus 风格 GUI |
通过 YAML 完全可配置的等级列表和确认菜单 |
| 多语言支持 |
自带英语、西班牙语、法语和德语 — 复制文件即可添加任意语言 |
| 进度条 |
可配置的 ■■■■■□□□□□ 样式进度条,用于 GUI、聊天和计分板 |
| PlaceholderAPI |
10+ 个用于等级、声望、进度和资格的占位符 |
| 奖励与效果 |
命令、消息、物品、权限、音效、标题、烟花和广播 |
| SQLite + HikariCP |
快速异步数据库,支持 WAL 模式 |
依赖要求
安装步骤
- 将 YKRanks-1.0.0.jar 放入服务器的
plugins/ 文件夹中
- 安装 Vault 和经济类插件(例如 EssentialsX)
- 启动服务器 — YKRanks 会自动生成所有配置文件
- 编辑
rankups.yml 定义你的等级和要求
- 运行
/ykranks reload 即可开始使用
配置文件说明
| 文件 |
用途 |
config.yml |
主要设置 — 冷却时间、自动升级、进度条、提示间隔 |
rankups.yml |
等级定义、要求和奖励 |
prestiges.yml |
声望阶梯和奖励 |
menus/rankups.yml |
等级列表 GUI — DeluxeMenus 风格,支持点击操作 |
menus/confirmation.yml |
升级确认 GUI |
messages/ |
按语言分类的消息文件(en, es, fr, de) |
命令列表
| 命令 |
描述 |
权限节点 |
/rankup |
升级到下一个等级 |
ykranks.use |
/rankups |
打开等级列表 GUI |
ykranks.use |
/prestige |
声望重置 — 重置等级,获得声望等级 |
ykranks.prestige |
/ykranks reload |
重新加载所有配置文件 |
ykranks.reload |
/ykranks admin set <player> <rank> |
设置玩家的等级 |
ykranks.admin |
/ykranks admin give <player> <amount> |
给玩家发放金钱 |
ykranks.admin |
/ykranks admin reset <player> |
将玩家重置为初始等级 |
ykranks.admin |
PlaceholderAPI 占位符
| 占位符 |
描述 |
%ykranks_rank% |
当前等级显示名称 |
%ykranks_rank_id% |
当前等级 ID |
%ykranks_rank_number% |
当前等级序号(从 1 开始) |
%ykranks_prestige% |
当前声望等级 |
%ykranks_next_rank% |
下一等级的显示名称 |
%ykranks_can_rankup% |
如果符合升级条件则返回 true |
%ykranks_max_rank% |
如果处于最高等级则返回 true |
%ykranks_rankup_requirements% |
下一等级的格式化要求列表 |
%ykranks_progress% |
要求完成百分比(0-100) |
%ykranks_progress_bar% |
可视化进度条 |
示例等级配置
rankups:
starter:
name: "&aStarter"
material: "WOODEN_SWORD"
permission: "group.starter"
requirements:
- "money:500"
- "level:5"
rewards:
- "command:give %player% bread 16"
- "message:&6Welcome to the server!"
miner:
name: "&eMiner"
material: "IRON_PICKAXE"
permission: "group.miner"
requirements:
- "money:2000"
- "xp_level:10"
- "item:DIAMOND:16"
rewards:
- "command:give %player% iron_ingot 32"
- "sound:ENTITY_PLAYER_LEVELUP"
- "title:&6&lMiner&7&l!&r&7You are now a Miner"
YKRanks
Rankup3-style rank progression for Minecraft
What is YKRanks?
YKRanks is a lightweight yet powerful rank progression plugin inspired by Rankup3. It gives your server a complete rank ladder system where players progress through ranks by completing configurable requirements — such as earning money, mining resources, gaining XP levels, or holding specific items. Each rank can grant rewards like commands, items, permissions, and special effects.
Beyond simple ranking, YKRanks includes a prestige system that lets players reset their rank back to the start in exchange for a permanent prestige level with its own bonuses. An auto rank-up feature checks players periodically and advances them instantly when they qualify, while a clickable chat prompt nudges them with RANKUP and DECLINE buttons on join and at configurable intervals.
Fully editable rank lists and confirmation dialogs with per-item click actions, placeholders, and permission-based view requirements. Messages ship in 4 languages out of the box and any new language is just a copied file away. Progress bars, PlaceholderAPI placeholders, Vault economy and permission integration, HikariCP-backed SQLite storage, and a rich reward system make YKRanks a complete, production-ready solution for rank progression on any modern Minecraft server.
Features
| Feature |
Description |
| Rank Progression |
Unlimited ranks with custom requirements (money, XP, items, levels, permissions, placeholders) and rewards |
| Prestige System |
Reset to rank 1 with a permanent prestige level, custom requirements and rewards per tier |
| Auto Rank-Up |
Automatically rank up players when requirements are met, with configurable check interval |
| Clickable Chat Prompt |
Shows a [RANKUP] / [DECLINE] clickable message on join and at intervals |
| DeluxeMenus-Style GUI |
Fully configurable rank list and confirmation menus via YAML |
| Multi-Language |
Ships with English, Spanish, French and German — add any language by copying a file |
| Progress Bars |
Configurable ■■■■■□□□□□ bars for GUIs, chat, and scoreboards |
| PlaceholderAPI |
10+ placeholders for ranks, prestige, progress and eligibility |
| Rewards & Effects |
Commands, messages, items, permissions, sounds, titles, firework, and broadcasts |
| SQLite + HikariCP |
Fast async database with WAL mode |
Requirements
| Dependency |
Status |
| Spigot / Paper 1.21+ |
Required |
| Vault |
Required (economy) |
| PlaceholderAPI |
Optional |
Installation
- Drop YKRanks-1.0.0.jar into your server's
plugins/ folder
- Install Vault and an economy plugin (e.g. EssentialsX)
- Start the server — YKRanks generates all config files automatically
- Edit
rankups.yml to define your ranks and requirements
- Run
/ykranks reload and you're ready to go
Configuration Files
| File |
Purpose |
config.yml |
Main settings — cooldown, auto rank-up, progress bar, prompt intervals |
rankups.yml |
Rank definitions, requirements and rewards |
prestiges.yml |
Prestige ladder and rewards |
menus/rankups.yml |
Rank list GUI — DeluxeMenus-style with click actions |
menus/confirmation.yml |
Rank-up confirmation GUI |
messages/ |
Per-language message files (en, es, fr, de) |
Commands
| Command |
Description |
Permission |
/rankup |
Rank up to the next rank |
ykranks.use |
/rankups |
Open the rank list GUI |
ykranks.use |
/prestige |
Prestige — reset rank, gain prestige level |
ykranks.prestige |
/ykranks reload |
Reload all configuration files |
ykranks.reload |
/ykranks admin set <player> <rank> |
Set a player's rank |
ykranks.admin |
/ykranks admin give <player> <amount> |
Give money to a player |
ykranks.admin |
/ykranks admin reset <player> |
Reset a player to the first rank |
ykranks.admin |
PlaceholderAPI Placeholders
| Placeholder |
Description |
%ykranks_rank% |
Current rank display name |
%ykranks_rank_id% |
Current rank ID |
%ykranks_rank_number% |
Current rank number (1-indexed) |
%ykranks_prestige% |
Current prestige level |
%ykranks_next_rank% |
Next rank display name |
%ykranks_can_rankup% |
true if eligible to rank up |
%ykranks_max_rank% |
true if at the highest rank |
%ykranks_rankup_requirements% |
Formatted requirement list for next rank |
%ykranks_progress% |
Requirement completion percentage (0-100) |
%ykranks_progress_bar% |
Visual progress bar |
Example Rank Setup
rankups:
starter:
name: "&aStarter"
material: "WOODEN_SWORD"
permission: "group.starter"
requirements:
- "money:500"
- "level:5"
rewards:
- "command:give %player% bread 16"
- "message:&6Welcome to the server!"
miner:
name: "&eMiner"
material: "IRON_PICKAXE"
permission: "group.miner"
requirements:
- "money:2000"
- "xp_level:10"
- "item:DIAMOND:16"
rewards:
- "command:give %player% iron_ingot 32"
- "sound:ENTITY_PLAYER_LEVELUP"
- "title:&6&lMiner&7&l!&r&7You are now a Miner"
评论 0
登录后参与评分
还没有评论,来抢沙发吧