Ez-Rankview

插件

· 作者 mrfrench

一个 LuckPerms 插件,让管理员在测试权限时更容易切换角色

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

需要前置:LuckPerms

最新 1.0.0 · 26.3 · Bukkit / Folia

一键开服(送7天)

Ez-RankView

Build

一个 LuckPerms 插件,让管理员在测试权限时切换排名变得前所未有的简单,适用于 Purpur / Paper 1.21.x。它允许员工在不永久更改任何人权限的情况下预览排名 —— 非常适合查看新排名的外观,或在玩家之间切换排名以进行比较。

预览效果:

  • 将目标组的解析前缀/后缀复制到玩家身上,使聊天标签实际可见,并且
  • (可选)在预览活动期间授予该组的权限。

它是纯添加性的 —— 玩家的现有组和节点永远不会被触碰。所有添加的节点都会在预览停止时被移除。临时节点还带有过期时间(可配置),以便服务器崩溃后能自动清理。

目录

要求

项目 版本
服务器 Purpur / Paper 1.21.x
Java 21+
LuckPerms 已安装并运行(任何 5.x 版本)

构建

包含 Maven 包装器,因此您无需安装 Maven:

./mvnw clean package

编译后的插件位于 target/Ez-RankView-1.0.0.jar。

安装

  1. 构建插件(或获取发布版 jar)。
  2. 将 Ez-RankView-<version>.jar 放入服务器的 plugins/ 文件夹中。
  3. 重启服务器。必须安装 LuckPerms。
  4. 在游戏中运行 /rankview list 以确认组已被检测。

命令

基础命令:/rankview(别名:/rv, /rankpreview)。

命令 功能
/rankview <group> 对自己预览 <group>。再次运行则停止。
/rankview <group> <player> 对其他玩家预览 <group>。
/rankview stop [player] 停止预览(自己或指定玩家)。
/rankview list 列出 LuckPerms 组和当前活动的预览。
/rankview reload 重新加载 config.yml。

如果已有活动预览,预览不同组会自动切换到新组。

权限

权限 默认值 允许的操作
ezrankview.use op 对自己预览排名、列出组。
ezrankview.others op 为其他玩家应用/清除预览。
ezrankview.reload op 重新加载配置。
ezrankview.admin op 授予以上所有权限。

配置 (config.yml)

preview:
  apply-permissions: true      # 同时预览组的权限
  apply-chat-meta: true        # 复制组的前缀/后缀以使标签显示
  priority-offset: 1000        # 优先级提升,使预览超越真实前缀
  expire-after-seconds: 3600   # 临时节点的崩溃安全过期时间(0 = 直到停止)
  restore-on-quit: true        # 玩家登出时清除预览

所有消息均可在 messages: 下编辑,支持 & 颜色代码以及以下占位符:%group%、%player%、%prefix%、%error%。

工作原理

底层使用 LuckPerms API。当预览开始时:

  1. 从缓存的元数据中读取目标组的解析前缀/后缀,
  2. 在更高优先级下向玩家添加匹配的 prefix/suffix 节点,
  3. (可选)添加临时的 group.<name> 继承节点以获取权限,并且
  4. 记住它添加的确切节点。

停止预览会精确移除这些节点。玩家的数据没有其他改变,restore-on-quit 加上节点过期使得残留预览几乎不可能发生。

备注

  • 预览是添加性的,因此玩家在预览期间保留其真实权限(预览排名的权限叠加在上面)。这使得它在活跃玩家身上使用非常安全。
  • 插件仅理解 LuckPerms 本身解析的内容。如果您的聊天/标签页/名称标签格式化由其他插件处理,只要该插件读取 LuckPerms 前缀(大多数都如此),它就会显示预览。

许可证

根据 MIT 许可证 发布。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源