💬 Super Chat — Forge Mod

Super Chat is a lightweight utility mod for Minecraft Forge that elevates every message beyond plain text. Player names and chat messages become clickable shortcuts, a robust moderation toolkit keeps your community in check, and quality-of-life features like @mentions, public announcements, and private message styling make communication genuinely enjoyable.

✨ Features

🖱️ Interactive Chat

Every message in the chat is now interactive. Click a player's name to instantly suggest a teleport command (/tpa), or click the message text to pre-fill a private reply (/msg). Both actions are fully configurable in the config file. Roles and prefixes from LuckPerms are fully preserved and displayed normally alongside all interactive features.

🔇 Advanced Mute System

Silence disruptive players with /spchat mute. Mutes survive server restarts — they are saved to disk and automatically expire at the correct time even after a reboot. Muted players receive clear, real-time feedback when they try to speak or use blocked commands.

🚫 Command Blacklist

Define a list of commands that muted players cannot use (e.g. /me, /say, /tell, /msg, /pub). All other commands remain accessible — mutes are surgical, not a blanket ban.

📢 Public Announcements — `/pub`

Send a highlighted, eye-catching announcement to the entire server. A visual separator frames the message to make it stand out from regular chat. A configurable cooldown (default: 20 minutes) prevents spam, and server operators bypass it automatically.

💌 Styled Private Messages

/msg, /tell, and /w are replaced with a visually distinct format that is easy to distinguish from public chat. Each private message is also clickable to reply instantly. A new /r command lets you reply to your last conversation partner in one keystroke.

🔔 @Mentions

Type @PlayerName anywhere in your message to highlight it in bold yellow and notify the target player with a bell sound and an action-bar alert. Works dynamically with all currently online players.

⏱️ Anti-Spam Cooldown

A configurable delay between messages (default: 5 seconds) prevents chat flooding. Server operators are automatically exempt. The remaining cooldown is shown directly on the player's action bar.

🔤 Word Filter

Define a list of banned words in the config. They are automatically replaced with a configurable string (default: ***) before the message is broadcast. Filtering is case-insensitive and supports partial matches.

📋 Chat History Log

All chat activity — public messages, private messages, announcements, mutes, and unmutes — is logged to logs/superchat_log.txt with timestamps. Useful for moderation audits.

🗂️ Tab List Sorting (LuckPerms soft-dependency)

Players are automatically sorted in the tab list according to their LuckPerms rank. The order is fully configurable (e.g. Owner → Admin → Moderator → VIP → Default). If you already use a dedicated tab mod (TabTPS, BetterTab, etc.), this feature can be disabled in the config to avoid conflicts.

🛠️ Admin Commands

Command	Description	Permission
`/spchat mute <player> <duration> <unit>`	Mute a player for a given time (`s` / `m` / `h` / `d`)	OP level 2
`/spchat unmute <player>`	Remove a mute immediately	OP level 2
`/pub <message>`	Broadcast a highlighted server announcement	All players (cooldown applies)
`/msg <player> <message>`	Send a styled private message	All players
`/tell <player> <message>`	Alias for `/msg`	All players
`/w <player> <message>`	Alias for `/msg`	All players
`/r <message>`	Reply to your last private message conversation	All players

⚙️ Configuration

The mod generates superchat-server.toml automatically on first launch.

Setting	Default	Description
`click_name_command`	`/tpa %player%`	Command suggested when clicking a player name
`click_message_command`	`/msg %player%`	Command suggested when clicking a message
`blacklisted_commands`	`msg, tell, w, say, me, pub…`	Commands blocked for muted players
`chat_cooldown_seconds`	`5`	Anti-spam delay between messages
`filtered_words`	(empty)	Words to censor in chat
`filter_replacement`	`***`	Replacement string for filtered words
`pub_cooldown_minutes`	`20`	Cooldown between `/pub` uses
`pub_prefix`	`📢 [ANNONCE]`	Prefix shown on announcements
`pub_color`	`§6§l`	Color applied to announcement text
`msg_format_sender`	`§8[§dYou §8→ §d{target}§8] §f{message}`	Private message format (sender side)
`msg_format_receiver`	`§8[§b{sender} §8→ §bYou§8] §f{message}`	Private message format (receiver side)
`mentions_enabled`	`true`	Enable / disable @mentions
`mention_color`	`§e§l`	Color applied to @mention text
`chat_log_enabled`	`true`	Save chat activity to log file
`tab_sort_enabled`	`true`	Sort tab list by LuckPerms rank
`tab_rank_order`	`owner, admin, moderator…`	Tab sort order (top → bottom)

🔗 Compatibility

LuckPerms — Soft dependency. Prefixes and rank display are fully preserved. Tab sorting reads LuckPerms groups via reflection (no hard dependency).
Custom Tab Mods (TabTPS, BetterTab, etc.) — Set tab_sort_enabled = false to disable Super Chat's tab sorting and let your tab mod take over.
EssentialsX / FTB Essentials — Compatible. The /msg override uses Forge's command priority system; set it as the preferred handler if conflicts arise.

Super Chat : Moderation and practice