The all-in-one chat management plugin for Paper servers.
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
AwesomeChatAPIChatFilterViolationEvent
Requirements
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
