AwesomeChat! icon

AwesomeChat! -----

A highly configurable, chat formatting plugin, with placeholders, hoverable messages, and more!



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
Resource Information
Author:
----------
Total Downloads: 49
First Release: Apr 1, 2025
Last Update: Sep 23, 2025
Category: ---------------
All-Time Rating:
1 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings