How do I install RoleSelector [LuckPerms]?

Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. Download the .jar. Put it in the .minecraft/mods folder and launch that loader profile. Opens on Modrinth — not every file is mirrored on our own servers.

What Minecraft version does RoleSelector [LuckPerms] work with?

The listing gives Minecraft 1.21, 1.21.1, 1.21.2, among others. This is the version stated by the author or source site, not something we verified ourselves.

Home›Java›Mods›RoleSelector [LuckPerms]

ModsJava

RoleSelector [LuckPerms]

by Jorget · on Modrinth

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…

⬇ Download on Modrinth

Open in MC Java Mods Get it on Google Play →

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

Quick facts

Edition: Minecraft Java
File type: .jar
Minecraft versions listed: 1.21, 1.21.1, 1.21.2
How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

Verified by MCModsHub

Ships as roleselector-1.0.0.jar — drop this file into the mods folder
Download size: 11 KB
Download link checked 6 Sept 2026 — working

These come from our own check of the pack file, not from the source page.

Explore more

All Mods for Java All Minecraft Java mods Java mods for 1.21