Description

💬 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

📜 Commands

Command Description Permission /spchat mute <player> <duration> <unit> Mutes a player for a specified duration (units: s / m / h / d). OP Level 2 /spchat unmute <player> Immediately lifts a mute from a player. OP Level 2 /pub <message> Broadcasts a highlighted global server announcement. All players (cooldown applies) /msg <player> <message> Sends a styled private message to another player. All players /tell <player> <message> Alias for /msg. All players /w <player> <message> Alias for /msg. All players /r <message> Replies to the last private message . All players

⚙️ Configuration (superchat-server.toml)

The configuration file is generated automatically in your server's config folder on the first launch. You can customize the following settings:

Default Value Description click_name_command /tpa %player% The command suggested in the chat when clicking a player's name. click_message_command /msg %player% The command suggested in the chat when clicking a message. blacklisted_commands msg, tell, w, say, me, pub… Commands that muted players are strictly blocked from using. chat_cooldown_seconds 5 Anti-spam delay (in seconds) required between sending chat messages. filtered_words (empty) List of blacklisted words to automatically censor in the chat. filter_replacement *** The replacement string used to hide filtered words. pub_cooldown_minutes 20 Cooldown duration (in minutes) required between uses of the /pub command. pub_prefix 📢 [ANNONCE] The prefix prefixing all global server announcements. pub_color §6§l The formatting color code applied to announcement texts. msg_format_sender §8[§dYou §8→ §d{target}§8] §f{message} Private message format displayed on the sender's side. msg_format_receiver §8[§b{sender} §8→ §bYou§8] §f{message} Private message format displayed on the receiver's side. mentions_enabled true Enables or disables visual @mentions notifications in chat. mention_color §e§l The formatting color code applied to the @mention text. chat_log_enabled true Saves all chat logs and activities into a dedicated server log file. tab_sort_enabled true Enables sorting the player tab list dynamically by LuckPerms weight/rank. tab_rank_order owner, admin, moderator… The custom hierarchy order for the tab list sorting (from top to 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.