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(必需 —— 如果没有它,插件将无法启用,并在控制台中明确提示) |
安装
- 将插件 jar 文件放入服务器的
plugins/ 文件夹中。
- 确保 LuckPerms 也在同一文件夹中 —— 没有它,LuckpermsGUI 不会启动。
- 重启服务器(仅重载插件不足以完成全新安装)。
- 授予
luckpermsgui.admin 权限给有权访问的管理员 —— 默认仅对操作员开放。
- 在游戏中运行
/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 书面许可,不得在其他地方重新分发、转售或重新上传。
链接
与 LuckPerms 项目无关。
LuckpermsGUI
A chest-GUI administrative front end for LuckPerms — manage users, groups, tracks, contexts,
and the permission audit log entirely through in-game menus, with no need to memorize
/lp command syntax.
Overview
LuckpermsGUI is a standalone Paper plugin that puts LuckPerms permission, group, and track
management inside in-game chest inventories. It's built for server admins and staff who'd rather
click through a menu than remember exact /lp subcommand syntax — while still doing everything
through LuckPerms' own public API, so nothing it does is invisible to LuckPerms itself.
Every change you make — toggling a permission, reordering a promotion ladder, setting a group's
prefix — is written back through the same load-then-save path LuckPerms uses internally, and is
logged to LuckPerms' own action log. Run /lp log afterward and changes made through this GUI
look identical to changes made through LuckPerms' own commands.
This plugin has no dependencies besides LuckPerms itself, and shares no code or state with any
other plugin.
Features
- Launcher — one command,
/lpgui, opens a hub with six tiles: Users, Groups, Tracks,
Contexts, Action Log, System Tools.
- Users — browse or search every player LuckPerms knows about (online or not); manage groups,
primary group, and track promotion/demotion from a dashboard; edit permission nodes with an
optional expiry and context restriction; manage custom meta key/value pairs.
- Groups — create, delete, and browse every group on the server; edit weight, prefix, suffix,
and display name; manage parent groups; the same permission-node editor as Users.
- Tracks — build promotion ladders visually; reorder by clicking the group you want to move,
then clicking where it should go.
- Contexts — see the server's static context and any online player's currently active context
set (read-only diagnostic view).
- Action Log — browse the LuckPerms audit trail without leaving the GUI; filter by actor or
target name; force-refresh when you need the very latest entry.
- System Tools — sync permissions across your network in one click; jump straight into
LuckPerms' own web editor; purge locally cached permission data after a bulk change.
Requirements
|
|
| Server software |
Paper, or a Paper-based fork that maintains full Paper API compatibility (e.g. Purpur, Pufferfish). Not tested against Folia's regionized threading model — don't assume Folia compatibility. Not compatible with plain Spigot/Bukkit, since it uses Paper-exclusive APIs (Brigadier command registration, Paper's chat event). |
| Minecraft / Paper version |
Paper build 1.20.6 or newer — this is a hard floor, not a suggestion: the plugin uses LifecycleEvents.COMMANDS/BasicCommand, which doesn't exist on earlier Paper builds. Compiled and verified against 1.20.6 specifically; newer versions are expected to work (the plugin declares api-version: '1.20') but haven't been individually verified — check your own target version before relying on it in production. |
| Java |
21 |
| Dependencies |
LuckPerms (required — the plugin will not enable without it, and says so clearly in the console) |
Installation
- Drop the plugin jar into your server's
plugins/ folder.
- Make sure LuckPerms is in the same folder — LuckpermsGUI won't start without it.
- Restart the server (a plugin reload isn't enough for a fresh install).
- Grant
luckpermsgui.admin to whichever staff should have access — it defaults to operators only.
- Run
/lpgui in-game to open the Launcher.
Commands
Base command /lpgui, aliases /lpg and /luckpermsgui. Every subcommand requires
luckpermsgui.admin.
| Command |
Effect |
/lpgui |
Opens the Launcher GUI |
/lpgui menu |
Same as bare — explicit alias |
/lpgui open [player] |
Jumps straight to a player's dashboard |
/lpgui setgroup <player> <group> |
Sets a player's primary group (grants membership if needed) |
/lpgui addperm <player> <permission> |
Adds a permission node |
/lpgui removeperm <player> <permission> |
Removes a permission node |
/lpgui help |
Shows command usage as chat text |
Chat Input Syntax
Chest inventories can't take multi-field forms, so anywhere the GUI needs more than one value, it
accepts a single compact line typed in chat. Type cancel, or click the bundled Cancel link, to
back out — every prompt also times out after 30 seconds on its own.
| Context |
Syntax |
Example |
| Add permission |
key [true|false] [duration] [context=value] |
essentials.fly false 7d world=nether |
| Add group / parent |
group-name [duration] |
vip 30d |
| Add meta key |
key value |
guild Frostbite Raiders |
| Durations |
30s · 10m · 2h · 7d · 4w · 6mo · 1y |
one number, one unit |
Only the first value is ever required — everything else is optional.
How Permissions Work
Every permission node is one of exactly three states — this is just how LuckPerms itself stores
permissions, nothing invented:
- True — a stored node with
value = true
- Negated — a stored node with
value = false
- Unset — no node at all
Left-click a permission to flip True/Negated; right-click to unset it. The same rule applies
everywhere in the GUI: right-click generally means remove, left-click generally means toggle or
select.
Limitations, Honestly
- Runs on Paper 1.20.6+ only (see Requirements above) — not a limitation so much as a hard floor.
- One context restriction per permission node, not an arbitrary set.
- Prefix/suffix priority is fixed at 100 when set through the GUI — setting a new one replaces any
existing one rather than stacking multiple priorities.
- Group deletion doesn't hard-block on "this is someone's primary group" or "this group is on a
track" — the dashboard shows track membership before you delete, and deletion always needs two
clicks, but there's no automatic prevention.
- Meta values added via the simple chat syntax can't carry an expiry, since a value can contain
almost anything, including something that looks like a duration.
- The Action Log has no server-side search — LuckPerms' API returns the whole log at once, so
filtering happens client-side against a cached copy that refreshes at most every 45 seconds.
License
LuckpermsGUI is proprietary software distributed under the MuffDev EULA — see
LICENSE. In short: you may run it on any server you operate, including
commercial/monetized ones, but you may not redistribute, resell, or re-upload it elsewhere without
written permission from MuffDev.
Links
Not affiliated with the LuckPerms project.
评论 0
登录后参与评分
还没有评论,来抢沙发吧