RealPermissions
让 GUI 权限管理变得简单。
通过图形界面或命令来管理等级、权限、限时等级、等级路径和升级。
Discord | 源代码 | 报告错误
RealPermissions 是什么?
RealPermissions 是一个几乎完全可以通过图形界面运行的权限插件。玩家获得一个等级(rank),每个等级拥有各自的权限并可以继承其他等级的权限,且每个等级都有自己独立的前缀和聊天格式。此外,你还可以为玩家赋予专属权限,发放限时等级和权限,让玩家沿等级路径晋升,并通过 /rankup 让玩家购买下一个等级。
功能特性
- 全功能图形界面:管理玩家、等级、权限、升级路径和设置
- 等级间的权限继承
- 否定权限(以
- 开头的节点)和通配符权限(以 * 结尾的节点)
- 玩家专属权限:在玩家所属等级权限之外额外添加
- 限时等级和限时玩家权限(例如
30m、12h、7d、1d12h)
- 按等级划分的前缀和聊天格式
- 标签页列表中的前缀显示,且标签页列表按等级权重排序
- 等级路径(Tracks):按照设定的等级顺序提升或降级玩家,每条路径需具备相应权限才能操作
- 等级升级(Rankup):玩家通过 Vault 支付费用沿升级路径提升等级
/rp check:解释玩家某项权限的来源(自身权限、所属等级、继承等级、通配符、超级用户、OP 或其他插件)
- 读取其他插件的权限:从它们的
plugin.yml 中读取,你可以直接从列表中选择,无需手动输入
- 原生集成:通过 RealPermissions API 与 RealScoreboard、RealMines、RealRegions、RealSkywars、RealHoppers 和 RealLogin 实现原生集成
- Vault 权限和聊天提供者:使其他插件能够识别你的等级、权限和前缀
- 支持导入:可从 LuckPerms、PermissionsEx 和 GroupManager 导入数据
- 在 1.21.6+ 版本中,支持原生对话框用于文本输入、设置和确认(旧版本使用聊天窗口)
- 支持 SQLite 和 MySQL 存储玩家数据
- 支持 PlaceholderAPI 占位符
- 完全可配置的 YAML 配置文件、等级配置、升级路径配置文件和语言文件
等级(Ranks)
等级定义在 ranks.yml 文件中。每个等级包含图标、前缀、聊天格式、继承的等级以及自身的权限。新玩家默认获得 Default-Rank。
等级示例及选项说明
Default-Rank: Player
Ranks:
VIP:
Icon: IRON_INGOT
Prefix: "&9VIP"
Chat: "%prefix% %player% &7- &f%message%"
Inheritance:
- Player
Permissions:
- essentials.afk
- -essentials.fly
| 选项 |
作用 |
Chat |
聊天格式,支持 %prefix%、%player% 和 %message%。可在 config.yml 中通过 Chat-Formatting 关闭格式化。 |
Inheritance |
该等级将自动获得此处列出的所有等级的权限。 |
Permissions |
以 - 开头的节点表示移除权限;以 * 结尾的节点表示授予其下所有权限。 |
Weight(可选) |
数值越高,在标签页列表中排序越靠前。若未设置,权重默认为该等级继承的等级数量。可通过 /rp setweight 设置。 |
等级路径(Tracks)
等级路径是 ranks.yml 中定义或由 /rp settrack 设定的一组有序等级(从低到高)。使用 /rp promote <player> <track> 或 /rp demote <player> <track> 可将玩家在该路径上提升或降低一级。拥有 realpermissions.track.<track> 权限的工作人员只能对该特定路径进行操作,无法发放其他任何等级。如果玩家处于限时等级状态,则在其过期或被清除前无法被移动。
等级升级(Rankup)
升级路径定义在 rankup.yml 文件中,需要安装 Vault 和经济类插件。升级路径是一系列等级构成的序列,每个等级都有对应的价格,第一个等级价格为 0。玩家打开 /rankup 后选择一条路径并支付费用以升至下一级。升级路径可以设置 Permission,只有满足条件的玩家才能看到它。升级路径也可以通过图形界面进行添加、编辑和删除。
升级路径示例
Rankups:
VIPRankup:
Display-Name: "&bVIP &bRankup"
Icon: FILLED_MAP
Permission: RealPermissions.Rankup.VIPRankup
Description:
- '&f这是一个仅对 &bVIP 开放的升级路径'
Entries:
- VIP=0
- VIP+=100000
- VIPPro=3000000
超级用户(Super Users)
超级用户是通过控制台使用 /rp setsuper <player> 设置的玩家。超级用户将获得 realpermissions.admin 权限,是唯一能在游戏中运行更改等级和权限的命令(设置等级、限时等级、添加或移除权限、删除等级、管理路径、导入数据)的玩家。控制台始终可以执行这些命令。
截图





快速入门
- 在控制台中将自己设为超级用户:
/rp setsuper <your name>。
- 在游戏中运行
/rp 打开图形界面。
- 打开 Ranks(等级) 以添加等级、修改其前缀和图标,并添加权限。来自其他插件的权限可以直接从列表中选择。
- 使用
/rp setrank <player> <rank> 或在图形界面的 Players(玩家) 中给玩家分配等级。
- 若要允许玩家购买等级,请安装 Vault 和经济类插件,并在
rankup.yml 或图形界面中设置升级路径。
- 正在从其他权限插件迁移?运行
/rp import <luckperms|pex|groupmanager> 预览将要导入的内容,然后追加 confirm 确认导入。
命令
基础命令:/realpermissions、/rp。除非另有说明,所有命令均需 realpermissions.admin 权限。“超级用户”意味着玩家必须同时是超级用户;控制台始终可以执行相关命令。
| 命令 |
别名 |
描述 |
权限 |
/rp |
|
打开 GUI(在控制台中显示插件信息) |
Admin |
/rp reload |
rl |
重载配置、语言、等级和升级路径 |
Admin |
/rp setrank <player> <rank> |
sr |
设置玩家的等级 |
Super user |
/rp permission <add|remove> <rank> <permission> |
perm |
更改等级的权限 |
Super user |
/rp playerperm <add|remove> <player> <permission> [duration] |
pperm |
更改玩家自身的权限,如果提供了持续时间则生效一段时间 |
Super user |
/rp check <player> <permission> |
c |
说明玩家是否拥有该权限,以及原因 |
Admin |
/rankup |
/rk |
打开等级升级界面 |
realpermissions.rankup |
所有命令
| 命令 |
别名 |
描述 |
权限 |
/rp settings |
|
打开设置 |
Admin |
/rp rank <rank> |
r |
打开等级的编辑器 |
Admin |
/rp ranks |
|
打开等级列表(在控制台中列出等级) |
Admin |
/rp players |
plrs |
打开玩家列表 |
Admin |
/rp player <player> |
p |
打开玩家的权限 |
Admin |
/rp setsuper <player> |
setsu |
开启或关闭超级用户模式 |
仅限控制台 |
/rp settimedrank <player> <rank> <seconds> |
str |
给予玩家限时等级;过期后恢复原等级 |
Super user |
/rp cleartimedrank <player> |
ctr |
结束限时等级 |
Super user |
/rp rename <rank> <new name> |
ren |
重命名等级 |
Admin |
/rp delete <rank> |
del |
删除等级(默认等级除外) |
Super user |
/rp setweight <rank> <weight|auto> |
sw |
设置等级在标签页列表中的权重 |
Admin |
/rp tracks |
|
列出升级路径 |
Admin |
/rp settrack <track> <rank> <rank> [rank...] |
st |
创建或替换升级路径 |
Super user |
/rp deltrack <track> |
dt |
删除升级路径 |
Super user |
/rp promote <player> <track> |
|
将玩家在指定升级路径上提升一个等级 |
Super user 或 realpermissions.track.<track> |
/rp demote <player> <track> |
|
将玩家在指定升级路径上降低一个等级 |
Super user 或 realpermissions.track.<track> |
/rp import <luckperms|pex|groupmanager> [confirm] |
|
显示将要导入的内容,并通过 confirm 执行导入。对于 LuckPerms,请先运行 /lp export |
Super user |
/rp hooks |
hks |
显示 RealPermissions 已知的其他插件的权限 |
Admin |
/rp hook <plugin> |
hk |
打开特定插件的权限 |
Admin |
权限
| 权限 |
描述 |
realpermissions.admin |
/rp 命令及 GUI |
realpermissions.rankup |
/rankup 命令 |
realpermissions.track.<track> |
对该升级路径使用 /rp promote 和 /rp demote |
来自 rankup.yml 的每个升级路径自身的 Permission |
可查看该升级路径。通过 GUI 创建的升级路径使用 realpermissions.rankup.<rankup>。 |
占位符
需要 PlaceholderAPI。
| 占位符 |
值 |
%realpermissions_rank_name% |
玩家的等级名称 |
%realpermissions_rank_prefix% |
玩家的等级前缀 |
%realpermissions_rank_permission_count% |
该等级拥有的权限数量 |
%realpermissions_timed_rank_time_left% |
限时等级剩余秒数,若无则为 none |
%realpermissions_player_permission_count% |
直接赋予该玩家的权限数量 |
要求
安装
- 将 jar 文件放入
plugins 文件夹。
- 重启服务器。
- 编辑
plugins/RealPermissions/ranks.yml(或使用 GUI)并运行 /rp reload。
- 如需使用 MySQL,请在
plugins/RealPermissions/sql.yml 中配置并重启。
需要帮助或发现了 Bug?
请勿在评论区提交 Bug 报告。请通过以下方式联系:
Discord | GitHub Issues
本插件使用 bStats 收集匿名使用统计数据。您可以在 plugins/bStats/config.yml 中关闭此功能。
RealPermissions
GUI Permission Management made easy.
Ranks, permissions, timed ranks, tracks and rankups, managed from a GUI or with commands.
Discord | Source Code | Report a Bug
What is RealPermissions?
RealPermissions is a permissions plugin you can run almost entirely from a GUI. Players get a rank, ranks get permissions and can inherit other ranks, and each rank has its own prefix and chat format. On top of that you can give a player permissions of their own, hand out ranks and permissions for a limited time, move players along rank tracks, and let players buy their next rank with /rankup.
Features
- GUI for everything: players, ranks, permissions, rankups and settings
- Permission inheritance between ranks
- Negated permissions (a node starting with
-) and wildcards (a node ending in *)
- Per-player permissions, on top of the player's rank
- Timed ranks and timed player permissions (e.g.
30m, 12h, 7d, 1d12h)
- Prefix and chat format per rank
- Prefix in the tab list, and the tab list sorted by rank weight
- Tracks: promote and demote players along an order of ranks, with a permission per track
- Rankup: players pay through Vault to move up a rankup path
/rp check explains where a player's permission comes from (their own, their rank, an inherited rank, a wildcard, super user, op or another plugin)
- Permissions of other plugins are read from their
plugin.yml, so you can pick them from a list instead of typing them
- Native integration with RealScoreboard, RealMines, RealRegions, RealSkywars, RealHoppers and RealLogin through the RealPermissions API
- Vault permission and chat provider, so other plugins see your ranks, permissions and prefixes
- Import from LuckPerms, PermissionsEx and GroupManager
- On 1.21.6+, native dialogs for typed input, settings and confirmations (uses chat on older versions)
- SQLite and MySQL storage for player data
- PlaceholderAPI placeholders
- Fully configurable YAML config, ranks, rankups and language files
Ranks
Ranks live in ranks.yml. Each rank has an icon, a prefix, a chat format, the ranks it inherits from and its own permissions. New players get the Default-Rank.
Rank example and options
Default-Rank: Player
Ranks:
VIP:
Icon: IRON_INGOT
Prefix: "&9VIP"
Chat: "%prefix% %player% &7- &f%message%"
Inheritance:
- Player
Permissions:
- essentials.afk
- -essentials.fly
| Option |
What it does |
Chat |
The chat format, with %prefix%, %player% and %message%. Turn it off with Chat-Formatting in config.yml. |
Inheritance |
The rank gets every permission of the ranks listed here. |
Permissions |
A node starting with - is taken away; a node ending in * gives everything under it. |
Weight (optional) |
Higher sorts first in the tab list. Without one, the weight is how many ranks it inherits from. Set it with /rp setweight. |
Tracks
A track is an order of ranks, lowest first, set in ranks.yml or with /rp settrack. /rp promote <player> <track> and /rp demote <player> <track> move a player one rank up or down it. Staff with realpermissions.track.<track> can use these on that one track, without being able to hand out any other rank. A player with a timed rank can't be moved until it runs out or is cleared.
Rankup
Rankups live in rankup.yml and need Vault with an economy plugin. A rankup is a path of ranks, each with a cost, and the first one costs 0. A player opens /rankup, picks a path and pays to move to the next rank on it. A rankup can have a Permission, so only some players see it. Rankups can also be added, edited and removed from the GUI.
Rankup example
Rankups:
VIPRankup:
Display-Name: "&bVIP &bRankup"
Icon: FILLED_MAP
Permission: RealPermissions.Rankup.VIPRankup
Description:
- '&fThis is a rankup exclusive for &bVIPs'
Entries:
- VIP=0
- VIP+=100000
- VIPPro=3000000
Super Users
A super user is a player set from the console with /rp setsuper <player>. Super users get realpermissions.admin and are the only players who can run the commands that change ranks and permissions in game (set a rank, timed ranks, add or remove permissions, delete a rank, manage tracks, import). The console can always run them.
Photos





Getting Started
- From the console, make yourself a super user:
/rp setsuper <your name>.
- Run
/rp in game to open the GUI.
- Open Ranks to add ranks, change their prefix and icon, and add permissions. Permissions from your other plugins can be picked from a list.
- Give a player a rank with
/rp setrank <player> <rank>, or from Players in the GUI.
- To let players buy ranks, install Vault and an economy plugin, and set up the paths in
rankup.yml or in the GUI.
- Coming from another permissions plugin? Run
/rp import <luckperms|pex|groupmanager> to see what would be imported, then add confirm.
Commands
Base commands: /realpermissions, /rp. All need realpermissions.admin unless said otherwise. "Super user" means a player must also be a super user; the console can always run it.
| Command |
Alias |
Description |
Who |
/rp |
|
Opens the GUI (in the console, shows plugin info) |
Admin |
/rp reload |
rl |
Reloads the config, language, ranks and rankups |
Admin |
/rp setrank <player> <rank> |
sr |
Sets a player's rank |
Super user |
/rp permission <add|remove> <rank> <permission> |
perm |
Changes a rank's permissions |
Super user |
/rp playerperm <add|remove> <player> <permission> [duration] |
pperm |
Changes a player's own permissions, for a time if a duration is given |
Super user |
/rp check <player> <permission> |
c |
Says whether the player has it, and why |
Admin |
/rankup |
/rk |
Opens the rankups |
realpermissions.rankup |
All commands
| Command |
Alias |
Description |
Who |
/rp settings |
|
Opens the settings |
Admin |
/rp rank <rank> |
r |
Opens a rank's editor |
Admin |
/rp ranks |
|
Opens the ranks list (in the console, lists the ranks) |
Admin |
/rp players |
plrs |
Opens the players list |
Admin |
/rp player <player> |
p |
Opens a player's permissions |
Admin |
/rp setsuper <player> |
setsu |
Turns super user on or off |
Console only |
/rp settimedrank <player> <rank> <seconds> |
str |
Gives a rank for a time; the old one comes back when it runs out |
Super user |
/rp cleartimedrank <player> |
ctr |
Ends a timed rank |
Super user |
/rp rename <rank> <new name> |
ren |
Renames a rank |
Admin |
/rp delete <rank> |
del |
Deletes a rank, except the default one |
Super user |
/rp setweight <rank> <weight|auto> |
sw |
Sets the rank's tab list weight |
Admin |
/rp tracks |
|
Lists the tracks |
Admin |
/rp settrack <track> <rank> <rank> [rank...] |
st |
Creates or replaces a track |
Super user |
/rp deltrack <track> |
dt |
Deletes a track |
Super user |
/rp promote <player> <track> |
|
Moves a player one rank up a track |
Super user or realpermissions.track.<track> |
/rp demote <player> <track> |
|
Moves a player one rank down a track |
Super user or realpermissions.track.<track> |
/rp import <luckperms|pex|groupmanager> [confirm] |
|
Shows what would be imported, and imports it with confirm. For LuckPerms, run /lp export first |
Super user |
/rp hooks |
hks |
Shows the plugins whose permissions RealPermissions knows |
Admin |
/rp hook <plugin> |
hk |
Opens one plugin's permissions |
Admin |
Permissions
| Permission |
Description |
realpermissions.admin |
The /rp commands and the GUI |
realpermissions.rankup |
The /rankup command |
realpermissions.track.<track> |
/rp promote and /rp demote on that track |
A rankup's own Permission from rankup.yml |
Can see that rankup. Rankups made in the GUI use realpermissions.rankup.<rankup>. |
Placeholders
Requires PlaceholderAPI.
| Placeholder |
Value |
%realpermissions_rank_name% |
The player's rank name |
%realpermissions_rank_prefix% |
The player's rank prefix |
%realpermissions_rank_permission_count% |
Number of permissions the rank has |
%realpermissions_timed_rank_time_left% |
Seconds left on the timed rank, or none |
%realpermissions_player_permission_count% |
Number of permissions given to the player directly |
Requirements
- Java 16+
- Optional: Vault (needed for rankup, together with an economy plugin, and to be Vault's permission and chat provider), PlaceholderAPI
Installation
- Put the jar in your
plugins folder.
- Restart the server.
- Edit
plugins/RealPermissions/ranks.yml (or use the GUI) and run /rp reload.
- For MySQL, set it in
plugins/RealPermissions/sql.yml and restart.
Need help or found a bug?
Please don't use the comments for bug reports. Get in touch through:
Discord | GitHub Issues
This plugin uses bStats to collect anonymous usage statistics. You can turn this off in plugins/bStats/config.yml.
评论 0
登录后参与评分
还没有评论,来抢沙发吧