LuckpermsGUI

插件

· 作者 MuffDogSupreme

一个用于 LuckPerms 的基于 GUI 的管理界面——无需记忆 /lp 命令语法,即可管理用户、组、轨道、上下文和审计日志。

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

需要前置:LuckPerms

最新 1.0.0 · 26.2 · Paper

一键开服(送7天)

LuckpermsGUI

LuckPerms 的箱子图形界面管理前端 —— 完全通过游戏内菜单管理用户、组、轨道、上下文
以及权限审计日志,无需记忆
/lp 命令语法。


概述

LuckpermsGUI 是一个独立的 Paper 插件,将 LuckPerms 的权限、组和轨道管理功能集成到游戏内的箱子库存中。它专为那些宁愿点击菜单也不愿记忆确切 /lp 子命令语法的服务器管理员和工作人员设计 —— 同时它仍通过 LuckPerms 自己的公共 API 执行所有操作,因此它对权限所做的任何更改都不会被 LuckPerms 本身忽略。

你所做的每一项更改 —— 切换权限、重新排列晋升阶梯、设置组的名称前缀 —— 都会通过 LuckPerms 内部使用的相同“加载-保存”路径写回,并记录到 LuckPerms 自己的操作日志中。之后运行 /lp log,通过此 GUI 进行的更改与通过 LuckPerms 自身命令进行的更改看起来完全相同。

本插件除了 LuckPerms 本身外没有任何依赖项,并且与其他任何插件不共享代码或状态。

功能特性

  • 启动器 —— 一条命令 /lpgui,即可打开包含六个图标的中心枢纽:用户 (Users)、组 (Groups)、轨道 (Tracks)、上下文 (Contexts)、操作日志 (Action Log) 和系统工具 (System Tools)。
  • 用户 (Users) —— 浏览或搜索 LuckPerms 已知的每位玩家(在线或离线);从仪表板管理组、主组和轨道晋升/降级;编辑权限节点,可选择设置过期时间和上下文限制;管理自定义元数据键值对。
  • 组 (Groups) —— 创建、删除和浏览服务器上的所有组;编辑权重、前缀、后缀和显示名称;管理父组;使用与用户相同的权限节点编辑器。
  • 轨道 (Tracks) —— 可视化构建晋升阶梯;点击要移动的组,然后点击其应放置的位置即可重新排序。
  • 上下文 (Contexts) —— 查看服务器的静态上下文以及任何在线玩家当前激活的上下文集(只读诊断视图)。
  • 操作日志 (Action Log) —— 在不离开 GUI 的情况下浏览 LuckPerms 审计追踪;按行为者或目标名称过滤;在需要最新条目时强制刷新。
  • 系统工具 (System Tools) —— 一键同步跨网络的权限;直接进入 LuckPerms 自身的 Web 编辑器;在批量更改后清除本地缓存的权限数据。

要求

服务端软件 Paper,或保持完整 Paper API 兼容性的 Paper 衍生版(例如 Purpur、Pufferfish)。未针对 Folia 的区域化线程模型进行测试 —— 请勿假设其与 Folia 兼容。不兼容普通的 Spigot/Bukkit,因为它使用了 Paper 独有的 API(Brigadier 命令注册、Paper 聊天事件)。
Minecraft / Paper 版本 Paper 构建 1.20.6 或更高版本 —— 这是硬性底线,而非建议:该插件使用了 LifecycleEvents.COMMANDS/BasicCommand,这在早期 Paper 构建中不存在。已在 1.20.6 上编译并验证;预计新版本也能正常工作(插件声明了 api-version: '1.20'),但尚未单独验证过这些版本 —— 在生产环境中依赖之前,请检查你自己的目标版本。
Java 21
依赖项 LuckPerms(必需 —— 如果没有它,插件将无法启用,并在控制台中明确提示)

安装

  1. 将插件 jar 文件放入服务器的 plugins/ 文件夹中。
  2. 确保 LuckPerms 也在同一文件夹中 —— 没有它,LuckpermsGUI 不会启动。
  3. 重启服务器(仅重载插件不足以完成全新安装)。
  4. 授予 luckpermsgui.admin 权限给有权访问的管理员 —— 默认仅对操作员开放。
  5. 在游戏中运行 /lpgui 以打开启动器。

命令

基础命令 /lpgui,别名 /lpg 和 /luckpermsgui。每个子命令都需要 luckpermsgui.admin 权限。

命令 效果
/lpgui 打开启动器 GUI
/lpgui menu 与裸命令相同 —— 显式别名
/lpgui open [player] 直接跳转到某玩家的仪表板
/lpgui setgroup <player> <group> 设置玩家的主组(如果需要则授予成员资格)
/lpgui addperm <player> <permission> 添加权限节点
/lpgui removeperm <player> <permission> 移除权限节点
/lpgui help 以聊天文本形式显示命令用法

聊天输入语法

箱子库存无法接受多字段表单,因此在 GUI 需要多个值的地方,它会接受在聊天中输入的单行紧凑内容。输入 cancel,或点击捆绑的取消链接,即可退出 —— 每个提示也会在 30 秒后自动超时。

上下文 语法 示例
添加权限 key [true|false] [duration] [context=value] essentials.fly false 7d world=nether
添加组 / 父组 group-name [duration] vip 30d
添加元数据键 key value guild Frostbite Raiders
持续时间 30s · 10m · 2h · 7d · 4w · 6mo · 1y 一个数字,一个单位

只有第一个值是必需的 —— 其他所有值都是可选的。

权限工作原理

每个权限节点恰好处于三种状态之一 —— 这只是 LuckPerms 本身存储权限的方式,并无创新:

  • True(真) —— 一个存储的节点,其 value = true
  • Negated(否定) —— 一个存储的节点,其 value = false
  • Unset(未设置) —— 没有任何节点

左键单击权限可在 True/Negated 之间切换;右键单击将其设为 Unset。GUI 中的其他位置也遵循相同规则:右键单击通常意味着移除,左键单击通常意味着切换或选择。

局限性,坦诚相告

  • 仅在 Paper 1.20.6+ 上运行(见上方的“要求”)——这与其说是限制,不如说是一个硬性最低版本要求。
  • 每个权限节点仅有一个上下文限制,而非任意组合。
  • 通过 GUI 设置时,前缀/后缀的优先级固定为 100 —— 设置新的优先级会替换任何现有优先级,而不是叠加多个优先级。
  • 删除群组时不会因“这是某人的主群组”或“该群组位于某个轨道上”而硬阻止 —— 仪表盘会在你删除前显示轨道成员关系,且删除操作始终需要两次点击,但系统不会自动防止此类操作。
  • 通过简易聊天语法添加的元数据值无法携带过期时间,因为一个值可以包含几乎任何内容,包括看起来像持续时间的字符串。
  • 操作日志没有服务器端搜索功能 —— LuckPerms 的 API 一次性返回整个日志,因此过滤是在客户端针对缓存副本进行的,该副本最多每 45 秒刷新一次。

许可证

LuckpermsGUI 是专有软件,根据 MuffDev EULA 分发 —— 请参阅 LICENSE。简而言之:你可以在你运营的任何服务器上运行它,包括商业/盈利性质的服务器,但未经 MuffDev 书面许可,不得在其他地方重新分发、转售或重新上传。

链接

  • Wiki:
  • Support:

与 LuckPerms 项目无关。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源