AwesomeChat

---

The all-in-one chat management plugin for Paper servers.

Please note, if you use 26.x, you will need to use Java 25.

Why AwesomeChat?

Most servers need 3–5 separate plugins to handle chat formatting, filtering, private messaging, and moderation.
AwesomeChat replaces them all with one lightweight, well-integrated solution.

• Zero bloat – Every feature is toggleable
• Deep LuckPerms integration – Per-group everything
• Adventure API native – Full MiniMessage and hex color support
• Actively maintained for 1.19+

Features

Chat Formatting

• Per-group chat formats via LuckPerms
• Automatic prefix / suffix integration
• PlaceholderAPI support
• Hex color support (&#RRGGBB)
• MiniMessage formatting (toggleable)
• Permission-based color & style gating

Chat Channels

• Create unlimited custom channels (staff, admin, VIP, etc.)
• Per-channel permission, prefix, format, and sound
• Toggle mode or one-off messaging
• /ch join staff or /ch staff Hello!

Chat Filter Engine

• Cooldown – Rate-limit messages
• Spam detection – Jaro-Winkler similarity algorithm
• Censor mode – Replace bad words instead of blocking
• Banned words – Wildcard patterns from .txt files
• Anti-advertising – TLD blocking, phrase matching, regex
• Custom regex rules – Named rules with custom patterns
• Graduated punishments – Warn → mute → ban
• Command filtering – Filters apply to commands
• Violation logging – File + per-player records

Private Messaging

• /msg, /reply, /whisper, and more
• Custom formats and sounds
• Message toggle (/msgtoggle)
• Social spy for staff

Player Ignore

• /ignore <player> – Hide chat & block PMs
• Persistent across restarts
• Staff bypass permission

Mentions

• @player
• @(role)
• @everyone / @here
• Per-type sounds, colors, and action-bar alerts
• Permission-gated per mention type

Emoji Shortcuts

• :heart:, :star:, :fire:, etc.
• 20 built-in Unicode emojis
• Fully configurable via config.yml
• Permission-gated (awesomechat.emoji)

Join / Leave Messages

• Per-group join & leave messages
• First-join messages
• MOTD on join
• Configurable sounds
• PlaceholderAPI support
• EssentialsX vanish integration

Item Display

• [item], [inventory], [enderchest], [/command]
• Hover tooltips & inventory snapshots
• Read-only GUI with expiry
• Permission-gated triggers

Chat Radius / Local Chat

• Distance-based chat
• Per-group radii via LuckPerms
• Shout prefix (!)
• Optional cross-world support

Chat Logging

• SQLite or MySQL storage
• /chatlogs <player>
• Clickable pagination
• Fully async

Developer API

• AwesomeChatAPI
• ChatFilterViolationEvent

Requirements

• Server: Paper 1.19 – 1.21.11+
• Java: 21+
• Required: LuckPerms
• Optional: PlaceholderAPI

Commands

/awesomechat (/ac)
/broadcast
/msg (/tell, /w, /pm)
/reply (/r)
/msgtoggle
/socialspy (/sspy)
/channel (/ch)
/ignore (/block)
/clearchat (/cc)
/mutechat (/mc)
/chatlogs (/cl)

Support

Join our Discord
Discord: adf.dev