GenderContext
Gender-based LuckPerms context for Paper 1.21
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✦ Overview
GenderContext is a lightweight PaperMC plugin that adds a gender context to LuckPerms. Each player sets their own gender ( male or female ), and LuckPerms automatically applies it as a permission context — enabling gender-specific prefixes, permissions, and metadata with no extra configuration.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✦ Features
- LuckPerms context integration — the gender context (values: male, female) is registered and updated in real time.
- Player self-service — players set their own gender with /gender set. Admins can change any player's gender.
- LuckPerms-native storage — gender is stored as a LuckPerms metadata node, no separate database or flat files.
- Instant context refresh — LuckPerms context is signalled immediately after every change, no relog required.
- Multilingual — ships with English and French. Switch with lang: en or lang: fr in config.yml. Every message is editable.
- Zero overhead — no scheduler loops, no database queries. Reads directly from the LuckPerms user cache.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✦ LuckPerms Usage
Once a player sets their gender, the context gender=male or gender=female is available in all LuckPerms commands.
For example:
Code (Text):
/lp group vip meta addprefix 100 "[VIP] " gender=male
/lp group vip meta addprefix 100 "[VIP♀] " gender=female
/lp user Steve permission set some.permission true gender=male
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✦ Commands
Spoiler: Player commands (gendercontext.use)
/gender set <male|female|none> Set your own gender
/gender get View your gender
Code (Text):
/gender set <male|female|none> Set your own gender
/gender get View your gender
Spoiler: Admin commands (gendercontext.admin / gendercontext.check)
/gender set <male|female|none> <player> Set another player's gender
/gender get <player> View another player's gender
Code (Text):
/gender set <male|female|none> <player> Set another player's gender
/gender get <player> View another player's gender
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✦ Permissions
Code (Text):
gendercontext.use Set your own gender (/gender set) Default: true
gendercontext.admin Set another player's gender Default: OP
gendercontext.check View another player's gender Default: OP
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✦ Configuration
Spoiler: config.yml
# Language: en (English) | fr (French)
lang : en
# Internal identifiers stored in LuckPerms and used as context values.
# ⚠ WARNING: Changing these does NOT update already stored data.
# Existing players will keep the old value until they set it again.
# Your LuckPerms rules (gender=male, gender=female) must also be updated.
gender-values:
male : male
female : female
# LuckPerms usage examples (with default gender-values above):
# /lp group vip meta addprefix 100 "[VIP] " gender=male
# /lp group vip meta addprefix 100 "[VIP♀] " gender=female
Code (YAML):
# Language: en (English) | fr (French)
lang : en
# Internal identifiers stored in LuckPerms and used as context values.
# ⚠ WARNING: Changing these does NOT update already stored data.
# Existing players will keep the old value until they set it again.
# Your LuckPerms rules (gender=male, gender=female) must also be updated.
gender-values:
male : male
female : female
# LuckPerms usage examples (with default gender-values above):
# /lp group vip meta addprefix 100 "[VIP] " gender=male
# /lp group vip meta addprefix 100 "[VIP♀] " gender=female
Language
Set lang: fr or lang: en in config.yml . Every message is fully editable in plugins/GenderContext/lang/ . Leave any value empty ( "" ) to disable that message.
Gender values
Set gender-values.male and gender-values.female to any string you like. These become the actual LuckPerms context values. Changing them after players have set their gender requires a manual reset — see the warning in config.yml .
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✦ Requirements
- Paper 1.21 or newer
- LuckPerms 5.x
- Java 17 or newer
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✦ Support
For help or bug reports, join the Discord server:
Made with ❤ by Golf
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft version listed: 1.21
- 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 Spigot — 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.
Gender Context (for Luckperms) is a free Minecraft Java mod. Compatible with Minecraft 1.21. Downloaded 11 times (via Spigot). Download it and open it directly in the game.