Awesome Chat Plugin – Configuration Guide
Awesome Chat (by ADF) is a powerful chat customization plugin designed to enhance the chat experience on your Minecraft server. This guide provides an overview of its configuration options and features.
ℹ️ REQUIREMENTS
Awesome Chat server requirements:
✔️
LuckPerms plugin.
✔️
Java 21 or higher.
✨ Features Overview
Awesome Chat includes a variety of chat enhancements:
✅
PlaceholderAPI Support – Use placeholders to display dynamic information.
✅
LuckPerms Integration – Automatically use prefixes/suffixes based on permission groups.
✅
Custom Placeholders – Define placeholders for usernames, messages, ranks, and more.
✅
Bukkit Color Codes – Enable Minecraft’s standard color and formatting codes.
✅
Per-Group Chat Formatting – Assign chat formats based on player rank/group.
✅
Clickable & Hoverable Messages – Add interactive messages with hover text or click actions.
✅
Broadcast System – Send formatted announcements globally with sounds and cooldowns.
✅
Chat Filter – Automatically block, replace, or punish messages with banned words or patterns.
✅
Private Messaging System – Use `/msg` and `/reply` with customizable formatting.
✅
Social Spy – Monitor private messages if you have permission.
✅
MiniMessage Support – Advanced formatting alternative to & codes.
✅
Support for Latest Minecraft Versions – Full compatibility with 1.21+.
⚙ Configuration Settings
Plugin Prefix
Prefix displayed before all plugin messages:
Code (Text):
prefix: "&7[&bAwesomeChat&7] "
PlaceholderAPI Integration
Enable dynamic placeholders:
Code (Text):
placeholderAPI:
enabled: true
LuckPerms Integration
Use LuckPerms prefixes and suffixes:
Code (Text):
luckperms:
enabled: true
prefix-suffix: true
Custom Placeholders
Define placeholders for chat:
Code (Text):
placeholders:
enabled: true
chat:
username: "{player}"
message: "{message}"
prefix: "{prefix}"
suffix: "{suffix}"
Bukkit Color Code Support
Code (Text):
color-codes:
enabled: true
Clickable Chat Messages
Enable actions on click:
Code (Text):
clickable-messages:
enabled: true
action: "fill" # Options: fill, execute, copy
command: "/msg %player% "
Hoverable Chat Messages
Display hover text over chat messages:
Code (Text):
hoverable-messages:
enabled: true
text-lines:
- "&bPlayer&f: &f%player%"
- "&bMoney&f: &f%vault_eco_balance_formatted%"
- ""
- "&aClick to message this player!"
- "&7Click: [/msg %player%]"
Chat Formatting
Code (Text):
chat-format:
global_format: "{prefix}&r &e{player}&7: &f{message}"
per-group-format:
enabled: true
groups:
owner: "&cOwner&r &6{player}&7: &f{message}"
admin: "&6&lAdmin &e{player}&f: &f{message}"
moderator: "&3&lMod &b{player}&f: &f{message}"
default: "{prefix} &7[&f{player}&7]: &f{message}"
Private Messaging & Social Spy
Code (Text):
private-messages:
enabled: true
socialspy:
enabled: true
format:
sender: "&7[&bYou &7-> &b{receiver}&7] &f{message}"
receiver: "&7[&b{sender} &7-> &bYou&7] &f{message}"
spy: "&7[&cSpy&7] &b{sender} &7-> &b{receiver}&7: &f{message}"
errors:
use-plugin-prefix: true
player-not-found: "&cThat player could not be found!"
reply-target-not-found: "&cYou have nobody to reply to!"
cannot-message-yourself: "&cYou cannot message yourself!"
messages-disabled: "&cThat player has private messages disabled!"
self-messages-disabled: "&cYou have private messages disabled!"
no-permission: "&cYou do not have permission to do this!"
Broadcast System
Code (Text):
broadcast:
enabled: true
sound: "ENTITY_EXPERIENCE_ORB_PICKUP"
format:
- "&7[&cBroadcast&7]"
- "&f%message%"
Chat Filter System
Block offensive language, spam, and advertising:
Code (Text):
chat-filter:
enabled: true
prefix: "&8[&cChatFilter&8]&r "
announce-actions: true
bypass-permission: true
punishments:
3: "warn {player} Please watch your language!"
5: "mute {player} 1d Inappropriate language."
banned-words:
- "f**"
- "s***"
- "b***h"
- "a******e"
... # truncated for brevity & decency
anti-advertising:
enabled: true
block-tlds: true
tlds:
- ".com"
- ".net"
...
rules:
- name: "swear-words"
regex: "(?i)(f--k|s---|b---h|as-----e)" # truncated for decency
player-message: "&cPlease do not use profanity!"
staff-message: "&c{player} used profanity in chat: &7{message}"
punishments:
3: "warn {player} Repeatedly attempting to use profanity"
5: "mute {player} 1d [AUTOMUTE] Repeated attempts to use profanity"
7: "mute {player} 7d [AUTOMUTE] Repeated attempts to use profanity"
Final Thoughts
Awesome Chat now includes chat filters, private messaging, social spy, and latest Minecraft version support. Customize your chat, monitor messages, and keep your server community safe and interactive.
For more info, refer to:
MiniMessage documentation
PlaceholderAPI wiki
Enjoy a fully customized chat experience with Awesome Chat!
Need Support?
Join our Discord
OR
Add me on discord: adf.dev