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 |
架构指南详细解释了模型。
入门指南
- 从 Modrinth 或
Hangar 下载适合你平台的 Gradeway。
- 下载数据库驱动程序并将其放置在
drivers/ 文件夹中。
- 启动服务器并在生成的配置文件中填写你的数据库凭据。
完整的安装指南涵盖了所有平台和选项。
我需要哪种设置?
| 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
vip for 30 days, or pause a staff role while they're on break
without losing it.
- Know exactly why someone has a permission –
/gradeway why shows the full chain (player → role → group →
template), and /gradeway whocan lists everyone who has it.
- Promotion tracks – define a ladder like
trial → mod → admin and 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
vip or mod is 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
admin inherit everything from mod, 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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧