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.

## .gif)

Features

- LuckPerms integration - Configure window title and buttons in config - LuckPerms integration - Add as many roles as you need - LuckPerms integration - Use empty entries to create spacing and layout control - LuckPerms integration - GUI automatically adjusts to the number of roles - LuckPerms integration - 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

- Paper/Spigot 1.21+ - Required for group management - Paper/Spigot 1.21+ - Server software