Better Chat

Have you ever wanted a chat system that actually does everything you need without installing 5 different plugins? Mentions, tags, local chat, global chat, private messages, profanity filter, clickable links, custom join/leave messages, color codes, cooldowns, and full moderation tools all in one?

Luckily for you, there's my plugin that makes it possible!

I originally made this for my Paper server on version 1.21.1, but I think it should work on higher versions too.

So, the plugin includes:

---

EASY CONFIGURATION

The config allows you to:

• Switch between SIMPLE, LOCAL, and GLOBAL chat modes with a single option
• Toggle radius for local chat and set custom trigger for global messages
• Personalize every format, color, and layout to match your server style
• Enable or disable individual features without touching the code
• Set cooldowns, message limits, and radius values effortlessly

---

MENTIONS WITH SOUND

Players get notified when someone mentions them:

• Customizable sound alert for each mentioned player
• Nickname highlighting in the message
• Full PlaceholderAPI support for colored/gradient names
• Adjustable volume and pitch

---

CHAT TAGS

Dynamic information at your fingertips:

• {item} — shows current held item with hover details (enchantments, amount)
• {online} — server player count
• {random} — random number generator
• {premium} — clickable donate link
• {cords} — coordinates with copy-to-clipboard
• {exp} — experience level display
• {ping} — player ping information

---

PROFANITY FILTER

Keep your chat family-friendly:

• Automatic replacement of inappropriate words
• Customizable word list and replacements
• Sender notification when messages are filtered

---

URL SHORTENER

Any URL in chat becomes interactive:

• Automatic link detection
• Custom display text and hover messages (configurable)
• Click to open URL
• Safe and user-friendly

---

PRIVATE MESSAGES

• /msg, /tell, /w, /pm, /message support
• Clickable nicknames for quick replies
• Sound notification on message receipt
• Colorized nicknames via PlaceholderAPI
• Click on any message to copy it to clipboard
• Full SuperVanish support — vanished players are invisible in PM

---

CUSTOM JOIN/LEAVE MESSAGES

Players can personalize their arrival:

• /enter <message with * as nickname>
• /exit <message with * as nickname>
• Full color code support
• Premium permission-based access

---

CLICK ACTIONS

• Click on any chat message to copy it to clipboard
• Click on player name to open private message suggestion
• Hover over name for player information

---

COLOR CODES

• Allow players with permission to use & color codes in chat
• Toggle color for all players in config

---

CHAT COOLDOWN & SPAM PROTECTION

• Configurable cooldown between messages
• Custom cooldown message with remaining seconds
• Bypass permission for staff
• Maximum message length limit
• Block empty or blank messages
• Auto-truncate long messages

---

SUPERVANISH INTEGRATION

• Vanished players stay completely invisible
• No join/leave messages from hidden players
• No private messages to/from vanished players
• Seamless compatibility

---

LOGGING

• Full chat logging to console
• Custom log format with mode, player name, and message
• Separate logs for local, global, and private messages

---

COMMANDS

Command	Description
/enter <message>	Set your custom join message
/exit <message>	Set your custom leave message
/betterchat reload	Reload configuration
/betterchat addmat <word>	Add word to profanity filter
/betterchat status	View current settings

---

PERMISSIONS

Permission	Description
BetterChat.admin	Access to admin commands
BetterChat.join.use	Use custom join/leave messages
BetterChat.color	Use color codes in chat
BetterChat.chat.global	Use global chat
BetterChat.chat.local	Use local chat
BetterChat.chat.bypass	Bypass local chat range
BetterChat.mention.use	Use mentions
BetterChat.tag.use	Use chat tags

---

If you run into any issues, contact me on Telegram! @AlexsandrDeveloper

(Also message me if you're interested in buying the plugin's source code)