RoleSelector [LuckPerms]

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： paper spigot

标签： management social utility

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

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