ServerRoles
适用于 Paper/Purpur 26.3(Java 25)的现代、轻量级基于角色的权限管理器。
版本 2.1.0 · Minecraft 26.3 · 服务端
ServerRoles 通过单个 /role 命令管理角色、权限、前缀和聊天格式。角色支持十六进制颜色前缀、继承、优先级、OP 标志,以及永久或临时的玩家分配。存储可在 YAML、SQLite 和 MySQL 之间切换。
功能
- 角色管理。 创建和删除角色;设置前缀、十六进制颜色、OP 标志、优先级和权限。
- 继承。 角色可从父角色继承;权限自下而上解析(子角色覆盖父角色),否定节点以
- 为前缀。循环继承会在加载时及设置父角色时被检测。
- 玩家分配。 永久或临时(例如
1d、24h、1d12h)分配角色;临时角色由重复的主线程任务过期处理。
- 聊天格式。 可选择使用玩家的角色前缀和颜色格式化聊天。
- 可插拔存储。 支持 YAML、SQLite 或 MySQL(HikariCP,已着色并重新定位)。
- PlaceholderAPI 扩展。 用于角色数据。
- 开发者 API。
ServerRolesProvider 暴露了 API;PlayerRoleChangeEvent 可取消。
- 本地化。 内置
en_US 和 pt_PT(MiniMessage)。如果缺失会自动创建默认角色,且无法删除。
命令
单个命令 /role,别名 /roles 和 /sr。所有子命令均需 serverroles.admin 权限。
| 命令 |
描述 |
权限 |
/role create <id> <displayName> <priority> |
创建角色。 |
serverroles.admin |
/role delete <id> |
删除角色。 |
serverroles.admin |
/role list |
列出所有角色。 |
serverroles.admin |
/role info <id> |
显示角色详情。 |
serverroles.admin |
/role setprefix <id> <prefix> |
设置角色的前缀。 |
serverroles.admin |
/role setcolor <id> <#rrggbb> |
设置角色的十六进制颜色。 |
serverroles.admin |
/role setop <id> <true|false> |
设置角色的 OP 标志。 |
serverroles.admin |
/role setpriority <id> <number> |
设置角色的优先级。 |
serverroles.admin |
/role setparent <id> <parentId> |
设置角色的父角色以用于继承。 |
serverroles.admin |
/role addperm <id> <node> |
向角色添加权限节点。 |
serverroles.admin |
/role removeperm <id> <node> |
从角色移除权限节点。 |
serverroles.admin |
/role listperms <id> |
列出角色的权限节点。 |
serverroles.admin |
/role assign <player> <id> |
将角色分配给玩家。 |
serverroles.admin |
/role assigntemp <player> <id> <duration> |
分配临时角色。 |
serverroles.admin |
/role remove <player> |
将玩家重置为默认角色。 |
serverroles.admin |
/role check <player> |
检查玩家的角色。 |
serverroles.admin |
/role reload |
重载配置、角色和玩家数据。 |
serverroles.admin |
/role papi |
显示 PlaceholderAPI 注册状态。 |
serverroles.admin |
权限
| 节点 |
描述 |
默认值 |
serverroles.admin |
访问所有 ServerRoles 管理员命令。 |
op |
serverroles.user |
基本用户权限。 |
true |
配置
language: en_US # 内置:en_US, pt_PT
default-role: player # 分配给新玩家的初始角色;也是重置目标
storage:
type: yaml # yaml | sqlite | mysql
mysql:
host: localhost
port: 3306
database: serverroles
username: root
password: password
features:
chat-format: true # 使用玩家的角色前缀和颜色格式化聊天
安全须知
ServerRoles 会应用角色携带的所有权限节点,并且角色 OP 状态通过 player.setOp(...) 应用。请注意以下操作要点:
- 只有一个管理员节点 (
serverroles.admin),内部无层级结构。向工作人员角色授予 serverroles.admin(或 OP 角色)实际上等于授予对该插件的完全控制权,包括分配 OP 的能力。请勿将 serverroles.admin、* 或授予 op 的节点添加到非信任角色中。
- OP 状态通过 Bukkit 的
ops.json 进行应用和清除。建议仅通过此插件管理 OP,并避免在临时角色上使用 OP 标志。
安装
- 需要 Paper 或 Purpur 26.3 和 Java 25(2.0.0 运行于 26.2,1.x 运行于 1.21.x)。
- 可选:安装 PlaceholderAPI 以支持占位符输出。
- 将
ServerRoles-2.0.0.jar 放入 plugins/ 目录,启动服务器以生成 config.yml。
- 选择一种存储后端,设置你的
default-role,然后运行 /role reload。
依赖
| 插件 |
用途 |
| PlaceholderAPI |
可选的占位符输出支持。 |
HikariCP(用于 SQLite/MySQL)已着色嵌入到 jar 包中;无需额外安装。
支持 / 源码
源码和问题反馈:
许可证
根据 GNU 通用公共许可证 v3.0 发布。请参阅 LICENSE。
ServerRoles
A modern, lightweight role-based permission manager for Paper/Purpur 26.3 (Java 25).
Version 2.1.0 · Minecraft 26.3 · Server-side
ServerRoles manages roles, permissions, prefixes and chat formatting through a single /role
command. Roles support hex-color prefixes, inheritance, priorities, an OP flag, and both permanent
and temporary player assignments. Storage is pluggable between YAML, SQLite and MySQL.
Features
- Role management. Create and delete roles; set prefix, hex color, OP flag, priority and
permissions.
- Inheritance. Roles inherit from a parent; permissions resolve bottom-up (child overrides
parent) with negated nodes prefixed by
-. Circular inheritance is detected at load time and
when setting a parent.
- Player assignments. Assign roles permanently or temporarily with a duration (e.g.
1d, 24h,
1d12h); temporary roles are expired by a repeating main-thread task.
- Chat formatting. Optionally format chat with the player's role prefix and color.
- Pluggable storage. YAML, SQLite or MySQL (HikariCP, shaded and relocated).
- PlaceholderAPI expansion for role data.
- Developer API.
ServerRolesProvider exposes the API; PlayerRoleChangeEvent is cancellable.
- Localization. Bundled
en_US and pt_PT (MiniMessage). A default role is auto-created if
missing and cannot be deleted.
Commands
Single command /role with aliases /roles and /sr. All subcommands require
serverroles.admin.
| Command |
Description |
Permission |
/role create <id> <displayName> <priority> |
Create a role. |
serverroles.admin |
/role delete <id> |
Delete a role. |
serverroles.admin |
/role list |
List all roles. |
serverroles.admin |
/role info <id> |
Show role details. |
serverroles.admin |
/role setprefix <id> <prefix> |
Set a role's prefix. |
serverroles.admin |
/role setcolor <id> <#rrggbb> |
Set a role's hex color. |
serverroles.admin |
/role setop <id> <true|false> |
Set a role's OP flag. |
serverroles.admin |
/role setpriority <id> <number> |
Set a role's priority. |
serverroles.admin |
/role setparent <id> <parentId> |
Set a role's parent for inheritance. |
serverroles.admin |
/role addperm <id> <node> |
Add a permission node to a role. |
serverroles.admin |
/role removeperm <id> <node> |
Remove a permission node from a role. |
serverroles.admin |
/role listperms <id> |
List a role's permission nodes. |
serverroles.admin |
/role assign <player> <id> |
Assign a role to a player. |
serverroles.admin |
/role assigntemp <player> <id> <duration> |
Assign a temporary role. |
serverroles.admin |
/role remove <player> |
Reset a player to the default role. |
serverroles.admin |
/role check <player> |
Check a player's role. |
serverroles.admin |
/role reload |
Reload config, roles and players. |
serverroles.admin |
/role papi |
Show PlaceholderAPI registration status. |
serverroles.admin |
Permissions
| Node |
Description |
Default |
serverroles.admin |
Access to all ServerRoles admin commands. |
op |
serverroles.user |
Basic user permission. |
true |
Configuration
language: en_US # bundled: en_US, pt_PT
default-role: player # given to new players; also the reset target
storage:
type: yaml # yaml | sqlite | mysql
mysql:
host: localhost
port: 3306
database: serverroles
username: root
password: password
features:
chat-format: true # format chat with the player's role prefix and color
Security notes
ServerRoles applies whatever permission nodes a role carries, and role OP status is applied with
player.setOp(...). Keep these operational points in mind:
- There is a single admin node (
serverroles.admin) with no internal hierarchy. Granting
serverroles.admin (or an OP role) to a staff role effectively grants full control of the plugin,
including the ability to assign OP. Do not add serverroles.admin, * or op-granting nodes to
non-trusted roles.
- OP is applied and cleared through Bukkit's
ops.json. Prefer to manage OP exclusively through
this plugin, and avoid the OP flag on temporary roles.
Installation
- Requires Paper or Purpur 26.3 and Java 25 (2.0.0 runs on 26.2, 1.x on 1.21.x).
- Optional: PlaceholderAPI for placeholder output.
- Drop
ServerRoles-2.0.0.jar into plugins/ and start the server to generate config.yml.
- Choose a storage backend, set your
default-role, then run /role reload.
Dependencies
| Plugin |
Purpose |
| PlaceholderAPI |
Optional placeholder output. |
HikariCP (for SQLite/MySQL) is shaded into the jar; no extra install is required.
Support / Source
Source and issues:
License
Released under the GNU General Public License v3.0. See LICENSE.
评论 0
登录后参与评分
还没有评论,来抢沙发吧