RoleSelector [LuckPerms]

# RoleSelector A Minecraft server plugin for Paper/Spigot 1.21+ that allows players to select roles through a graphical user interface (GUI) when they first join the server. ## !(https://i.postimg.cc/gk7FTzTz/0206(2).gif) ## Features - **Customizable GUI** - Configure window title and buttons in config - **Unlimited roles** - Add as many roles as you need - **Empty slots** - Use empty entries to create spacing and layout control - **Auto-size** - GUI automatically adjusts to the number of roles - **No escape** - Players cannot close GUI without selecting a role - **LuckPerms integration** - Automatic group assignment on selection ## Default Configuration ```yaml gui-title: "Choose your role" roles: - id: "" display-name: "" material: "" - id: "" display-name: "" material: "" - id: "" display-name: "" material: "" - id: "male" display-name: "Boy" material: "BLUE_WOOL" - id: "" display-name: "" material: "" - id: "female" display-name: "Girl" material: "PINK_WOOL" ``` ## Role Parameters | Parameter | Description | |-----------|-------------| | `id` | LuckPerms group identifier | | `display-name` | Name shown on the button in GUI | | `material` | Block/item for the button | ## Supported Materials WOOL, CONCRETE, STAINED_GLASS, DIAMOND, GOLD_INGOT, IRON_INGOT, EMERALD, NETHER_STAR, etc. ## Custom Messages All player messages can be customized in `messages.yml`: - `gui-title` - Window title - `role-assigned` - Message when role is assigned ({role} placeholder) - `already-has-role` - Message when player already has a role - `welcome-message` - Welcome message shown when GUI opens ## Requirements - **LuckPerms** - Required for group management - **Paper/Spigot 1.21+** - Server software