MintNicks
A modern nickname system for Paper & Folia servers
MintNicks is a powerful nickname management plugin designed for modern Minecraft servers running Paper or Folia 1.21+.
Instead of allowing uncontrolled nicknames, MintNicks introduces a request & approval workflow, letting players submit styled nicknames while staff maintain full moderation control.
Players can request nicknames using MiniMessage formatting, while staff approve them through clean GUI menus.
MintNicks also includes integrations for PlaceholderAPI, Discord, OpenAI moderation, and server economies, making it a complete solution for professional servers.
Support
For help, bug reports, or suggestions:
Core Features
✔ Player nickname requests with staff approval workflow✔ Clean GUI system for players and staff
✔ Full MiniMessage support (gradients, hex colours, formatting)
✔ PlaceholderAPI support for displaying active nicknames
✔ Optional Discord webhook notifications
✔ Optional OpenAI moderation for filtering inappropriate nicknames
✔ Optional economy cost using Vault or MintTokens
✔ Offline notification system (players receive approval/denial messages later if offline)
✔ Fully compatible with Paper and Folia servers
Player Experience
Players can easily request and manage their nicknames.
Player Commands
/nickname request <nickname> - Requests a nickname for approval/nicknames - Lists all your approved nicknames.
/nickname help - Shows a list of commands and help with formatting.
Aliases:
/nick
/nicks
Players can:
• Submit nickname requests
• View their approved nicknames
• Select an active nickname
• Delete previously approved nicknames
Staff Tools
Staff members have full moderation control.
Admin Commands
/nickname pending - Opens a gui with all pending player nicknames./nicknames <player> - Opens a gui for the admin to view previously approved nicks and delete them.
/nickname blockcolor <color> - Blocks either a legacy color code or any hex color code.
/nickname reload - Reloads the plugin config.
Staff can:
• Approve or deny nickname requests
• Manage nicknames for any player (including offline players)
• Block specific colours from being used
• Reload the plugin configuration
Modern MiniMessage Formatting
MintNicks supports modern MiniMessage formatting, allowing players to create stylish nicknames.
Examples:
<gradient:#9863E7:#8C107B>ExampleName</gradient>
<color:#ba03fc>ExampleName</color>
<yellow><bold>ExampleName</bold></yellow>
Features:
• Gradients
• Hex colours
• MiniMessage tags
• Legacy colour code support
Length validation ignores formatting codes so players cannot bypass limits.
Formatting tags such as bold or italic require the permission: mintnick.formatting
GUI Management System
All nickname management is handled through modern GUI menus.Players can:
• View approved nicknames
• Select an active nickname
• Delete unused nicknames
Staff can:
• Review pending nickname requests
• Approve or deny requests
• Manage nicknames for any player
The GUI system includes pagination and clean interface design.
Discord Integration
MintNicks can automatically send notifications to Discord webhooks.
Events supported:
• Nickname request submitted
• Nickname approved
• Nickname denied
Embeds can include:
• Player heads
• Admin head icons
• Target player avatar
• Styled nickname preview images
Nickname Preview Images
MintNicks can generate visual nickname previews for Discord.
Instead of plain text, the plugin renders the nickname exactly as it appears in Minecraft, including colours and gradients.
This makes it easier for staff to review nickname requests directly from Discord.
Preview images are generated in memory and never written to disk, ensuring performance and security.
Economy Integration
YAML:
# Optional economy charge for nickname requests.
# This system can only use one provider at a time.
# Set provider to either:
# VAULT - uses your active Vault economy provider and vault-cost (MOST COMMON PROVIDER)
# MINTTOKENS - uses the MintTokens plugin and minttokens-cost
# Do not try to use both. MintNicks will only charge through the provider selected here.
economy:
enabled: false
# Valid options: VAULT, MINTTOKENS
provider: "VAULT"
# Used only when provider = VAULT
vault-cost: 0.0
# Used only when provider = MINTTOKENS
minttokens-cost: 0Nickname requests can optionally cost currency.
Supported systems:
• Vault (any economy plugin)
• MintTokens
Example configuration:
YAML:
economy:
enabled: true
provider: "VAULT"
vault-cost: 500If a nickname request is denied, the player automatically receives a full refund.
Optional Moderation System
YAML:
# If you would like nicknames to be filtered out before it reaches the pending stage,
# you can enable the below Open-AI moderation feature.
# Note: This requires an OpenAI account with enough credits.
# OpenAI charges fees to use this service.
# More information: https://platform.openai.com/api-keys
moderation:
enabled: false
openai-api-key: ""
model: "omni-moderation-latest"
timeout-seconds: 10
endpoint: "https://api.openai.com/v1/moderations"
# Accepts either true or false
block-categories:
self-harm: true
hate: true
harassment: true
sexual: true
violence: false
profanity: trueMintNicks supports optional OpenAI moderation.
This can automatically block nicknames related to:
• harassment
• hate speech
• self-harm
• sexual content
• violence
Moderation happens before requests enter the approval queue.
PlaceholderAPI Support
MintNicks includes a PlaceholderAPI expansion.
Placeholder:
%mintnicks_nickname%
This returns the player’s active nickname.
Works with:
• chat plugins
• tablist plugins
• scoreboards
• placeholders in other plugins
Requirements
Required:
• Paper or Folia 1.21+
• Java 21
• PlaceholderAPI
Optional integrations:
• Vault
• Any Vault-compatible economy plugin
• MintTokens
• Discord webhook
• OpenAI API key (moderation)
