Pronouns – Let Players Show Their True Selves
Version 3.2.4 | 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 with stunning gradient effects, PlaceholderAPI integration, and comprehensive customization options. Whether you're running a survival server or an inclusive roleplay world, this plugin helps create a welcoming and respectful space for everyone.

✨ Features

• ✅ Multiple Display Formats - Players can set pronouns with color customization
• ✅ Gradient Support - Beautiful color gradients with presets (Pride, Galaxy, Pastel) or custom colors
• ✅ PlaceholderAPI Integration - Extensive placeholder support with multiple formatting options
• ✅ Display Name Integration - Automatic integration with player display names and tab lists
• ✅ Flexible Formatting - Support for brackets, parentheses, raw text, and conditional displays
• ✅ Admin Management - Full admin controls for managing other players' pronouns
• ✅ Highly Configurable - Extensive configuration options for every aspect
• ✅ Performance Optimized - Async data handling and smart save scheduling
• ✅ Modern Minecraft Support - Built for 1.21+ with Adventure API integration

Commands

Command

Description

Permission

/pronouns add <color> <pronouns>	Set your pronouns with a specific color	pronouns.use
/pronouns remove	Remove your own pronouns	pronouns.use
/pronouns remove <player>	(Admin) Remove another player's pronouns	pronouns.remove.others
/pronouns gradient <preset|color1> [color2] [color3]...	Apply gradient effects to your pronouns	pronouns.gradient

Aliases: /pronoun, /pn

Gradient Examples:

• /pronouns gradient pride - Apply the built-in Pride flag gradient
• /pronouns gradient galaxy - Apply a galaxy-themed gradient
• /pronouns gradient #ff0000 #00ff00 #0000ff - Custom RGB gradient
• /pronouns gradient red blue yellow - Named color gradient

Permissions

Permission

Description

Default

pronouns.use	Allows basic pronoun commands	✅ Everyone
pronouns.remove.others	Allows removing other players' pronouns	❌ OP only
pronouns.gradient	Allows using gradient pronouns	✅ Everyone
pronouns.gradient-limit-bypass	Bypass gradient color limit	❌ OP only
pronouns.admin	All pronoun admin permissions	❌ OP only

PlaceholderAPI Support
The plugin provides extensive placeholder support with the identifier %pronouns_<format>%:

Available Formats:

Placeholder

Output Example

Description

%pronouns_%	[they/them]	Default bracketed format
%pronouns_raw%	they/them	Raw pronouns with color codes
%pronouns_fullraw%	they/them	Plain text without any formatting
%pronouns_colorless%	[they/them]	White brackets, no custom colors
%pronouns_parentheses%	(they/them)	Parentheses instead of brackets
%pronouns_short%	they	First pronoun only (before "/")
%pronouns_capitalized%	[They/Them]	Capitalized pronouns
%pronouns_lowercase%	[they/them]	Lowercase pronouns
%pronouns_uppercase%	[THEY/THEM]	Uppercase pronouns

Conditional Placeholders:

Placeholder
Description
%pronouns_or:fallback%	Shows pronouns or fallback text if none set
%pronouns_then_text%	Shows pronouns + text only if pronouns exist

Chat Integration Example:
%pronouns_% %player_name%: %message%

Output: [she/her] Alice: Hello everyone!

⚙️ Configuration
The plugin is highly configurable with options for:

• Gradient Settings - Color limits, presets, and preview options
• General Settings - Character limits, auto-save, display name integration
• Chat Integration - Tab list display, above-head names, bracket styles
• Permission Controls - Self-removal permissions, basic command access
• Custom Messages - Fully customizable user feedback messages
• Debug Options - Logging and troubleshooting features

Built-in Gradient Presets:

• Pride - Traditional Pride flag colors
• Galaxy - Purple-blue cosmic gradient
• Pastel - Soft peach-to-cream gradient

Installation

1. Download the plugin JAR and place it in your server's plugins/ folder
2. Install PlaceholderAPI (required dependency)
3. Restart your server to generate config files
4. Configure your chat plugin to use %pronouns_% placeholders
5. Customize settings in plugins/PronounsPlugin/config.yml as needed

Requirements:

• Spigot/Paper 1.21+
• PlaceholderAPI
• Chat formatting plugin that supports PlaceholderAPI

Data Storage

• Pronouns are stored in plugins/PronounsPlugin/pronouns.json
• Automatic async saving with configurable delays
• Thread-safe data handling for optimal performance
• Easy backup and migration support

Advanced Features
Smart Color Handling

• Support for hex codes (#ff0000) and named colors (red, blue)
• Intelligent gradient interpolation across multiple colors
• Legacy Minecraft color code compatibility

Display Name Integration

• Automatic player display name updates
• Separate tab list formatting for better readability
• Customizable above-head display options

Performance Optimizations

• Asynchronous data loading and saving
• Smart save scheduling to prevent disk spam
• Concurrent data structures for thread safety

❤️ Support & Community
Need help or want to share feedback?

Join my Discord: https://discord.gg/FZuVXszuuM
Get support, updates, and connect with other server owners using the plugin!

Bug Reports & Feature Requests:
Join the Discord server for the fastest response and community support.

Notes

• This plugin is designed for Spigot/Paper servers only
• Cross-server support planned for future releases
• All gradient effects are client-side compatible
• No client-side mods required

Let's make Minecraft more inclusive, one chat message at a time.