Pronouns Documentation
Welcome to the official documentation for Pronouns – a lightweight, inclusive plugin that lets players set and display pronouns in chat and beyond using PlaceholderAPI with advanced gradient effects and comprehensive customization.

Version 3.2.4 | Made by KohanMathers

Installation

1. Place the plugin JAR in your plugins/ directory
2. Install PlaceholderAPI if you haven't already
3. Start or restart the server
4. Configure your chat plugin to use the %pronouns_% placeholders

✨ Key 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

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

Node

Description	Default
pronouns.use	Allows a player to set or remove their own pronouns	✅ True
pronouns.remove.others	Allows removing other players' pronouns	❌ OP only
pronouns.gradient	Allows using gradient pronouns	✅ True
pronouns.gradient-limit-bypass	Bypass gradient color limit	❌ OP only
pronouns.admin	All pronoun admin permissions	❌ OP only

PlaceholderAPI Placeholders
You can use these placeholders in any plugin that supports PlaceholderAPI. All variants pull the player's saved pronouns using the identifier %pronouns_<format>%.

✅ Basic Placeholders

Placeholder

Description	Example Output
%pronouns%Default bracketed pronouns[they/them]
%pronouns_raw%Raw pronouns with color codesthey/them
%pronouns_colorless%White brackets, no custom colors[they/them]
%pronouns_fullraw%Plain text without any formattingthey/them
%pronouns_lowercase%Lowercase pronouns[they/them]
%pronouns_uppercase%Uppercase pronouns[THEY/THEM]
%pronouns_capitalized%Capitalized pronouns[They/Them]
%pronouns_short%First pronoun only (before "/")they
%pronouns_parentheses%Parentheses instead of brackets(they/them)
%pronouns_parentheses_colorless%Colorless pronouns in parentheses(they/them)

Fallback Variants
These placeholders provide a default value if the player hasn't set their pronouns.


Placeholder Description
%pronouns_or:<fallback>% Default bracketed pronouns, or <fallback> if not set
%pronouns_raw_or:<fallback>% Raw pronouns or <fallback>
%pronouns_fullraw_or:<fallback>% Full raw pronouns or <fallback>
%pronouns_then_<text>% Shows pronouns + text only if pronouns exist
Examples:

%pronouns_or:unspecified%
%pronouns_raw_or:ask me%
%pronouns_fullraw_or:none set%
%pronouns_then_is online%

Example Chat Format
%pronouns_or:no pronouns% %player_name%: %message%

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

Use this with any chat plugin that supports PlaceholderAPI!

Configuration & Data Storage
Configuration File
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: #FF0018 #FFA52C #FFFF41 #008018 #0000F9 #86007D
• Galaxy - Purple-blue cosmic gradient: #667eea #764ba2 #667eea
• Pastel - Soft peach-to-cream gradient: #ffecd2 #fcb69f #ffecd2

Data Storage
All pronouns are stored in plugins/PronounsPlugin/pronouns.json. The format is:

{
"player-uuid": "color ronouns",
"player-uuid": "GRADIENT:gradient-formatted-text"
}

Examples:

{
"fb6647db-ad52-4a54-9c7b-56fff703c299": "GOLD:She/They",
"12345678-1234-1234-1234-123456789abc": "GRADIENT:§x§f§f§0§0§1§8She§x§f§f§a§5§2§c/§x§f§f§f§f§4§1They§r"
}

⚠️ Important: The plugin automatically saves to this file. Do not edit while the server is running unless you reload afterward.

Compatibility

Server Type Status
Spigot ✅ Fully supported
Paper ✅ Fully supported (recommended)
Purpur ✅ Compatible
BungeeCord ❌ Not supported (local config only)
Requirements:

• Minecraft 1.21+
• PlaceholderAPI
• Chat formatting plugin that supports PlaceholderAPI

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

Planned Features

• ️ MySQL support for global pronouns across networks
• ️ GUI menu for pronoun selection
• Auto-suggest common pronouns
• Reload command for configuration changes
• BungeeCord support for cross-server networks

❤️ Contributing & Support
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.

Let's make Minecraft more inclusive, one pronoun at a time!