
VanguardRanks
最强大的权限插件
VanguardRanks 支持 Placeholder API 集成,使服务器管理员能够使用自定义占位符来设定特定的权限升级要求。通过占位符定义余额、等级等条件,从而实现动态且个性化的权限标准。
基于图形界面 (GUI)
VanguardRanks 是最直观的权限插件。玩家无需在繁琐的命令和聊天消息中导航,而是可以通过 GUI 轻松查看可用权限并追踪自己的进度。
无限权限
VanguardRanks 允许你为玩家创建无限数量的权限。GUI 会自动分页,为玩家提供一个广泛且无缝的晋升系统。
本地化
VanguardRanks 支持多种语言,确保来自世界各地的玩家都能以母语体验该插件。你可以轻松配置语言消息,为社区提供个性化的体验。
高度可配置
VanguardRanks 提供了广泛的自定义选项,允许你根据服务器的独特需求定制权限系统。轻松修改权限要求、奖励和权限组,为你的玩家打造完美的晋升系统。
Discord 挂钩
通过内置的 Discord 挂钩与你的社区保持联系。自动将权限升级通知发送到你的 Discord 服务器,让玩家及时了解信息并保持参与感。
命令
- /rank - 打开 GUI
- /rank gui - 打开 GUI
- /rank gui [player] - 打开指定玩家的 GUI
- /rank check - 检查你自己的权限
- /rank check [player] - 检查其他玩家的权限
- /rank reload - 重载插件
- /rank list <page> - 列出所有权限,支持分页
- /rank players <page> - 列出所有玩家的权限,支持分页
- /rank up - 提升自身权限(如果可能)
- /rank up [player] - 提升其他玩家的权限(如果可能)
- /rank set [player] [rank] - 为玩家分配一个权限
- /rank help - 显示所有命令列表
- /rank version - 检查插件版本
权限
- vanguardranks.gui - 允许使用 /rank 和 /rank gui 打开权限 GUI
- vanguardranks.gui.other - 允许使用 /rank gui [player] 打开其他玩家的权限 GUI
- vanguardranks.gui.set - 允许使用权限 GUI 设置自己的权限
- vanguardranks.gui.set.other - 允许使用权限 GUI 设置其他玩家的权限
- vanguardranks.reload - 允许使用 /rank reload 重载插件
- vanguardranks.version - 允许使用 /rank version 检查插件版本
- vanguardranks.help - 允许使用 /rank help 查看命令列表
- vanguardranks.save - 允许使用 /rank save 保存插件数据
- vanguardranks.list - 允许使用 /rank list 列出所有权限
- vanguardranks.up - 允许使用 /rank up 提升自身权限
- vanguardranks.up.other - 允许玩家使用 /rank up [player] 提升其他玩家的权限
- vanguardranks.check - 允许使用 /rank check 检查自己的权限
- vanguardranks.set - 允许使用 /rank set [player] [rank] 为玩家分配特定权限
- vanguardranks.players - 允许玩家使用 /rank players 列出所有玩家的权限
占位符
权限占位符
- %rank% - 权限显示名称
- %display_name% - 权限显示名称
- %prefix% - 权限前缀
- %order% - 权限顺序
- %name% - 权限名称
- %player% - 玩家用户名
要求占位符
%current% - 要求的当前值
%required% - 要求的所需值
%status% - 要求的状态,true 或 false
PlaceholderAPI 占位符
%rank_prefix% - 玩家当前权限的前缀
%rank_next_prefix% - 下一个权限的前缀
%rank_previous_prefix% - 上一个权限的前缀
%rank_display_name% - 玩家当前权限的显示名称
%rank_next_display_name% - 下一个权限的显示名称
%rank_previous_display_name% - 上一个权限的显示名称
%rank_name% - 玩家当前权限的名称
%rank_next_name% - 下一个权限的名称
%rank_previous_name% - 上一个权限的名称
%rank_order% - 玩家当前权限的顺序
%rank_next_order% - 下一个权限的顺序
%rank_previous_order% - 上一个权限的顺序
%rank_status% - 玩家当前权限的状态
%prestige_name% — 声望的内部名称。
%prestige_next_name% — 下一个声望的内部名称。
%prestige_previous_name% — 上一个声望的内部名称。
%prestige_display_name% — 格式化后的声望显示名称。
%prestige_next_display_name% — 下一个声望的格式化显示名称。
%prestige_previous_display_name% — 上一个声望的格式化显示名称。
%prestige_prefix% — 带样式的声望前缀。
%prestige_next_prefix% — 下一个声望的带样式前缀。
%prestige_previous_prefix% — 上一个声望的带样式前缀。
%prestige_level% — 声望的数字等级。
%prestige_next_level% — 下一个声望的数字等级。
%prestige_previous_level% — 上一个声望的数字等级。
%prestige_var_<variable_name>% — 当前声望等级配置的自定义变量的值。
默认文件配置
config.yml
rank_checker: 300 # 每次权限检查之间的刻数。默认为 300(15 秒),设为 -1 以禁用。
rank_on_join: true # 如果为 true,玩家加入服务器时将自动获得第一个权限。
rank_up_message: true # 如果为 true,玩家在升级权限时会收到一条消息。你可以在 ranks.yml 文件中通过 "message:" 命令自定义此消息。
```yaml
prestige:
enabled: true
first_prestige_message: true # 如果为 true,玩家在首次晋升时会收到一条消息。你可以在 prestiges.yml 文件中使用 "message:" 命令自定义该消息。
# 你可以在 ranks.yml 文件中查看默认值,也可以在 prestiges.yml 文件中针对每个晋升等级进行覆盖。
variables:
check_money: 1
check_xp: 1
xp_multiplier: 1
storage:
adapter: yaml # yaml | mysql
prefix: vanguard_ranks
address: localhost:3306
database: minecraft
username: root
password: ''
discord:
enabled: true
avatar_url: 'https://minotar.net/helm/%player%/64.png'
username: '%player%'
webhooks:
default: 'https://discord.com/api/webhooks/1234567890/abcdefghijklmnopqrstuvwxyz'
rank: 'https://discord.com/api/webhooks/1234567890/abcdefghijklmnopqrstuvwxyz'
prestige: 'https://discord.com/api/webhooks/1234567890/abcdefghijklmnopqrstuvwxyz'
menu:
open_on_current_rank: true
gui:
flow: SNAKE # SNAKE, HORIZONTAL, VERTICAL
structure:
- "B A B A * A B A P"
- ". . . . . . . . ."
- ". . . . . . . . ."
- "B B B < X > B B B"
recipe:
"*":
icon: PLAYER_HEAD
icon_amount: 1
icon_model_data: 3
function: PLAYER
display_name: '<gray>%player%'
lore:
- "当前等级 %rank%"
- "晋升 %prestige_name%"
- "..."
# 使用空气填充空白区域
".":
icon: AIR
function: RANK
# 晋升进阶按钮
"P":
icon: GOLDEN_INGOT
function: PRESTIGE
display_name: '<gold>晋升'
lore:
- "当前等级 %rank%"
- "晋升 %prestige_name%"
- "..."
# 可作为装饰材质使用
"A":
icon: BLACK_STAINED_GLASS_PANE
function: DECORATIVE
# 你也可以不定义函数,默认为 DECORATIVE
"B": WHITE_STAINED_GLASS_PANE
"X":
icon: REDSTONE
function: CLOSE
# 可作为带有模型数据的物品使用
"<":
icon: RED_STAINED_GLASS_PANE
icon_model_data: 10
function: BACK
">":
icon: LIME_STAINED_GLASS_PANE
icon_model_data: 0
function: FORWARD
status:
completed:
display_name: '%rank% <gray>- <green><bold>已完成'
icon: AIR
icon_amount: 1
display_lore: true
prepend_lore:
- " "
append_lore:
- " "
- "<green>你已完成此等级!"
current:
display_name: '%rank% <gray>- <dark_green><bold>当前等级'
icon: AIR
icon_amount: 1
display_lore: true
prepend_lore:
- " "
append_lore:
- " "
- "<green>满足所有条件后点击提升你的等级"
in_progress:
display_name: '%rank% <gray>- <yellow><bold>进行中'
icon: AIR
icon_amount: 1
display_lore: true
prepend_lore:
- " "
append_lore:
- " "
- "<gold>你目前正在努力达成此等级!"
ready:
display_name: '%rank% <gray>- <aqua><bold>准备升级'
icon: AIR
icon_amount: 1
display_lore: true
prepend_lore:
- " "
append_lore:
- " "
- "<aqua>你现在可以升级了!"
locked:
display_name: '%rank% <gray>- <red><bold>已锁定'
icon: AIR
icon_amount: 1
display_lore: false
prepend_lore:
- " "
append_lore:
- " "
- "<red>你需要先完成上一个等级!"
# https://bstats.org/plugin/bukkit/VanguardRanks/22582
metrics: true
ranks.yml
rookie:
prefix: "<dark_gray>[<yellow>ROOKIE<dark_gray>]"
display_name: '<yellow>Rookie'
icon: COBBLESTONE
icon_amount: 1
icon_model_data: 0
lore:
- '<yellow>奖励'
- ' '
- '<gray>- <white>获得 %display_name% <gray>补给箱权限'
commands:
- 'lp user %player% permission set essentials.kits.%name% true'
- 'discord: :medal: %player% 达到了 %display_name%!'
# 拥有任一权限即可
- 'perm_rank.vip1;rank.vip2: eco give %player% 1000'
explorer:
prefix: "<dark_gray>[<green>EXPLORER<dark_gray>]"
display_name: '<green>Explorer'
icon: head:eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvOGFhNmMyZDFiZDgwZmRkNmE2MzJjYzdjYWZkMjVmMDllZjIwM2VlYzJhNjkzYjdjYmEwM2QxNzZiMmNjMDcxYiJ9fX0=
icon_amount: 2
icon_model_data: 10
requirements:
'%vault_eco_balance%':
type: NUMBER
eval: GREATER
value: '%math_1000*{prestige_var_check_money}%'
gui_message: '<gray>金钱 <green>%formatter_number_shorten_{current}%<gray>/<yellow>%formatter_number_shorten_{required}% <reset>%status%'
deny_message: '<gray>你需要拥有超过 <red>$%formatter_number_shorten_{required}% 的金钱'
'%statistic_walk_one_cm%':
type: NUMBER
eval: GREATER
value: 10000
gui_message: '<gray>行走距离 <green>%formatter_number_shorten_{current}%<gray>/<yellow>%formatter_number_shorten_{required}% <reset>%status%'
deny_message: '<gray>你需要至少行走 <red>%formatter_number_shorten_{required}% <gray>格'
lore:
- '<red>要求:'
- ' '
- '<gray>- %requirement_0%'
- '<gray>- %requirement_1%'
- ' '
- '<yellow>奖励'
- ' '
- '<gray>- <white>$1000'
- '<gray>- <white>获得 %display_name% <gray>补给箱权限'
commands:
- 'eco give %player% 1000'
- 'lp user %player% permission set essentials.kits.%name% true'
- 'title %player% title "<gray>你现在是 %display_name%!"'
- 'discord: :medal: %player% 达到了 %display_name%!'
- 'message: <green>恭喜!你现在是 %display_name%! '
# 拥有两个权限均可
- 'perm_rank.vip1,rank.vip2: eco give %player% 2000'
# 拥有任一权限即可
- 'perm_rank.vip1;rank.vip2: eco give %player% 1000'
rookie:
prefix: "<dark_gray>[<yellow>ROOKIE<dark_gray>]"
display_name: '<yellow>新手'
icon: GOLD_INGOT
icon_amount: 1
icon_model_data: 0
lore:
- '<yellow>奖励'
- ' '
- '<gray>- 目前没有什么特别的,但你可以开始你的旅程了!'
expert:
prefix: "<dark_gray>[<cyan>EXPERT<dark_gray>]"
display_name: '<cyan>专家'
icon: DIAMOND
icon_amount: 1
icon_model_data: 0
lore:
- '<yellow>奖励'
- ' '
- '<gray>- <white>获得 %prestige_var_xp_multiplier%x 更多经验值'
- '<gray>- <white>解锁 %prestige_prefix% <gray>套装'
variables:
check_money: 2
check_xp: 2
xp_multiplier: 1.5
commands:
- 'message: <green>恭喜!你现在是 %prestige_display_name% 了!'
- 'title %player% title "<gray>你现在是 %prestige_display_name% 了!"'
- 'exp give %player% 1000'

VanguardRanks
The most powerful ranking plugin
VanguardRanks with Placeholder API integration enables server managers to use custom placeholders to set specific requirements for rank progression. Define conditions such as balance, level, and more using placeholders, enabling dynamic and personalized ranking criteria.
GUI Based
VanguardRanks is the most intuitive ranking plugin. Instead of forcing your players to navigate tedious commands and chat messages, they can use the GUI to easily check available ranks and track their progress.
Unlimited Ranks
VanguardRanks allows you to create unlimited ranks for your players. The GUI is automatically paginated, offering an extensive and seamless progression system for your players to achieve.
Localization
VanguardRanks supports multiple languages, ensuring that players from around the world can enjoy the plugin in their native language. Easily configure the language messages to provide a personalized experience for your community.
Highly Configurable
VanguardRanks offers extensive customization options, allowing you to tailor the ranking system to fit your server's unique needs. Modify rank requirements, rewards, and permissions with ease to create the perfect progression system for your players.
Discord Hook
Stay connected with your community through the built-in Discord hook. Automatically send rank-up notifications directly to your Discord server, keeping your players informed and engaged.
Commands
- /rank - Opens the GUI
- /rank gui - Opens the GUI
- /rank gui [player] - Opens the GUI of a specified player
- /rank check - Check your own rank
- /rank check [player] - Check another player’s rank
- /rank reload - Reload the plugin
- /rank list <page> - List all ranks, with pagination
- /rank players <page> - List all player’s ranks, with pagination
- /rank up - Rank yourself up, if possible
- /rank up [player] - Rank another player up, if possible
- /rank set [player] [rank] - Assign a rank to a player
- /rank help - Display a list of all commands
- /rank version - Check plugin version
Permissions
- vanguardranks.gui - Allows to open the rank GUI with /rank and /rank gui
- vanguardranks.gui.other - Allows to open another player's rank GUI with /rank gui [player]
- vanguardranks.gui.set - Allows to set their own rank using the rank GUI
- vanguardranks.gui.set.other - Allows to set another player's rank using the rank GUI
- vanguardranks.reload - Allows to reload the plugin with /rank reload
- vanguardranks.version - Allows to check the plugin version with /rank version
- vanguardranks.help - Allows to view the list of commands with /rank help
- vanguardranks.save - Allows to save the plugin's data with /rank save
- vanguardranks.list - Allows to list all ranks with /rank list
- vanguardranks.up - Allows to rank themselves up with /rank up
- vanguardranks.up.other - Allows the player to rank another player up with /rank up [player]
- vanguardranks.check - Allows to check their own rank with /rank check
- vanguardranks.set - Allows to assign a specific rank to a player with /rank set [player] [rank]
- vanguardranks.players - Allows the player to list all players' ranks with /rank players
Placeholders
Ranks Placeholders
- %rank% - The rank displayname
- %display_name% - The rank displayname
- %prefix% - The rank prefix
- %order% - The rank order
- %name% - The rank name
- %player% - The player username
Requirements Placeholders
%current% - The current value of the requirement
%required% - The required value of the requirement
%status% - The status of the requirement, if true or false
PlaceholderAPI Placeholders
%rank_prefix% - The prefix of the player's current rank
%rank_next_prefix% - The prefix of the next rank
%rank_previous_prefix% - The prefix of the previous rank
%rank_display_name% - The display name of the player's current rank
%rank_next_display_name% - The display name of the next rank
%rank_previous_display_name% - The display name of the previous rank
%rank_name% - The name of the player's current rank
%rank_next_name% - The name of the next rank
%rank_previous_name% - The name of the previous rank
%rank_order% - The order of the player's current rank
%rank_next_order% - The order of the next rank
%rank_previous_order% - The order of the previous rank
%rank_status% - The status of the player's current rank
%prestige_name% — Internal name of the prestige.
%prestige_next_name% — Internal name of the next prestige.
%prestige_previous_name% — Internal name of the previous prestige.
%prestige_display_name% — Formatted display name of the prestige.
%prestige_next_display_name% — Formatted display name of the next prestige.
%prestige_previous_display_name% — Formatted display name of the previous prestige.
%prestige_prefix% — Styled prefix of the prestige.
%prestige_next_prefix% — Styled prefix of the next prestige.
%prestige_previous_prefix% — Styled prefix of the previous prestige.
%prestige_level% — Numeric level of the prestige.
%prestige_next_level% — Numeric level of the next prestige.
%prestige_previous_level% — Numeric level of the previous prestige.
%prestige_var_<variable_name>% — Value of a custom variable configured for the current prestige level.
Default Files Configuration
config.yml
rank_checker: 300 # The amount of ticks between each rank check. Default is 300 (15 seconds), -1 to disable.
rank_on_join: true # If true, players will automatically receive the first rank when they join the server.
rank_up_message: true # If true, players will receive a message when they rank up. You can customize the message in the ranks.yml file with the "message:" command.
prestige:
enabled: true
first_prestige_message: true # If true, players will receive a message when they prestige for the first time. You can customize the message in the prestiges.yml file with the "message:" command.
# Default values you can check in the ranks.yml file, you can override for each prestige level in the prestiges.yml file.
variables:
check_money: 1
check_xp: 1
xp_multiplier: 1
storage:
adapter: yaml # yaml | mysql
prefix: vanguard_ranks
address: localhost:3306
database: minecraft
username: root
password: ''
discord:
enabled: true
avatar_url: 'https://minotar.net/helm/%player%/64.png'
username: '%player%'
webhooks:
default: 'https://discord.com/api/webhooks/1234567890/abcdefghijklmnopqrstuvwxyz'
rank: 'https://discord.com/api/webhooks/1234567890/abcdefghijklmnopqrstuvwxyz'
prestige: 'https://discord.com/api/webhooks/1234567890/abcdefghijklmnopqrstuvwxyz'
menu:
open_on_current_rank: true
gui:
flow: SNAKE # SNAKE, HORIZONTAL, VERTICAL
structure:
- "B A B A * A B A P"
- ". . . . . . . . ."
- ". . . . . . . . ."
- "B B B < X > B B B"
recipe:
"*":
icon: PLAYER_HEAD
icon_amount: 1
icon_model_data: 3
function: PLAYER
display_name: '<gray>%player%'
lore:
- "Current rank %rank%"
- "Prestige %prestige_name%"
- "..."
# Fill the empty space with a material
".":
icon: AIR
function: RANK
# Prestige advance button
"P":
icon: GOLDEN_INGOT
function: PRESTIGE
display_name: '<gold>Prestige'
lore:
- "Current rank %rank%"
- "Prestige %prestige_name%"
- "..."
# You can use as a material
"A":
icon: BLACK_STAINED_GLASS_PANE
function: DECORATIVE
# You can also not define a function, default will be DECORATIVE
"B": WHITE_STAINED_GLASS_PANE
"X":
icon: REDSTONE
function: CLOSE
# You can use as an item with model data
"<":
icon: RED_STAINED_GLASS_PANE
icon_model_data: 10
function: BACK
">":
icon: LIME_STAINED_GLASS_PANE
icon_model_data: 0
function: FORWARD
status:
completed:
display_name: '%rank% <gray>- <green><bold>COMPLETED'
icon: AIR
icon_amount: 1
display_lore: true
prepend_lore:
- " "
append_lore:
- " "
- "<green>You have completed this rank!"
current:
display_name: '%rank% <gray>- <dark_green><bold>CURRENT RANK'
icon: AIR
icon_amount: 1
display_lore: true
prepend_lore:
- " "
append_lore:
- " "
- "<green>Click you rank up if all satisfied"
in_progress:
display_name: '%rank% <gray>- <yellow><bold>IN PROGRESS'
icon: AIR
icon_amount: 1
display_lore: true
prepend_lore:
- " "
append_lore:
- " "
- "<gold>You are currently working on this rank!"
ready:
display_name: '%rank% <gray>- <aqua><bold>READY TO RANK UP'
icon: AIR
icon_amount: 1
display_lore: true
prepend_lore:
- " "
append_lore:
- " "
- "<aqua>You can rank up now!"
locked:
display_name: '%rank% <gray>- <red><bold>LOCKED'
icon: AIR
icon_amount: 1
display_lore: false
prepend_lore:
- " "
append_lore:
- " "
- "<red>You need to complete the previous rank!"
# https://bstats.org/plugin/bukkit/VanguardRanks/22582
metrics: true
ranks.yml
rookie:
prefix: "<dark_gray>[<yellow>ROOKIE<dark_gray>]"
display_name: '<yellow>Rookie'
icon: COBBLESTONE
icon_amount: 1
icon_model_data: 0
lore:
- '<yellow>Rewards'
- ' '
- '<gray>- <white>Access to %display_name% <gray>kit'
commands:
- 'lp user %player% permission set essentials.kits.%name% true'
- 'discord: :medal: %player% has reached %display_name%!'
# Has either of the permissions
- 'perm_rank.vip1;rank.vip2: eco give %player% 1000'
explorer:
prefix: "<dark_gray>[<green>EXPLORER<dark_gray>]"
display_name: '<green>Explorer'
icon: head:eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvOGFhNmMyZDFiZDgwZmRkNmE2MzJjYzdjYWZkMjVmMDllZjIwM2VlYzJhNjkzYjdjYmEwM2QxNzZiMmNjMDcxYiJ9fX0=
icon_amount: 2
icon_model_data: 10
requirements:
'%vault_eco_balance%':
type: NUMBER
eval: GREATER
value: '%math_1000*{prestige_var_check_money}%'
gui_message: '<gray>Money <green>%formatter_number_shorten_{current}%<gray>/<yellow>%formatter_number_shorten_{required}% <reset>%status%'
deny_message: '<gray>You need to have more money than <red>$%formatter_number_shorten_{required}%'
'%statistic_walk_one_cm%':
type: NUMBER
eval: GREATER
value: 10000
gui_message: '<gray>Distance Walked <green>%formatter_number_shorten_{current}%<gray>/<yellow>%formatter_number_shorten_{required}% <reset>%status%'
deny_message: '<gray>You need to walk at least <red>%formatter_number_shorten_{required}% <gray>blocks'
lore:
- '<red>Requirements:'
- ' '
- '<gray>- %requirement_0%'
- '<gray>- %requirement_1%'
- ' '
- '<yellow>Rewards'
- ' '
- '<gray>- <white>$1000'
- '<gray>- <white>Access to %display_name% <gray>kit'
commands:
- 'eco give %player% 1000'
- 'lp user %player% permission set essentials.kits.%name% true'
- 'title %player% title "<gray>You are now %display_name%!"'
- 'discord: :medal: %player% has reached %display_name%!'
- 'message: <green>Congratulations! You are now %display_name%!'
# Has both permissions
- 'perm_rank.vip1,rank.vip2: eco give %player% 2000'
# Has either of the permissions
- 'perm_rank.vip1;rank.vip2: eco give %player% 1000'
prestiges.yml
rookie:
prefix: "<dark_gray>[<yellow>ROOKIE<dark_gray>]"
display_name: '<yellow>Rookie'
icon: GOLD_INGOT
icon_amount: 1
icon_model_data: 0
lore:
- '<yellow>Rewards'
- ' '
- '<gray>- Nothing special yet, but you can start your journey!'
expert:
prefix: "<dark_gray>[<cyan>EXPERT<dark_gray>]"
display_name: '<cyan>Expert'
icon: DIAMOND
icon_amount: 1
icon_model_data: 0
lore:
- '<yellow>Rewards'
- ' '
- '<gray>- <white>Gain %prestige_var_xp_multiplier%x more XP'
- '<gray>- <white>Access to %prestige_prefix% <gray>kit'
variables:
check_money: 2
check_xp: 2
xp_multiplier: 1.5
commands:
- 'message: <green>Congratulations! You are now %prestige_display_name%!'
- 'title %player% title "<gray>You are now %prestige_display_name%!"'
- 'exp give %player% 1000'
评论 0
登录后参与评分
还没有评论,来抢沙发吧