MintChat
MintChat is a modern chat plugin for Paper and Folia 1.21.x servers, designed to give you full control over your server’s chat experience.It combines powerful formatting, private messaging, moderation tools, and smart filtering into one lightweight and highly configurable plugin.
Support
For help, bug reports, or suggestions:If you would like to test this plugin prior to purchasing, please join our discord above and I'll be happy to turn on a dev server for you to test it on.
Overview
MintChat replaces standard chat systems with a fully configurable setup that supports:- Custom chat formats with permission priority
- Private messaging and reply system
- Staff tools like social spy
- Player features like ignore and mentions
- Built-in spam protection and chat filtering
Features
- Permission-based chat formats with priority system
- Support for MiniMessage and legacy formatting
- Private messaging with /msg and /reply (overrides Essentials)
- Social spy for staff moderation
- Ignore and unignore system
- Mention alerts with highlights, sounds, and action bar notifications
- Spam protection
- Blocked word filtering
- URL blocking with whitelist support
- Add/Remove filtered words using commands on the server
How it works
MintChat allows you to define chat formats in formats.yml, giving you full control over how messages appear.You can assign formats based on permissions, customise player name interactions (such as click-to-message), and control how players format their messages using MiniMessage or legacy codes.
The plugin also includes moderation features like word filtering, URL blocking, and spam prevention, along with player-focused features like mentions and ignore support.
Chat Filter
- Filters blocked words (including common variations)
- Optional URL blocking
- Whitelisted domains supported
- Can apply to private messages
If players send words that are blocked in chat, this is broadcasted to staff with the permission mintchat.staff
If URL blocking is enabled, those will also be filtered out of chat.
Commands
Player Commands
- /msg <player> <message> — Send a private message
- /reply <message> — Reply to the last private message
- /ignore <player> — Ignore a player
- /unignore <player> — Remove an ignored player
Staff/Admin Commands
- /socialspy [on|off] — Toggle social spy
- /mintchat reload — Reload configuration
- /mintchat filter add <word> — Add a blocked word
- /mintchat filter remove <word> — Remove a blocked word
- /mintchat filter enable — Enable chat filtering
- /mintchat filter disable — Disable chat filtering
- /mintchat filter list — View blocked words
Permissions
- mintchat.message — Use private messaging
- mintchat.reply — Use reply command
- mintchat.socialspy — Use social spy
- mintchat.ignore — Use ignore system
- mintchat.admin — Access admin commands
- mintchat.staff — Receive filter alerts
- mintchat.chat.legacy — Use legacy formatting in chat messages
- mintchat.chat.minimessage — Use MiniMessage formatting in chat messages
- mintchat.mention — Trigger mentions
- mintchat.chatfilter.bypass — Bypass filters
- mintchat.chat.linkify — Enable auto-linking (with bypass)
- mintchat.spam.bypass — Bypass spam protection
- mintchat.bypass.ignore — Prevent being ignored
- mintchat.socialspy.exempt — Exempt from social spy
Mentions
When enabled, mentioning a player can:- Highlight the message
- Play a sound
- Send an action bar notification
Dependancies
