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.

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

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