Chat Control | Staff Tools & GUI v1.0.0

AdvancedChat is a premium all-in-one chat management plugin for Minecraft servers. It combines a full channel system, GUI-based staff moderation, anti-spam, word filtering, player reports, chat colors, Discord webhook integration and a clean developer API — all in a single plugin with no bloat.


Channel System

Four dedicated channels — Global, Local, Staff and Owner. Switch instantly with a command or send a one-time message without leaving your current channel. Prefix any message with ! to send global from anywhere.


Staff Menu — GUI Moderation

Right-click any player in chat to instantly open their full Staff Menu. Mute, Ban, Kick, Freeze, Warn, view Message History, view Punishment History, add Notes and inspect Inventory — everything from a single GUI, no commands needed.


Message History

View the last 20 messages sent by any player this session directly from the Staff Menu. Each entry shows the channel, the message content and the exact timestamp.


AutoMod — Anti-Spam & Slow Mode

Anti-spam detects repeated messages using Levenshtein similarity at an 80% match threshold. Players cannot bypass it by swapping letters or adding spaces — all messages are fully normalized before comparison. Slow Mode enforces a per-player cooldown between messages.


Chat Filter

Rule-based word filter with four action types: BLOCK, REPLACE, WARN and WARN_MUTE. The built-in TextNormalizer catches leet speak, spaced-out words, repeated characters and Unicode lookalikes before checking any rule — making filter bypass nearly impossible. Supports plain words, wildcards and full regex patterns.


Chat Color System

Players open a GUI with /acolor and choose their personal chat color. Hover any gem to see a live in-game preview before activating. Supports MiniMessage gradient formats. Built-in presets include Fire, Ocean, Galaxy, Forest, Gold, Pink, Ice, Sunset, Wine and Night. Each color is permission-gated for rank-based access.


Mention System

Tag any online player with Name — partial name matching is supported. Tag the entire server with Everyone (permission-gated). The mentioned player receives a sound notification and a chat message. Players can toggle mentions on or off with /mention off.


Report System

Players report rule-breakers with /report <player> <reason>. Reports are saved persistently and survive server restarts. Staff receives an instant in-game notification. All reports are browsable from a GUI panel — one click opens the reported player's Staff Menu directly.


Discord Webhook

Global and Local chat messages are forwarded to a Discord channel automatically. Fully configurable format with player name and message content.


AdvancedChat vs Competitors



Commands



Permissions



Default config.yml

# AdvancedChat - Main Configuration
# MiniMessage: https://docs.advntr.dev/minimessage/format.html
# Legacy colors (&c, &l) are also supported.

language: en
update-checker: true
spigot-resource-id: 0

chat:
local-radius: 100
slow-mode:
enabled: true
delay-seconds: 3
anti-spam:
enabled: true
duplicate-threshold: 3
duplicate-window-seconds: 10

# Placeholders: {player} {message} {prefix} {suffix} {group} {world}
# PlaceholderAPI placeholders are also supported.
format:
global: "[G] {prefix}{player}: {message}"
local: "[L] {prefix}{player}: {message}"
staff: "[SC] {prefix}{player}: {message}"
owner: "[OC] {prefix}{player}: {message}"
# MiniMessage and legacy color codes supported. Example:
# global: "<dark_gray>[<green>G</green>]</dark_gray> {prefix}{player}: {message}"

mention:
enabled: true
sound: ENTITY_EXPERIENCE_ORB_PICKUP
volume: 1.0
pitch: 1.0
highlight: "@{name}" # MiniMessage supported
everyone-highlight: "@{name}" # MiniMessage supported

log:
enabled: true
file: logs/chat.log
log-staff-chat: true
log-owner-chat: true

# type: json | mysql
storage:
type: json
mysql:
host: localhost
port: 3306
database: advancedchat
username: root
password: ""
ssl: false

discord:
enabled: false
webhook-url: "WEBHOOK_URL_HERE"
format: "{prefix} {player}: {message}"

Click to expand...

filter.yml

# ACTIONS:
# BLOCK - Cancel the message entirely
# REPLACE - Replace with the replacement string
# WARN - Warn the player, still deliver the message
# WARN_MUTE - Warn + auto-mute for mute-duration
#
# PATTERNS:
# Plain word -> "word" matches anywhere in message
# Wildcard -> "word" matches with anything around it
# Regex -> "regexattern" full Java regex support
#
# NORMALIZATION (automatic, cannot be bypassed):
# Leet speak: f4ck -> fuck
# Spaced out: f u c k -> fuck
# Repeated: fuuuck -> fuck
# Unicode: fuck -> fuck

enabled: true
log-violations: true

whitelist:
- "scunthorpe"
- "assassin"
- "classic"
- "analiz"

words:
fuck:
pattern: "fuck"
action: BLOCK
shit:
pattern: "shit"
action: BLOCK
ass:
pattern: "ass"
action: REPLACE
replacement: "***"
retard:
pattern: "retard"
action: WARN_MUTE
mute-duration: "5m"
hitler:
pattern: "hitler"
action: WARN_MUTE
mute-duration: "10m"
nazi:
pattern: "nazi"
action: WARN
ip_advertise:
pattern: "regex:\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}"
action: BLOCK
discord_invite:
pattern: "regex:discord\\.gg/[a-zA-Z0-9]+"
action: BLOCK

Click to expand...

Developer API

Access all managers directly through the plugin instance:

AdvancedChat plugin = AdvancedChat.getInstance();

Click to expand...

ChatManager — Channels & Messages

ChatManager cm = plugin.getChatManager();

// Get / set active channel
Channel ch = cm.getChannel(player); // LOCAL, GLOBAL, STAFF, OWNER
cm.setChannel(player, Channel.GLOBAL);

// Send through a channel (applies format, PAPI, colors)
cm.sendGlobal(player, "message");
cm.sendLocal(player, "message");
cm.sendStaffChat(player, "message");
cm.sendOwnerChat(player, "message");

// Build a formatted Component manually
Component comp = cm.buildChatComponent(player, "message", format, addStaffButton);

Click to expand...

PunishmentManager — Mute, Ban, Kick

PunishmentManager pm = plugin.getPunishmentManager();

// Duration format: 5m, 1h, 1d, permanent
pm.mute(target, staffPlayer, "10m", "Spam");
pm.ban(target, staffPlayer, "1d", "Rule violation");
pm.kick(target, staffPlayer, "Reason");

// Auto-mute without a staff player (e.g. from your own filter)
pm.muteAuto(target, "5m", "AutoFilter");

Click to expand...

AntiSpamManager

AntiSpamManager asm = plugin.getAntiSpamManager();

boolean isSpam = asm.isSpam(player.getUniqueId(), "message"); // true = block
asm.clearPlayer(uuid);
asm.clearAll();

Click to expand...

ChatColorManager

ChatColorManager ccm = plugin.getChatColorManager();

// {msg} is replaced with the player's message
ccm.setColor(uuid, "<gradient:#ff0000:#ffff00>{msg}</gradient>");
ccm.resetColor(uuid);
String format = ccm.getColor(uuid); // null if not set
boolean hasColor = ccm.hasColor(uuid);
String result = ccm.applyColor(uuid, "hello");

Click to expand...

MentionManager

MentionManager mm = plugin.getMentionManager();

// Process @mentions — sends notifications, returns highlighted string
String processed = mm.processMentions(sender, rawMessage);
boolean nowEnabled = mm.toggleMention(player);
mm.setMentionEnabled(player, false);
boolean isToggled = mm.isMentionToggled(player);

Click to expand...

FreezeManager

FreezeManager fm = plugin.getFreezeManager();

fm.freeze(uuid);
fm.unfreeze(uuid);
boolean frozen = fm.isFrozen(uuid);
boolean nowFrozen = fm.toggle(uuid);

Click to expand...

MessageCache — Last 20 Messages

MessageCache mc = plugin.getMessageCache();

mc.add(uuid, "GLOBAL", "message");

// Returns newest first, max 20 entries
List<CachedMessage> msgs = mc.getMessages(uuid);
for (CachedMessage msg : msgs) {
String channel = msg.channel;
String content = msg.message;
String timestamp = msg.getFormattedTime(); // HH:mm:ss
}

Click to expand...

ReportManager

ReportManager rm = plugin.getReportManager();

rm.addReport("Alex", "Steve", "Spam");
List<Report> all = rm.getAll();
List<Report> byUser = rm.getByTarget("Steve");
int cleared = rm.clearAll();
int cleared = rm.clearByTarget("Steve");
// fields: .reporterName .targetName .reason .timestamp .getFormattedTime()

Click to expand...

WarnManager

WarnManager wm = plugin.getWarnManager();

wm.addWarn(targetUUID, "Steve", staffUUID, "Admin", "Swearing");
List<Warn> warns = wm.getWarns(uuid);
int count = wm.getWarnCount(uuid);
wm.clearWarns(uuid);
// fields: .targetName .staffName .reason .timestamp .getFormattedDate()

Click to expand...

NoteManager

NoteManager nm = plugin.getNoteManager();

nm.addNote(uuid, "AdminName", "Suspicious behavior.");
List<Note> notes = nm.getNotes(uuid);
nm.removeNote(uuid, 0); // Remove by index
// fields: .staffName .text .timestamp .getFormattedDate()

Click to expand...

ChatFilter

FilterResult result = plugin.getChatFilter().check("raw message");

switch (result.getStatus()) {
case CLEAN -> { /* allow */ }
case BLOCKED -> { /* cancel event */ }
case REPLACED -> event.setMessage(result.getModifiedMessage());
case WARNED -> player.sendMessage("Warning!");
case WARN_MUTED -> plugin.getPunishmentManager().muteAuto(player, "5m", "Filter");
}

Click to expand...

SpyManager

SpyManager sm = plugin.getSpyManager();

boolean isSpy = sm.isSpy(player);
sm.toggle(player);

Click to expand...

Soft Dependencies

• Vault — enables {prefix}, {suffix} and {group} placeholders in chat formats
• PlaceholderAPI — enables all PAPI placeholders in chat formats

Neither is required. Both are detected and activated automatically if present.