ChatSphere

[图片占位：ChatSphere]

NeoForge 21.1.228 Fabric 1.20.1/1.21.1 Minecraft 1.21.1 LGPLv3 许可证

ChatSphere

一个适用于 Minecraft 1.21.1（NeoForge 和 Fabric）及 1.20.1（Fabric）的现代即时通讯聊天模组。 用频道、私信、表情、语音房和完整的图形界面取代了原版聊天。

在客户端侧工作——在单人游戏或原版/插件服务器上（需启用“允许原版连接”后重启），它以本地存储模式运行。在 NeoForge 或 Fabric 服务器上，需在两端同时安装以获得频道同步、私信和语音聊天功能。

---

特性

频道 — 创建带有邀请码、显示名称、描述和发现可见性的公共或私人频道。从“探索”界面浏览所有公共频道。

私信 — 点击成员列表中的任何玩家名字即可开始私聊。同样支持 /msg 和 /tell 命令。

命令控制台 — 切换到控制台模式可在聊天界面中直接运行命令。输出会显示在当前会话中。方向键可浏览历史记录。

表情选择器 — 包含来自 twemoji 的 349 个表情，支持分类标签、搜索和 :短代码: 自动补全。

语音聊天 — 与 Simple Voice Chat（隔离群组）和 PlasmoVoice（广播线路）双重集成。可与任一或两者同时使用；运行时自动检测。

聊天搜索 — 过滤当前对话中的消息。包含匹配计数和跳转导航。

引用回复 — 右键点击任意消息可复制或带上下文引用回复。

反垃圾消息 — 重复消息自动折叠。可在服务器端配置。

成员管理 — 每个频道可设置管理员、禁言/解除禁言、踢出、邀请系统和所有权转移。

完整设置界面 — 深色主题、气泡颜色和圆角半径、按类型区分的通知声音、图标闪烁、屏幕弹窗、头像缓存等。

服务器配置 — 面向管理员的游戏内配置界面。也可使用 config/chatsphere-server.json 文件进行配置。

兼容 No Chat Reports — 在界面中直接显示 NCR 安全状态。

---

操作控制

按键	功能
T	打开聊天界面
/	以命令模式打开聊天
F7	打开设置

---

配置

客户端 — 按 F7

标签页	选项
界面	时间戳、发送者名字、头像、深色主题、保留输入、右侧边栏、频道切换
气泡	自己/他人颜色（ARGB）、圆角半径
皮肤	头像缓存开关、自定义 API 链接
NCR	NCR 兼容性开关、安全状态显示、preventChatReports 设置（当安装 No Chat Reports 时）
行为	聊天历史限制、滚动限制
声音	总开关、@提及 / 私语 / 系统 / 公共声音、屏幕弹窗

服务器 — config/chatsphere-server.toml

选项	默认值	描述
反垃圾消息	true	折叠重复消息
最大聊天历史	200	每个对话存储的消息数
启用频道	true	切换频道系统
启用探索	true	公共频道发现
探索最少成员数	2	出现在“探索”中的最少成员数
备份间隔	30 分钟	服务器数据备份频率
防止聊天举报	true	在服务器状态中声明 preventsChatReports（客户端界面中的 NCR 区域）

---

存储

ChatSphere/
├── client/singleplayer/
├── client/multiplayer/
└── server/
    ├── channels.json
    └── backups/

服务器数据每 30 分钟自动备份一次（可配置）。

---

常见问题

模组需要在服务器上安装吗？ 它可以只在客户端本地模式下运行。在两端都安装才能解锁频道同步、跨玩家私信和语音聊天。

支持哪些语音聊天模组？ Simple Voice Chat 和 PlasmoVoice。如果同时安装，两者可以同时工作。

如何加入频道？ 使用 → 按钮并输入邀请码，或从“探索”界面浏览公共频道（→ 旁边的搜索图标）。

如何创建频道？ 点击“频道”标题旁边的 +，或在输入框中输入 #名字 并按下回车。

我的数据存储在哪里？ 客户端数据存储在 ChatSphere/client/ 下，按世界/服务器区分。服务器数据存储在 ChatSphere/server/ 下。

我可以在整合包中使用这个模组吗？ 可以。

---

命令

命令	描述
/chatsphere help	显示帮助
/chatsphere list	列出所有频道
/chatsphere info <name>	查看频道详情

---

许可证

GNU LGPLv3

表情符号来自 twemoji（Twitter / CC-BY 4.0）。