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

adfdotdev