• Give players a fast, intuitive menu to browse, preview, and equip their unlocked prefixes.
• Ship curated sets of prefixes via `config.yml`, complete with descriptions, GUI materials, and optional gradients.
• Let LuckPerms keep doing permission management; Critical Prefix reads existing nodes and applies prefixes with the weight you configure.
• Built for modern servers while staying backwards-compatible with legacy 1.13 APIs.

• Lightweight GUI: `/prefix` opens a paginated menu that respects filler/utility slots you define.
• Permission-aware: Only prefixes a player has permission for (`criticalprefix.prefix.<id>`) are displayed.
• Gradient support: Use Adventure-style gradient syntax (`{gradient=#FF00FF}Text{#00FFFF}`) or legacy colour codes; older servers gracefully fall back when hex isn’t available.
• Instant updates: Menu state stays in sync—switch pages, clear, or exit without stray click events.
• Aliases & hotkeys: Configure extra commands that forward to `/prefix` so players can use the wording they prefer.

• /prefix – Opens the prefix menu. Requires `playerprefix.menu` (customisable in config).
• /prefix reload – Reloads `config.yml`. Requires `criticalprefix.admin`.
• criticalprefix.prefix.<id> – Grants access to a specific prefix entry.
• criticalprefix.admin – Administrative access to management tools.

• Add or tweak prefixes under the `prefixes` section. Each entry supports:
• material – Slot item (defaults to `NAME_TAG` if invalid).
• prefix – The LuckPerms prefix applied when selected.
• description – Single line or list shown as item lore.
• Customise menu cosmetics: title, size, filler slots, navigation buttons, clear/exit actions, and alias list.
• Hex gradients or standard colour codes are all parsed via `TextUtil`.

1. Drop the jar into your `plugins` folder alongside LuckPerms.
2. Start the server once to generate `config.yml`.
3. Edit the config to add prefixes, button materials, and optional aliases.
4. Assign players LuckPerms nodes (`criticalprefix.prefix.<id>` and your menu permission).
5. Use `/prefix` in game to confirm the GUI matches your design.

• Tested on Spigot & Paper 1.13 through 1.21.8 (Java 8+).
• Menu logic avoids 1.21.x localized-name deprecations, ensuring future-proof GUI states.
• Supports gradient text on servers shipping Adventure ChatColor APIs; gracefully degrades on legacy stacks.

• LuckPerms (plugin disables itself if LuckPerms is missing).
• Java 8 or newer runtime (matches Spigot MC 1.13+ requirements).

• Use LuckPerms contexts or tracks to automatically grant prefixes as players rank up.
• Pair with chat formatting plugins that respect the LuckPerms prefix node for best results.
• Need gradients on 1.15 or older? Stick to solid hex colours (`#RRGGBB`) or classic `&` codes—the plugin strips unsupported sequences cleanly.

Drop any questions, feature requests, or bug reports in our Discord or on the issue tracker—we’re happy to help tailor Critical Prefix to your network’s needs.