RoleSelector [LuckPerms]

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.

Автор: Jorget5082обновлён 30 янв. 2026 г.

Скачать 1.0.0 Все версии (1)

УправлениеОбщениеУтилиты

Описание

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.

Work plugin

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

Галерея

Default GUI when a new player joins the server

Последние версии

Все версии →

release

RoleSelector [LuckPerms] 1.0.0

1.0.0

30 янв. 2026 г.508Minecraft: 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.11paper, spigot

Скачать

Что нового

# 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 ```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