LuckPermsGUIPlus
Tired of typing 2kms long commands ? Try this powerful in-game editor !
LuckPermsGUIPlus
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
- Temporary Permissions: Create, edit, delete, duplicate, and rename permission groups - Temporary Permissions: Add, remove, toggle, and modify permissions with context restrictions - Temporary Permissions: View and manage individual player permissions - Temporary Permissions: Search permissions across all groups or within specific groups - Temporary Permissions: Add world, server, or custom context restrictions to permissions - Temporary Permissions: Set permissions with expiration times
🎨 User Interface
- Responsive Design: Clean, organized menus with clear navigation - Responsive Design: Color-coded permissions (enabled/disabled/temporary/inherited) - Responsive Design: Handle large numbers of groups and permissions efficiently - Responsive Design: Smooth text input for names, permissions, and contexts - Responsive Design: Proper button placement and menu flow
🔧 Technical Features
- Performance: Efficient permission data caching with automatic refresh - Performance: Track which permissions belong to which groups - Performance: Comprehensive action logging for audit trails - Performance: Highly customizable GUI elements and messages - Performance: Optimized for large permission databases
Installation
1. Ensure you have LuckPerms installed on your server 2. Download the latest LuckPermsGUIPlus.jar from the releases 3. Place the jar file in your server's `plugins/` directory 4. 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
```yaml
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
- Search: Lists all permission groups - Search: Shows permissions for a specific group - Search: Edit individual permission settings - Search: Manage player-specific permissions - Search: Find permissions across groups
Group Operations
- Search: Open group permission menu - Search: Access group options (duplicate, delete, rename, etc.) - Search: Add new permission groups - Search: Find specific permissions within groups
Permission Operations
- Edit Details: Toggle permission on/off - Edit Details: Open detailed permission menu - Edit Details: 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
```java 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
- Bukkit/Spigot/Paper 5.0+ - Bukkit/Spigot/Paper (included) - Bukkit/Spigot/Paper 1.20+ (Older versions not tested, may work but unsupported)
Support
- Issues: Email me at axel@arockenbauer.fr or DM me via Discord (@lechat_v2)
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
- LuckPerms: LuckPerms - LuckPerms: %%MD1%% - LuckPerms: %%MD2%%
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.