LuckPermsGUIPlus

Tired of typing 2kms long commands ? Try this powerful in-game editor !

2,40k

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.

ADS