Gradeway
适用于 Paper、Bukkit、Velocity 和 BungeeCord 的现代权限插件——共享一个数据库,所有服务器实时同步。
从单一位置管理整个网络的头衔、权限和临时角色。 来自 LuckPerms?一条命令即可导入现有数据。
为什么选择 Gradeway?
- 整个网络始终同步 – 在一台服务器上更改头衔后,所有连接的服务器会立即获取更新,无需重启或手动重载。
- 可暂停的临时头衔 – 给某人
vip头衔 30 天,或者在他们休息时暂停工作人员角色而不会丢失该角色。 - 清楚知道某人拥有某项权限的原因 –
/gradeway why显示完整的链(玩家 → 角色 → 组 → 模板),/gradeway whocan列出所有拥有该权限的人。 - 晋升轨道 – 定义如
trial → mod → admin这样的阶梯,并沿此阶梯提升或降级玩家。 - 权限模板 – 一次性构建一套可重用的权限集,并将其应用于任何角色或玩家。
- 默认安全 – 破坏性命令需要确认,完整备份可以通过一条命令导出和导入。
- 与你现有的配置兼容 – 接入你已经在运行的数据库,从单服务器的 SQLite 到整个网络的 MySQL 或 Postgres。
工作原理
Gradeway 围绕几个简单的理念构建:
- 玩家获得角色。 像
vip或mod这样的角色是一组权限的集合。给予玩家一个角色——永久性或限时——他们就会获得其中的所有内容。 - 角色可以相互继承。 让
admin继承mod的所有内容,将相关角色放入组中以共享权限,或在任何需要相同设置的地方重用模板。 - 每台服务器共享一个数据库。 在一台服务器上更改某些内容,Gradeway 会通知其他所有服务器,从而使整个网络立即更新。
Steve ──► vip (30 days) ──► essentials.fly
│ └─► essentials.home
└─► default ────────► essentials.spawn
当 Steve 运行命令时,Gradeway 会检查他的所有角色并回答一个问题:他是否被允许?如果你想知道为什么答案是是或否,/gradeway why 会显示它经过的路径。
实际操作
/gradeway role create vip
/gradeway role modify vip permissions set essentials.fly
/gradeway player modify Steve roles add vip 30D
/gradeway why Steve essentials.fly
来自 LuckPerms?
在 LuckPerms 中运行 /lp export,然后将文件导入 Gradeway:
/gradeway migrate luckperms <file>
需要注意的是:LuckPerms 中的“组”在 Gradeway 中称为_角色_。
| LuckPerms | Gradeway |
|---|---|
Group (admin, default, …) |
Role |
| Parent groups | Role parents |
| Primary group | Primary role |
| Track | Track |
| no equivalent | Group – a container that lets several roles share permissions and a default weight |
架构指南详细解释了模型。
入门指南
完整的安装指南涵盖了所有平台和选项。
我需要哪种设置?
| Your setup | Database | Messaging |
|---|---|---|
| One server | SQLite or H2 – no database server needed | Not needed, you can turn it off |
| Proxy + a few servers | MySQL, MariaDB, or Postgres | Plugin Messaging (built in) or Redis |
| Large network | MySQL, MariaDB, or Postgres | Redis |
插件消息传递不需要任何额外软件,但它只能在玩家在线时到达服务器。Redis 始终保持所有服务器同步,因此一旦网络扩大,它是更好的选择。
兼容性
| Supported | |
|---|---|
| Servers | Paper, Bukkit (26.1+) |
| Proxies | Velocity, BungeeCord |
| Databases | Postgres, MySQL, MariaDB, SQLite, SQL Server, Oracle, H2 |
| Messaging | Redis, Plugin Messaging |
查看兼容性文档以获取完整概览。
对于开发者
Gradeway 拥有公开 API,包含事件、Actor 跟踪和自定义属性类型。 请参阅开发者指南和 API 参考。
许可证
Gradeway 根据 MIT License 授权。
Gradeway
A modern permission plugin for Paper, Bukkit, Velocity, and BungeeCord – one shared database, every server in sync.
Manage ranks, permissions, and temporary roles across your entire network from a single place.
Coming from LuckPerms? Import your existing data with one command.
Why Gradeway?
- Your whole network, always in sync – change a rank on one server and every connected server picks it up instantly, no restarts or manual reloads.
- Temporary and pausable ranks – give someone
vipfor 30 days, or pause a staff role while they're on break without losing it. - Know exactly why someone has a permission –
/gradeway whyshows the full chain (player → role → group → template), and/gradeway whocanlists everyone who has it. - Promotion tracks – define a ladder like
trial → mod → adminand promote or demote players along it. - Permission templates – build a reusable set of permissions once and apply it to any role or player.
- Safe by default – destructive commands ask for confirmation, and full backups export and import with one command.
- Works with what you already have – plug in the database you already run, from SQLite on a single server to MySQL or Postgres for a whole network.
How it works
Gradeway is built around a few simple ideas:
- Players get roles. A role like
vipormodis a bundle of permissions. Give a player a role – forever or for a limited time – and they get everything in it. - Roles can build on each other. Let
admininherit everything frommod, put related roles into a group so they share permissions, or reuse a template wherever you need the same set again. - Every server shares one database. Change something on one server and Gradeway tells all the others, so the whole network updates right away.
Steve ──► vip (30 days) ──► essentials.fly
│ └─► essentials.home
└─► default ────────► essentials.spawn
When Steve runs a command, Gradeway looks at all his roles and answers one question: is he allowed? If you ever
wonder why the answer is yes or no, /gradeway why shows you the path it took.
See it in action
/gradeway role create vip
/gradeway role modify vip permissions set essentials.fly
/gradeway player modify Steve roles add vip 30D
/gradeway why Steve essentials.fly
Coming from LuckPerms?
Run /lp export in LuckPerms, then import the file into Gradeway:
/gradeway migrate luckperms <file>
One thing to know: what LuckPerms calls a "group" is a role in Gradeway.
| LuckPerms | Gradeway |
|---|---|
Group (admin, default, …) |
Role |
| Parent groups | Role parents |
| Primary group | Primary role |
| Track | Track |
| no equivalent | Group – a container that lets several roles share permissions and a default weight |
The architecture guide explains the model in detail.
Getting started
- Download Gradeway for your platform from Modrinth or Hangar.
- Download the driver for your database and place it in the
drivers/folder. - Start your server and fill in your database credentials in the generated config.
The full installation guide covers every platform and option.
Which setup do I need?
| Your setup | Database | Messaging |
|---|---|---|
| One server | SQLite or H2 – no database server needed | Not needed, you can turn it off |
| Proxy + a few servers | MySQL, MariaDB, or Postgres | Plugin Messaging (built in) or Redis |
| Large network | MySQL, MariaDB, or Postgres | Redis |
Plugin Messaging works without any extra software, but it can only reach a server while a player is online there. Redis keeps every server in sync at all times, so it's the better choice once your network grows.
Compatibility
| Supported | |
|---|---|
| Servers | Paper, Bukkit (26.1+) |
| Proxies | Velocity, BungeeCord |
| Databases | Postgres, MySQL, MariaDB, SQLite, SQL Server, Oracle, H2 |
| Messaging | Redis, Plugin Messaging |
See the compatibility documentation for the full overview.
For developers
Gradeway has a public API with events, actor tracking, and custom attribute types. See the developer guide and the API reference.
License
Gradeway is licensed under the MIT License.
下载 Gradeway
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Gradeway
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Gradeway
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Gradeway
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Gradeway
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Gradeway
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Gradeway
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Gradeway
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Gradeway
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Gradeway
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
更新内容
- chore(deps): 由 @renovate[bot] 在 中将 Gradle 更新至 v9.9.0
- fix(deps): 由 @renovate[bot] 在 中更新 Gradle 依赖(次要/补丁版本)
- feat: 由 @RealBauHD 在 中添加可配置的翻译默认语言环境
完整更新日志:
更新内容
- 由 @renovate[bot] 在 中将依赖 io.papermc.paper:paper-api 更新至 v26.3-rc-3.build.1-alpha
- 由 @renovate[bot] 在 中更新 gradle 依赖(次要/补丁版本)
- 由 @renovate[bot] 在 中更新 gradle 依赖(次要/补丁版本)
- 由 @renovate[bot] 在 中更新 gradle 依赖(次要/补丁版本)
- 由 @renovate[bot] 在 中将依赖 org.mariadb.jdbc:mariadb-java-client 更新至 v4
- 由 @renovate[bot] 在 中更新 gradle 依赖(次要/补丁版本)
- 由 @RealBauHD 在 中添加 Modrinth 版本号并增加支持的 Velocity 版本
新贡献者
- @RealBauHD 在 中完成了首次贡献
完整更新日志:
未指定更新日志。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧