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.

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