ServerRoles

插件

· 作者 roguiii

轻量级的基于角色的权限与前缀管理器,支持继承、临时角色、聊天格式化、YAML/SQLite/MySQL 存储、PlaceholderAPI 支持以及开发者 API。

0 本站下载 0 关注 更新于 1 个月前

最新 2.1.0+mc26.3 · 26.3 · Paper / Purpur

一键开服(送7天)

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 标志。

安装

  1. 需要 Paper 或 Purpur 26.3 和 Java 25(2.0.0 运行于 26.2,1.x 运行于 1.21.x)。
  2. 可选:安装 PlaceholderAPI 以支持占位符输出。
  3. 将 ServerRoles-2.0.0.jar 放入 plugins/ 目录,启动服务器以生成 config.yml。
  4. 选择一种存储后端,设置你的 default-role,然后运行 /role reload。

依赖

插件 用途
PlaceholderAPI 可选的占位符输出支持。

HikariCP(用于 SQLite/MySQL)已着色嵌入到 jar 包中;无需额外安装。

支持 / 源码

源码和问题反馈:

许可证

根据 GNU 通用公共许可证 v3.0 发布。请参阅 LICENSE。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源