💬 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

⚙️ Configuration

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

🔗 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.