超级聊天：管理与实践

💬 Super Chat —— Forge 模组

Super Chat 是一款适用于 Minecraft Forge 的轻量级实用模组，它让每条消息不再局限于纯文本。玩家名称和聊天消息变为可点击的快捷方式，强大的管理工具包助您维护社区秩序，诸如 @提及、公共公告和私信美化等实用功能让沟通真正成为一种享受。

---

---

✨ 功能特性

🖱️ 交互式聊天

现在聊天中的每条消息都是可交互的。点击 玩家名字 即可快速输入传送指令（/tpa），或点击 消息文本 来预填私信回复（/msg）。这两种操作均可在配置文件中完全自定义。来自 LuckPerms 的角色和前缀会完整保留，并与其所有交互功能正常共存显示。

🔇 高级禁言系统

使用 /spchat mute 命令让捣乱的玩家静音。禁言在服务器重启后依然生效——它们会被保存至磁盘，且即使在重启后也能在正确时间自动过期。被禁言的玩家在尝试发言或使用被禁指令时，会收到清晰、实时的反馈。

🚫 指令黑名单

可定义一个被禁言玩家无法使用的指令列表（例如 /me、/say、/tell、/msg、/pub）。所有其他指令仍然可用——禁言是精确制导，而非一概而论的全盘封禁。

📢 公共公告 —— /pub

向整个服务器发送一条高亮醒目的公告。可视化的分隔线框出消息，使其在普通聊天中脱颖而出。可配置的冷却时间（默认：20 分钟）可防止刷屏，服务器管理员可自动绕过此限制。

💌 美化私信

/msg、/tell 和 /w 将被替换为视觉上独特、易于与公共聊天区分的格式。每条私信同样可点击以快速回复。新增的 /r 指令让您一键回复最后一位对话对象。

🔔 @提及

在消息任意位置输入 @PlayerName，即可使该文本以粗体黄色高亮显示，并通过铃声和动作栏提醒通知目标玩家。该功能可与所有当前在线玩家动态协作。

⏱️ 反刷屏冷却

消息之间的可配置延迟（默认：5 秒）可防止聊天刷屏。服务器管理员自动豁免。剩余冷却时间会直接显示在玩家的动作栏上。

🔤 词语过滤器

在配置文件中定义禁用词列表。这些词在消息广播前会被自动替换为可配置的字符串（默认：***）。过滤不区分大小写，并支持部分匹配。

📋 聊天历史记录

所有聊天活动——公共消息、私信、公告、禁言及解禁——都会连同时间戳一起记录到 logs/superchat_log.txt 文件中。对于管理审计非常有用。

🗂️ Tab 列表排序 （LuckPerms 软依赖）

玩家将根据其 LuckPerms 权限组等级在 Tab 列表中自动排序。排序顺序完全可配置（例如 服主 → 管理员 → 版主 → VIP → 默认）。如果您已在用专门的 Tab 模组（如 TabTPS、BetterTab 等），可在配置中禁用此功能以避免冲突。

---

🛠️ 管理员命令

📜 指令列表

指令	描述	权限
/spchat mute <玩家> <时长> <单位>	禁言玩家指定的时长（单位：s / m / h / d）。	OP 等级 2
/spchat unmute <玩家>	立即解除对玩家的禁言。	OP 等级 2
/pub <消息>	广播一条高亮显示的全局服务器公告。	所有玩家（受冷却时间限制）
/msg <玩家> <消息>	向其他玩家发送成型私信。	所有玩家
/tell <玩家> <消息>	/msg 的别名。	所有玩家
/w <玩家> <消息>	/msg 的别名。	所有玩家
/r <消息>	回复最后一条私信。	所有玩家

⚙️ 配置（superchat-server.toml）

配置文件会在服务器首次启动时自动生成于 config 文件夹中。您可以自定义以下设置：

设置项	默认值	描述
click_name_command	/tpa %player%	点击玩家名字时在聊天框中提示的命令。
click_message_command	/msg %player%	点击消息时在聊天框中提示的命令。
blacklisted_commands	msg, tell, w, say, me, pub...	被禁言玩家严格禁止使用的命令。
chat_cooldown_seconds	5	发送聊天消息所需的反刷屏延迟（秒）。
filtered_words	(空)	在聊天中自动审查的禁用词列表。
filter_replacement	***	用于隐藏被过滤词语的替代字符串。
pub_cooldown_minutes	20	两次使用 /pub 命令之间的冷却时长（分钟）。
pub_prefix	📢 [ANNONCE]	所有全局服务器公告的前缀。
pub_color	§6§l	应用于公告文本的格式颜色代码。
msg_format_sender	§8[§dYou §8→ §d{target}§8] §f{message}	发送方显示的私信格式。
msg_format_receiver	§8[§b{sender} §8→ §bYou§8] §f{message}	接收方显示的私信格式。
mentions_enabled	true	启用或禁用聊天中的可视 @提及 通知。
mention_color	§e§l	应用于 @提及 文本的格式颜色代码。
chat_log_enabled	true	将所有聊天日志和活动保存到专门的服务器日志文件中。
tab_sort_enabled	true	启用根据 LuckPerms 权重/等级动态排序玩家 Tab 列表。
tab_rank_order	owner, admin, moderator...	Tab 列表排序的自定义层级顺序（从上到下）。

---

---

🔗 兼容性

• LuckPerms —— 软依赖。前缀和等级显示完整保留。Tab 排序通过反射读取 LuckPerms 权限组（非硬依赖）。
• 自定义 Tab 模组（TabTPS、BetterTab 等） —— 设置 tab_sort_enabled = false 可禁用 Super Chat 的 Tab 排序，让您的 Tab 模组接管。
• EssentialsX / FTB Essentials —— 兼容。/msg 的覆盖使用 Forge 的指令优先级系统；如遇冲突，可将其设置为首选处理器。