Pronouns – Let Players Show Their True Selves
Version 3.5.0 | Made by KohanMathers
Give your Minecraft community the power to express themselves authentically. Pronouns allows players to set and display their pronouns directly in chat and above their heads, with vibrant colors and gradient effects. Whether you're running a survival server or an inclusive roleplay world, this plugin helps create a welcoming and respectful space for everyone.
Features
- Players can set or remove their pronouns with custom colors
- Gradient pronouns with preset color schemes or custom hex colors
- Display pronouns in chat, above player heads, and in tab list
- Whitelist & blacklist filtering with regex support
- PlaceholderAPI integration (
%pronouns_<identifier>%) - Admin support to manage pronouns for others
- Fully configurable messages and display options
- Lightweight and optimized for performance
- Works on both Spigot and Paper (1.21+)
- bStats metrics integration
Commands
| Command | Description |
|---|---|
/pronouns set <color> <pronouns> |
Set your pronouns with a specific color |
/pronouns set gradient <preset|colors> <pronouns> |
Set gradient pronouns using presets or custom colors |
/pronouns remove |
Remove your pronouns |
/pronouns remove <player> |
(Admin) Remove another player's pronouns |
/pronouns reload |
(Admin) Reload the plugin configuration |
Aliases: /pronoun, /pn
Examples:
/pronouns set white they/them/pronouns set gradient pride they/them/pronouns set gradient #ff0000 #0000ff she/her/pronouns set gradient red blue green he/him
Gradient Presets
The plugin comes with built-in gradient presets:
pride- Rainbow pride colorsgalaxy- Purple galaxy aestheticpastel- Soft pastel tones
You can add custom presets in config.yml or use color names/hex codes directly!
Permissions
| Permission | Description | Default |
|---|---|---|
pronouns.use |
Allows setting your own pronouns | Everyone |
pronouns.gradient |
Allows using gradient pronouns | Everyone |
pronouns.remove.others |
Allows removing other players' pronouns | OP only |
pronouns.gradient-limit-bypass |
Bypass the gradient color limit | OP only |
pronouns.bypass-filter |
Bypass whitelist/blacklist filters | OP only |
pronouns.reload |
Allows reloading the configuration | OP only |
pronouns.admin |
All admin permissions | OP only |
PlaceholderAPI Support
Requires PlaceholderAPI to be installed!
| Placeholder | Description |
|---|---|
%pronouns% |
Pronouns with brackets and color [they/them] |
%pronouns_raw% |
Pronouns with color, no brackets |
%pronouns_colorless% |
Pronouns with brackets, white color |
%pronouns_fullraw% |
Plain text pronouns only |
%pronouns_lowercase% |
Lowercase with brackets |
%pronouns_uppercase% |
Uppercase with brackets |
%pronouns_capitalized% |
Capitalized (They/Them) |
%pronouns_short% |
First pronoun only (they) |
%pronouns_parentheses% |
With parentheses instead of brackets |
%pronouns_or:<fallback>% |
Returns fallback if no pronouns set |
Example (with a chat plugin):
[%pronouns%] %player%: %message%
Configuration
The plugin is highly configurable via config.yml:
General Settings:
max-pronoun-length- Maximum character limit for pronouns (default: 20)update-display-names- Whether to update player display namesauto-save- Enable automatic savingsave-delay- Delay before saving (in seconds)
Gradient Settings:
color-limit- Maximum colors allowed in gradients (default: 5, -1 for unlimited)show-preview- Show gradient preview when setpresets- Define custom gradient presets
Chat/Display Settings:
show-above-head- Show pronouns above player headsshow-in-tab-list- Show pronouns in the tab listbracket-style- Bracket style (square, round, curly, angle)
Filter Settings (New in 3.5.0):
filter.whitelist.enabled- Only allow specific pronounsfilter.whitelist.list- List of allowed pronouns (case-insensitive)filter.whitelist.regex- Regex pattern for allowed pronounsfilter.blacklist.enabled- Block specific pronounsfilter.blacklist.list- List of blocked pronounsfilter.blacklist.regex- Regex pattern for blocked pronouns
Filter Example:
filter:
whitelist:
enabled: true
list: ["he/him", "she/her", "they/them"]
regex: ""
blacklist:
enabled: true
list: []
regex: "badword|offensive"
Messages: All messages are fully customizable with MiniMessage and legacy color code support!
Installation
- Drop the plugin JAR into your server's
plugins/folder - (Recommended) Install PlaceholderAPI
- Restart the server
- Configure via
plugins/PronounsPlugin/config.yml - Set up your chat plugin to use
%pronouns%
Notes
- Spigot/Paper/Folia only (1.21+). Does not currently support BungeeCord networks
- Pronouns are stored in
plugins/PronounsPlugin/pronouns.json - PlaceholderAPI is highly recommended for chat integration
- The plugin automatically detects Paper vs Spigot and uses appropriate APIs
- Gradient effects use Minecraft's hex color system (1.16+)
Planned Features
- MySQL support for shared pronouns across BungeeCord servers
- GUI for setting pronouns
- Auto-suggestions for common pronouns
- More gradient presets
- Per-world pronoun display settings
Bug Reports & Support
Found a bug? Have a suggestion?
- Open an issue on the project page
- Join the support Discord
- Message KohanMathers directly
Support Development
If you love this plugin and want to support continued development:
- Leave a review on SpigotMC
- Share with your server community
Let's make Minecraft more inclusive, one chat message at a time.
