Description
HyChat customizes the in-game chat format, allowing server owners to fully control how player messages are displayed.
Chat messages support classic color codes like &b (similar to Minecraft), hex colors such as #FFFFFF, and placeholders like {player} and {message}.
The plugin is lightweight, easy to configure, and can be reloaded without restarting the server.
Luckperms + PlaceholderAPI Support
Admin Menu UI
Title Announcer UI
Broadcast a title + subtitle to all players
Optional Major Display (Large Title)
Preview:
Notification Announcer UI
Send popup notifications to everyone
Select notification style: SUCCESS, WARNING, or DANGER
Preview:
Chat Announcer UI
Send a fully formatted chat message globally
Supports:
-
<color:#FF0000> colors
-
<bold> formatting
-
Gradients
-
Legacy & color codes
Preview:
Word Filter
Blocks or modifies messages containing blacklisted words
Fully configurable and toggleable
Caps Lock Control
Detects messages with excessive capital letters
Automatically converts messages to lowercase
Alerts the player when the caps limit is exceeded
Configurable caps percentage
Chat Cooldown
Per-player chat cooldown (example: cooldown: 2s)
Prevents chat spam
Bypass permission supported
Moderation Logging
Optional logging system
Logs all moderation actions (caps, spam, filter)
Stored in: HyChat/logs/
One log file per day for clean organization
Mention System
Mention players using @PlayerName
Sends a title notification to the mentioned player
Plays a sound effect on mention
Built-in 5-second cooldown to prevent spam
Config.yml:
# HyChat Configuration
# Advanced chat management plugin with formatting, moderation, and filtering
# For Support join at https://discord.gg/nTTkMxe8Kg
# Chat Format
# Use color codes: &c for legacy colors, #RRGGBB for hex (e.g., #FF5733)
# Placeholders: {player} = player name, {message} = chat message
# Example: "&7[#0093FFHyChat&7] &f{player} &7» #5FE2C5{message}"
format: "&7[#0093FFHyChat&7] &f{player} &7» #5FE2C5{message}"
# Word Filter
# Automatically blocks messages containing blacklisted words
# When triggered: message is blocked, player sees alert-message
# Permission to bypass: hychat.bypass.filter
word-filter:
enabled: true
words:
- "asshole"
- "fuck"
- "bitch"
alert-message: "&c[!] Your message contained inappropriate language and was filtered!"
# Caps Control
# Prevents excessive uppercase letters in messages
# threshold: 0.7 = 70% of message in caps triggers filter
# min-length: only check messages with this many characters or more
# When triggered: message is converted to lowercase, player sees alert-message
# Permission to bypass: hychat.bypass.caps
caps-control:
enabled: true
threshold: 0.7
min-length: 5
alert-message: "&e[!] Please don't abuse caps lock!"
# Chat Cooldown
# Prevents spam by requiring delay between messages
# duration: seconds players must wait between chat messages
# message: shown when player tries to chat too soon ({time} = remaining seconds)
# Permission to bypass: hychat.bypass.cooldown
cooldown:
enabled: true
duration: 2
message: "&c[x] Please wait {time} more seconds before chatting again!"
# Moderation Logging
# Records filtered messages to logs folder for staff review
# logging-enabled: master switch for all logging
# log-*: individual toggles for each filter type
moderation:
logging-enabled: true
log-word-filter: true
log-caps-control: true
log-cooldown: true
log-mentions: true
# Player Mentions
# Allows @playerName to mention players (triggers notification)
# enabled: toggles mention system
# cooldown: seconds between mentions to same player to prevent spam
# cooldown-message: shown when player tries to mention too soon ({time} = remaining, {player} = mentioned player)
mentions:
enabled: true
cooldown: 5
cooldown-message: "&c[x] You must wait {time} more seconds before mentioning {player} again!"
# Available Permissions:
# - hychat.bypass.filter: Bypass word filter
# - hychat.bypass.caps: Bypass caps control
# - hychat.bypass.cooldown: Bypass chat cooldown
# - hychat.reload: Use /hychat reload command
# - hychat.preview: Use /hychat preview command
Commands:
/hychat (for reload)
/hychat preview {player} (Preview the chat format of a specific player)
Permissions:
- hychat.bypass.filter: Bypass word filter
- hychat.bypass.caps: Bypass caps control
- hychat.bypass.cooldown: Bypass chat cooldown
- hychat.reload: Use /hychat reload command
- hychat.preview: Use /hychat preview command
Support:
For help, bug reports, or suggestions, join our Discord server.


