# RoleSelector<\/p>\n
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.<\/p>\n
##
\n.gif)
\n## Features<\/p>\n
– **Customizable GUI** – Configure window title and buttons in config
\n– **Unlimited roles** – Add as many roles as you need
\n– **Empty slots** – Use empty entries to create spacing and layout control
\n– **Auto-size** – GUI automatically adjusts to the number of roles
\n– **No escape** – Players cannot close GUI without selecting a role
\n– **LuckPerms integration** – Automatic group assignment on selection<\/p>\n
## Default Configuration<\/p>\n
“`yaml
\ngui-title: “Choose your role”
\nroles:
\n – id: “”
\n display-name: “”
\n material: “”
\n – id: “”
\n display-name: “”
\n material: “”
\n – id: “”
\n display-name: “”
\n material: “”
\n – id: “male”
\n display-name: “Boy”
\n material: “BLUE_WOOL”
\n – id: “”
\n display-name: “”
\n material: “”
\n – id: “female”
\n display-name: “Girl”
\n material: “PINK_WOOL”
\n“`<\/p>\n
## Role Parameters<\/p>\n
| Parameter | Description |
\n|———–|————-|
\n| `id` | LuckPerms group identifier |
\n| `display-name` | Name shown on the button in GUI |
\n| `material` | Block\/item for the button |<\/p>\n
## Supported Materials<\/p>\n
WOOL, CONCRETE, STAINED_GLASS, DIAMOND, GOLD_INGOT, IRON_INGOT, EMERALD, NETHER_STAR, etc.<\/p>\n
## Custom Messages<\/p>\n
All player messages can be customized in `messages.yml`:
\n– `gui-title` – Window title
\n– `role-assigned` – Message when role is assigned ({role} placeholder)
\n– `already-has-role` – Message when player already has a role
\n– `welcome-message` – Welcome message shown when GUI opens<\/p>\n
## Requirements<\/p>\n
– **LuckPerms** – Required for group management
\n– **Paper\/Spigot 1.21+** – Server software<\/p>\n","protected":false},"excerpt":{"rendered":"
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.<\/p>\n","protected":false},"featured_media":133960,"template":"","meta":{"_minecraft_slug":"roleselector-luckperms","_minecraft_project_id":"DVhXT963","_minecraft_author":"Jorget","_minecraft_license":"MIT","_minecraft_downloads":284,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"roleselector-luckperms.zip","_minecraft_size_bytes":9602,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T11:54:47.274776Z","_minecraft_date_created":"2026-01-31T21:14:00.658168Z","_minecraft_date_modified":"2026-01-30T16:28:28.140061Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/roleselector-luckperms","_minecraft_icon_attachment_id":133960,"_minecraft_imported_at":"2026-06-07T21:44:20+00:00","_minecraft_import_hash":"1e4ee4e5fb13854a690833dc6291ea43","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,90,127,867,129,123,92],"mod_loader":[132,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-133959","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-social","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n