HyChat | Chat Formatter & Moderation

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.