AwesomeChat

---

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