LuckPermsGUIPlus
一款功能全面的 Minecraft 插件,通过游戏内菜单提供直观的用户图形界面,用于管理 LuckPerms 权限。
?️ 制作中...
此插件尚未完全完成!如果您遇到任何错误,请与我联系。
⏳ 即将推出
[付费] [完成度 90%] LuckPerms AI 助手 — 自动审查并优化您的权限设置!
[免费] [已完成] 增强型日志系统 — 获得全面的可见性和控制权!
[免费] [完成度 80%] 权限预设(按插件)- 选择已安装的插件、组类型即可搞定!
……更多强大工具即将推出……
功能特性
? 核心功能
- 组管理:创建、编辑、删除、复制和重命名权限组
- 权限管理:添加、移除、切换和修改带有上下文限制的权限
- 玩家管理:查看和管理单个玩家的权限
- 高级搜索:在所有组或特定组内搜索权限
- 上下文支持:为权限添加世界、服务器或自定义上下文限制
- 临时权限:设置带有过期时间的权限
? 用户界面
- 直观 GUI:整洁、有条理的菜单,导航清晰
- 视觉指示器:颜色编码的权限状态(启用/禁用/临时/继承)
- 分页处理:高效处理大量的组和权限
- AnvilGUI 集成:平滑的文字输入体验,适用于名称、权限和上下文
- 响应式设计:合理的按钮布局和菜单流程
? 技术特性
- 实时缓存:高效的权限数据缓存与自动刷新
- 上下文管理:追踪哪些权限属于哪些组
- 日志记录:全面的行动日志,便于审计追踪
- 配置:高度可定制的 GUI 元素和消息
- 性能:针对大型权限数据库进行了优化
安装
- 确保您的服务器上已安装 LuckPerms
- 从发布页面下载最新的 LuckPermsGUIPlus.jar
- 将 jar 文件放入服务器的
plugins/ 目录
- 重启服务器或使用插件管理器加载该插件
配置
插件在首次启动时会创建一个 config.yml 文件,其中包含可自定义的选项:
配置
# LuckPermsGUIPlus Configuration
# GUI Settings
gui:
title:
main: "LuckPerms Groups"
group: "Permissions of %group%"
permission: "Edit Permission"
search: "Search Results"
players: "Players"
player_permissions: "Permissions of %player%"
items:
# Main Menu Items
group: "BOOK"
create_group: "EMERALD_BLOCK"
players: "PLAYER_HEAD"
search: "COMPASS"
close: "BARRIER"
# Navigation Items
previous_page: "ARROW"
next_page: "ARROW"
back: "BARRIER"
# Group Menu Items
add_permission: "EMERALD"
search_permissions: "COMPASS"
# Permission Status Items
enabled: "GREEN_WOOL"
disabled: "RED_WOOL"
temporary: "CLOCK"
inherited: "ENCHANTED_BOOK"
# Permission Action Items
toggle_permission: "LEVER"
edit_permission: "WRITABLE_BOOK"
# Permission Edit Menu Items
status_enabled: "GREEN_WOOL"
status_disabled: "RED_WOOL"
make_temporary_button: "CLOCK"
add_context_button: "GRASS_BLOCK"
delete_button: "BARRIER"
# Group Options Menu Items
duplicate_group: "COPY"
delete_group: "TNT"
rename_group: "NAME_TAG"
edit_prefix: "GOLDEN_APPLE"
edit_suffix: "GOLDEN_CARROT"
edit_display_name: "PAPER"
edit_icon: "ITEM_FRAME"
# Search Menu Items
search_groups: "BOOK"
search_players: "PLAYER_HEAD"
search_all: "SPYGLASS"
# Player Menu Items
player_info: "PLAYER_HEAD"
player_permissions: "WRITABLE_BOOK"
# Context Menu Items
add_context: "GRASS_BLOCK"
remove_context: "DIRT"
context_world: "GRASS_BLOCK"
context_server: "COMMAND_BLOCK"
lore:
group_permissions: "Permissions: %count%"
permission_status: "Status: %status%"
permission_context: "Context: %context%"
permission_expiry: "Expiry: %expiry%"
inherited_from: "Inherited from %group%"
# Messages
messages:
no_permission: "You do not have permission to use this command."
group_created: "Group '%group%' created successfully."
group_deleted: "Group '%group%' deleted successfully."
permission_added: "Permission '%permission%' added to group '%group%'."
permission_removed: "Permission '%permission%' removed from group '%group%'."
permission_toggled: "Permission '%permission%' toggled in group '%group%'."
search_no_results: "No permissions found matching '%query%'."
invalid_group: "Group '%group%' does not exist."
invalid_permission: "Invalid permission format."
# Cache Settings
cache:
refresh_interval: 30 # seconds
# Logging
logging:
enabled: true
file: "history.log"
# Theme (light/dark)
theme: "dark"
用法
打开 GUI
- 使用命令
/luckpermsgui 或 /lpgui
- 玩家需要拥有
luckpermsgui.open 权限
导航
- 主菜单:列出所有权限组
- 组菜单:显示特定组的权限
- 权限菜单:编辑单个权限设置
- 玩家菜单:管理玩家专属权限
- 搜索:跨组查找权限
组操作
- 左键点击:打开组权限菜单
- 右键点击:访问组选项(复制、删除、重命名等)
- 创建组:添加新的权限组
- 搜索:在组内查找特定权限
权限操作
- 左键点击:切换权限开/关
- 右键点击:打开详细权限菜单
- 添加权限:向组授予新权限
- 编辑详情:修改上下文、过期时间等
命令
| 命令 |
描述 |
权限 |
/luckperms |
打开主图形界面 |
luckpermsgui.open |
权限
| 权限 |
描述 |
默认值 |
luckpermsgui.open |
访问主图形界面 |
op |
API
LuckPermsGUIPlus 提供了一个简单的 API,用于与其他插件集成:
API 示例
import fr.arockenbauer.luckpermsgui.LuckPermsGUIPlus;
import fr.arockenbauer.luckpermsgui.gui.MainMenu;
// 获取插件实例
LuckPermsGUIPlus plugin = LuckPermsGUIPlus.getInstance();
// 为玩家打开 GUI
new MainMenu(player).open();
依赖项
- LuckPerms 5.0+
- AnvilGUI(已包含)
- Bukkit/Spigot/Paper 1.20+(旧版本未经测试,可能可用但官方不支持)
支持
许可证
本项目采用自定义 许可证。
更新日志
版本 1.0.0
- 首次发布
- 完整的 LuckPerms 管理 GUI 系统
- 使用 AnvilGUI 实现文本输入功能
- 支持上下文和临时权限设置
- 玩家权限管理
- 高级搜索功能
- 完善的日志记录与缓存机制
致谢
- 开发者: Axel Rockenbauer
- AnvilGUI: WesJD
- LuckPerms: Luck
注意:
本插件并非由 LuckPerms 原作者创建或维护!
请勿将与此插件相关的问题报告给 Luck!请直接联系我。
LuckPermsGUIPlus
A comprehensive Minecraft plugin that provides an intuitive graphical user interface for managing LuckPerms permissions through in-game menus.
?️ Crafting...
This plugin is not fully finished ! Please contact me if you encounter any bugs.
⏳ Coming Soon
[Premium] [90% done] AI Assistant for LuckPerms — Automatically reviews and improves your permission setup !
[Free] [Done] Enhanced Logging System — Gain full visibility and control !
[Free] [80% done] Permission presets (Per-plugin) - Select installed plugins, group type and you're done !
…and more powerful tools are coming soon...
Features
? Core Functionality
- Group Management: Create, edit, delete, duplicate, and rename permission groups
- Permission Management: Add, remove, toggle, and modify permissions with context restrictions
- Player Management: View and manage individual player permissions
- Advanced Search: Search permissions across all groups or within specific groups
- Context Support: Add world, server, or custom context restrictions to permissions
- Temporary Permissions: Set permissions with expiration times
? User Interface
- Intuitive GUI: Clean, organized menus with clear navigation
- Visual Indicators: Color-coded permissions (enabled/disabled/temporary/inherited)
- Pagination: Handle large numbers of groups and permissions efficiently
- AnvilGUI Integration: Smooth text input for names, permissions, and contexts
- Responsive Design: Proper button placement and menu flow
? Technical Features
- Real-time Caching: Efficient permission data caching with automatic refresh
- Context Management: Track which permissions belong to which groups
- Logging: Comprehensive action logging for audit trails
- Configuration: Highly customizable GUI elements and messages
- Performance: Optimized for large permission databases
Installation
- Ensure you have LuckPerms installed on your server
- Download the latest LuckPermsGUIPlus.jar from the releases
- Place the jar file in your server's
plugins/ directory
- Restart your server or use a plugin manager to load the plugin
Configuration
The plugin creates a config.yml file on first startup with customizable options:
Configuration
# LuckPermsGUIPlus Configuration
# GUI Settings
gui:
title:
main: "LuckPerms Groups"
group: "Permissions of %group%"
permission: "Edit Permission"
search: "Search Results"
players: "Players"
player_permissions: "Permissions of %player%"
items:
# Main Menu Items
group: "BOOK"
create_group: "EMERALD_BLOCK"
players: "PLAYER_HEAD"
search: "COMPASS"
close: "BARRIER"
# Navigation Items
previous_page: "ARROW"
next_page: "ARROW"
back: "BARRIER"
# Group Menu Items
add_permission: "EMERALD"
search_permissions: "COMPASS"
# Permission Status Items
enabled: "GREEN_WOOL"
disabled: "RED_WOOL"
temporary: "CLOCK"
inherited: "ENCHANTED_BOOK"
# Permission Action Items
toggle_permission: "LEVER"
edit_permission: "WRITABLE_BOOK"
# Permission Edit Menu Items
status_enabled: "GREEN_WOOL"
status_disabled: "RED_WOOL"
make_temporary_button: "CLOCK"
add_context_button: "GRASS_BLOCK"
delete_button: "BARRIER"
# Group Options Menu Items
duplicate_group: "COPY"
delete_group: "TNT"
rename_group: "NAME_TAG"
edit_prefix: "GOLDEN_APPLE"
edit_suffix: "GOLDEN_CARROT"
edit_display_name: "PAPER"
edit_icon: "ITEM_FRAME"
# Search Menu Items
search_groups: "BOOK"
search_players: "PLAYER_HEAD"
search_all: "SPYGLASS"
# Player Menu Items
player_info: "PLAYER_HEAD"
player_permissions: "WRITABLE_BOOK"
# Context Menu Items
add_context: "GRASS_BLOCK"
remove_context: "DIRT"
context_world: "GRASS_BLOCK"
context_server: "COMMAND_BLOCK"
lore:
group_permissions: "Permissions: %count%"
permission_status: "Status: %status%"
permission_context: "Context: %context%"
permission_expiry: "Expiry: %expiry%"
inherited_from: "Inherited from %group%"
# Messages
messages:
no_permission: "You do not have permission to use this command."
group_created: "Group '%group%' created successfully."
group_deleted: "Group '%group%' deleted successfully."
permission_added: "Permission '%permission%' added to group '%group%'."
permission_removed: "Permission '%permission%' removed from group '%group%'."
permission_toggled: "Permission '%permission%' toggled in group '%group%'."
search_no_results: "No permissions found matching '%query%'."
invalid_group: "Group '%group%' does not exist."
invalid_permission: "Invalid permission format."
# Cache Settings
cache:
refresh_interval: 30 # seconds
# Logging
logging:
enabled: true
file: "history.log"
# Theme (light/dark)
theme: "dark"
Usage
Opening the GUI
- Use the command
/luckpermsgui or /lpgui
- Players need the
luckpermsgui.open permission
Navigation
- Main Menu: Lists all permission groups
- Group Menu: Shows permissions for a specific group
- Permission Menu: Edit individual permission settings
- Player Menu: Manage player-specific permissions
- Search: Find permissions across groups
Group Operations
- Left-click: Open group permission menu
- Right-click: Access group options (duplicate, delete, rename, etc.)
- Create Group: Add new permission groups
- Search: Find specific permissions within groups
Permission Operations
- Left-click: Toggle permission on/off
- Right-click: Open detailed permission menu
- Add Permission: Grant new permissions to groups
- Edit Details: Modify contexts, expiry times, etc.
Commands
| Command |
Description |
Permission |
/luckperms |
Open the main GUI |
luckpermsgui.open |
Permissions
| Permission |
Description |
Default |
luckpermsgui.open |
Access to the main GUI |
op |
API
LuckPermsGUIPlus provides a simple API for integration with other plugins:
API example
import fr.arockenbauer.luckpermsgui.LuckPermsGUIPlus;
import fr.arockenbauer.luckpermsgui.gui.MainMenu;
// Get the plugin instance
LuckPermsGUIPlus plugin = LuckPermsGUIPlus.getInstance();
// Open GUI for a player
new MainMenu(player).open();
Dependencies
- LuckPerms 5.0+
- AnvilGUI (included)
- Bukkit/Spigot/Paper 1.20+ (Older versions not tested, may work but unsupported)
Support
License
This project is licensed under a custom License.
Changelog
Version 1.0.0
- Initial release
- Complete GUI system for LuckPerms management
- AnvilGUI integration for text input
- Context and temporary permission support
- Player permission management
- Advanced search functionality
- Comprehensive logging and caching
Credits
- Developer: Axel Rockenbauer
- AnvilGUI: WesJD
- LuckPerms: Luck
NOTE :
This plugin is NOT created or maintened by the original Luckperms author !
Please DO NOT report any issue regarding this plugin to Luck ! Contact me instead.
评论 0
登录后参与评分
还没有评论,来抢沙发吧