Pronouns Documentation

Welcome to the official documentation for Pronouns v3.5.0 – a lightweight, inclusive plugin that lets players set and display pronouns in chat and beyond using PlaceholderAPI.

[HR][/HR]

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 via plugins/PronounsPlugin/config.yml

[HR][/HR]

Commands

Command	Description	Permission
/pronouns set <color> <pronouns>	Set your pronouns with a color	pronouns.use
/pronouns set gradient <preset|colors> <pronouns>	Set pronouns with gradient colors	pronouns.gradient
/pronouns remove	Remove your own pronouns	pronouns.use
/pronouns remove <player>	Remove another player's pronouns	pronouns.remove.others
/pronouns reload	Reload the plugin configuration	pronouns.reload

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

[HR][/HR]

Gradient Presets

Built-in gradient presets:

Preset	Description
pride	Rainbow pride colors
galaxy	Purple galaxy aesthetic
pastel	Soft pastel tones

You can add custom presets in config.yml or use color names/hex codes directly!

[HR][/HR]

Permissions

Node	Description	Default
pronouns.use	Allows setting/removing 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

[HR][/HR]

PlaceholderAPI Placeholders

You can use these placeholders in any plugin that supports PlaceholderAPI. All variants pull the player's saved pronouns.

[HR][/HR]

Basic Placeholders

Placeholder	Description
%pronouns%	Pronouns with brackets and color (e.g., [they/them])
%pronouns_raw%	Pronouns with color, no brackets
%pronouns_colorless%	Pronouns with brackets, white color
%pronouns_fullraw%	Plain text pronouns only, no formatting
%pronouns_lowercase%	Pronouns in all lowercase
%pronouns_uppercase%	Pronouns in all uppercase
%pronouns_capitalized%	Pronouns capitalized (e.g., They/Them)
%pronouns_short%	First pronoun only (e.g., they)
%pronouns_parentheses%	Pronouns in parentheses (e.g., (they/them))
%pronouns_parentheses_colorless%	Colorless pronouns in parentheses

[HR][/HR]

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>

Examples:
These will return the stored pronouns if available — otherwise, the fallback string will be used.

[HR][/HR]

Example Chat Format
Use this with any chat plugin that supports PlaceholderAPI!

[HR][/HR]

Configuration

Data Storage

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

Example:
[HR][/HR]

Filter Settings (New in 3.5.0)

Control which pronouns are allowed on your server:

Setting	Description
whitelist.enabled	Only allow pronouns matching the list or regex
whitelist.list	Exact matches (case-insensitive)
whitelist.regex	Java regex pattern for allowed pronouns
blacklist.enabled	Block pronouns matching the list or regex
blacklist.list	Exact matches to block
blacklist.regex	Java regex pattern for blocked pronouns

[HR][/HR]

Gradient Settings

[HR][/HR]

Display Settings

[HR][/HR]

Messages

All messages are fully customizable with MiniMessage and legacy color code ( &c, &a, etc.) support!

[HR][/HR]

Compatibility

Server Type	Status
Paper	Fully supported
Spigot	Fully supported
Purpur	Compatible
Folia	Untested
BungeeCord	Not supported (local config only)

Minimum Version: 1.21+

[HR][/HR]

Planned Features

• MySQL support for global pronouns across networks
• GUI menu for pronoun selection
• Auto-suggest common pronouns
• Per-world pronoun display settings

[HR][/HR]

bStats

This plugin uses bStats to collect anonymous usage statistics. You can opt out in plugins/bStats/config.yml.

[HR][/HR]

Contributing & Support

If you'd like to suggest features, report a bug, or contribute code:

• Open an issue or PR on GitHub
• Contact me directly on Spigot

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