BetterPronouns Plugin

A Minecraft plugin for Paper servers (Versions 1.21.4+) that enables players to set and display their pronouns seamlessly.

Features

• /pronouns: Opens an intuitive menu to set your pronouns.
• /pronouns help: Displays the plugin version and lists all available commands.
• API for developers to retrieve player pronouns.
• PlaceholderAPI support for quick and easy pronouns retreival

Showcase

Requirements

Software: Paper
Versions: 1.21.4+

Downloads

PlaceHolderAPI Usage

How to use

Use these placeholders using the PlaceHolderAPI to get a player's pronouns:

%pronouns_<playerName>% or %pronouns%

API Usage

Add to plugin.yml

Include the following dependency in your plugin.yml to utilize the BetterPronouns API:

depend: [BetterPronouns]

Add to pom.xml

Add the following repository and dependency to your pom.xml to use the BetterPronouns API:

<repository>
    <id>betterpronouns-repo</id>
    <url>https://firecraftstudio.com/maven/</url>
</repository>
<dependency>
    <groupId>com.firecraftstudio</groupId>
    <artifactId>BetterPronouns</artifactId>
    <version>1.0</version>
    <scope>provided</scope>
</dependency>
        

Example API Usage

Below is a concise example demonstrating how to use the BetterPronouns API to display a player's pronouns upon joining the server:

package com.yourwebsite.ExamplePlugin;

import org.bukkit.event.EventHandler;
import org.bukkit.event.Listener;
import org.bukkit.event.player.PlayerJoinEvent;
import org.bukkit.plugin.java.JavaPlugin;
import com.firecraftstudio.betterpronouns.BetterPronounsAPI;

public final class ExamplePlugin extends JavaPlugin implements Listener {

    @Override
    public void onEnable() {
        getServer().getPluginManager().registerEvents(this, this);
        getLogger().info("ExamplePlugin plugin enabled!");
    }

    @Override
    public void onDisable() {
        getLogger().info("ExamplePlugin plugin disabled!");
    }

    @EventHandler
    public void onPlayerJoin(PlayerJoinEvent event) {
        org.bukkit.entity.Player player = event.getPlayer();
        String pronouns = BetterPronounsAPI.getPronouns(player.getUniqueId());
        player.sendMessage("§6Your pronouns are: §f" + pronouns);
        getLogger().info(player.getName() + "'s pronouns: " + pronouns);
    }
}

Bugs

How to report bugs:

Email bugs you find to [email protected]