为MC原版聊天框带来手机聊天APP版的体验
原子聊天（AtomChat）是基于 E33Chat 理念而开发的全新聊天美化 mod，旨在把原版聊天屏改造成「手机 App」风格的独立聊天面板，元素包括：圆角气泡、自定义头像、真实玩家名、表情 / 颜文字 / 表情包、图片消息、复制引用、多行输入与 QQ 式动效，以及除聊天界面外的更多界面。
渲染层使用 Skija，所有界面由矢量绘制，不依赖原版聊天纹理。
状态：v0.2.5 已实现并已发布（Fabric / NeoForge 1.21.1）。可从 Releases 下载；项目是有意做成 E33Chat 思路的干净重写，不是 E33Chat 的 fork。
| 依赖 | 类型 | 说明 |
|---|---|---|
| Minecraft | 必需 | 1.21.1 |
| Fabric Loader | 必需（Fabric 版） | 0.16.0+ |
| Fabric API | 必需（Fabric 版） | 任意兼容 1.21.1 的版本 |
| NeoForge | 必需（NeoForge 版） | 21.1.235 |
| Java | 必需 | 21+ |
- 打开聊天即可看到手机面板：顶部为「公屏」与系统时间，中部为消息列表，底部为输入栏
- 输入文字回车发送；文字超过一行时输入栏会自动长高，仍可上下移动光标
- 点 图片图标 选择本地图片，或直接 拖图片进窗口 / Ctrl+V 粘贴，上传后自动插入草稿
- 点 表情图标 打开面板：
表情/颜文字/表情包三个标签页 - 右键任意消息可 复制 或 引用回复；单击头像打开玩家档案页，双击头像触发 QQ 式戳一戳动画，右键头像则呼出菜单，选择 @ 提及，私聊，传送与屏蔽
- 💬 聊天气泡与头像 — 你的消息显示在右侧，其他人的在左侧，附带真实玩家名称和圆形皮肤头像；皮肤头像自动从正版 / 离线皮肤解析降级
- 🧹 简洁原版 HUD 占位符 — 在面板外部，图片代码显示为绿色
[图片]，引用显示为蓝色[引用]，不再刷长串代码 - 📝 多行输入 — 输入框最多显示两行，内容更长时内部滚动；按上/下箭头可在行间移动，而单行草稿则保留原版聊天历史记录
- 🧠 消息捕获 — 真实玩家身份从 MessageHandler 的三个通道中捕获，支持花名服；未知消息会降级为系统文本
- 📑 保留聊天记录 — 开启后按服务器 / 世界保存在磁盘，重进同一服务器恢复，可设置自动清理
- 📱 手机面板界面 — 原版聊天 HUD 打开期间隐藏，AtomChat 以独立面板呈现；面板模糊背景 + 半透明毛玻璃输入栏
- 🖼️ 自定义头像 — 本地选图裁剪成方形头像，档案页与自己的气泡即时显示；同一服务器装了 AtomChat 时自动同步给其他玩家（换头像即时广播刷新），无伴侣环境静默降级为皮肤
- 🔔 通知横幅与音效 — 被 @、被引用、收到私聊时面板顶部弹出横幅（点击跳转原消息并高亮），配套原创合成的气泡提示音；设置 → 聊天 →「通知」可分别开关并调音量
- 🖼️ 图片消息 — 原生渲染
[[CICode]]图片协议（与 E33Chat / ChatImage 互通），按原图比例显示；加载中显示占位文案；右键图片可保存原图到本地 - 📤 本地图片发送 — FlatLaf 文件选择器默认“详细信息”视图并直接显示缩略图；支持拖放 / Ctrl+V 粘贴；上传到图床后自动生成 CICode
- 😀 表情 / 颜文字 / 表情包 — 三个标签页带滑动指示器与全宽 push 切换动画；表情包从
<config>/atomchat/emotes/持久化（png/jpg/jpeg，最多 10 个），+号选择图片，悬停×删除 - ⚡ 常用语 — 输入栏闪电按钮打开常用语列表；点选插入输入框（不直接发送），支持新增 / 行内编辑 / 删除，单条 ≤256 字符、最多 20 条
- 🔗 富文本消息 — 玩家名/正文支持颜色、下划线、点击与悬停：
/tell、坐标、FTB 接受/拒绝、外部链接均可点；裸 URL 自动转链接 - 📋 复制 / 引用 / 保存 — 右键消息复制、引用；图片消息可保存原图；菜单带 20×20 SVG 线性图标
- 🧭 头像菜单 — 右键头像可 @ 提及、跳转私聊、快速传送与屏蔽；单击头像进入个人档案，双击触发 QQ 式戳一戳
- 🪢 私聊 — 聊天列表列出当前在线玩家，单击进入聊天界面，右键呼出菜单（个人档案 / 传送 / 屏蔽）
- 👥 在线玩家与会话列表 — 会话列表按「公屏 → 在线玩家 → 最近离线」排序，玩家卡带真实 ID、皮肤头像、在线/离线状态点与未读红点；私聊走
/msg，分会话存储草稿与滚动位置，离线/屏蔽只读 - 🖥️ 档案详情页 — 从聊天或会话列表推入玩家档案：数据总览、复制按钮、角色标识；聊天与档案之间整页推入转场
- 🧭 手机式导航 — 底部三个标签页（聊天 / 个人 / 设置）与页面级推入/弹出转场，公屏与私聊之间同款切换动画
- ⚙️ 设置页 — Win11 风格 2×2 磁贴主页（外观 / 聊天 / 隐私与屏蔽 / 关于），点击进入子页；开关为 iOS 比例滑块动画，全部选项即时生效并立即写盘，无需重启
- 🎛️ 可调项 — 背景模糊、界面动画（装饰动效总闸）、背景不透明度、面板宽度（400–600）、界面缩放（x0.75–x1.50，即时缩放整套 UI）、消息入场动画、双击头像戳一戳
- 🖼️ 自定义壁纸 — 从本地选一张图片作为面板背景，自动降采样（长边 ≤1024，后台解码不卡帧）；与背景模糊互斥，不透明度滑块用于压暗壁纸保证文字可读
- 🚫 屏蔽管理 — 设置内可视化屏蔽名单（头像 + 名字 + 一键取消）；「隐藏被屏蔽玩家的消息」可关，关掉后公屏仍可见但私聊保持屏蔽
- 🎨 主题与全量配色 — 主题预设（毛玻璃 / 现代）一键切换；设置页提供全部界面配色（面板背景 / 气泡 / 次要胶囊 / 文字 / 卡片 / 描边 / 强调色），颜色分组可折叠，每项带实时预览色块
- ⏱️ 时间戳分隔 — 消息列表首条消息始终显示时间戳胶囊，之后按可配置的时间间隔显示
- ✏️ 跨消息文字选择 — 在消息列表上跨多条消息拖选文字，Ctrl+C 一次复制多段；拖动不会误触点击
- 🛡️ 防刷屏与紧凑分组 — 连续相同消息合并为一条并显示次数；同一发送者 5 分钟内的连续消息只保留第一条头像与名字，后续间距收紧
- 🌐 图片接收开关 — 关闭后不下载不缓存，显示绿色
[图片]占位 - 🔄 传送模式循环 —
/tp//tpa/auto三档一键循环 - 🌍 本地化 — 支持中英双语，切换MC系统语言即可生效
- ⌨️ 输入法与联机体验 — IMBlocker 命令态桥接、WATUT 输入中指示（对方正在输入）
- 🎨 SVG 图标与统一动效 — 图片 / 表情 / 发送按钮为内嵌 SVG 线性图标
- 🛠️ 纯 Skia 渲染 — 圆角、阴影、滚动、文字全部矢量绘制；提供动画 / 布局 / Token 纯类与 JUnit 测试
- 自己的气泡靠右、他人靠左；名称贴在气泡边缘，头像与气泡顶对齐
- 单击头像：打开玩家档案详情页（300ms 内再次点击则为戳一戳）
- 双击头像：触发头像抖动（QQ 式 poke）
- 右键气泡：
复制/引用；图片气泡额外显示保存，可下载原图到本地 - 收到含
[[CICode,url=...,name=...,w=...,h=...]]的消息会渲染为图片气泡；兼容旧版无尺寸代码
- 点击图片按钮 → FlatLaf 选择器（默认打开
Pictures/图片文件夹，带缩略图预览） - 拖拽图片文件到游戏窗口，或复制图片后
Ctrl+V：自动上传并插入草稿 - 上传过程输入框占位显示「图片上传中…」；完成后按回车发送
- 当前默认图床为 uguu.se，链接约 3 小时过期；本模组暂无服务端媒体托管
- 目录：
.minecraft/config/atomchat/emotes/ - 支持 png / jpg / jpeg，按文件名排序，最多 10 个
- 在「表情包」标签页点末尾
+添加；悬停缩略图显示×可删除 - 点击表情包会自动上传并插入草稿，然后关闭面板（一次一个）
- AtomChat 使用 Minecraft 的语言文件：
assets/atomchat/lang/zh_cn.json与en_us.json - 在游戏设置切换语言后，标题、标签页、右键菜单、输入占位符、文件选择器文案会随之变化
推荐方式：游戏内 设置 页（Win11 风格磁贴主页：外观 / 聊天 / 隐私与屏蔽 / 关于）。所有选项即时生效并立即写盘，无需重启，颜色项带预设色板、+ 号自定义拾色器与实时预览。
高级方式：直接编辑 .minecraft/config/atomchat/atomchat-client.json（首次启动自动生成，手动修改后需重启游戏）。常用键：
| 键 | 默认值 | 说明 |
|---|---|---|
panelWidth / panelHeight |
440.0 / 780.0 |
面板尺寸（设计像素，内部再乘 UI 缩放） |
panelOpacity |
0.93 |
面板背景不透明度 |
uiScale |
1.0 |
界面缩放（x0.75–x1.50） |
blurEnabled |
true |
面板背景高斯模糊（与壁纸互斥） |
animationEnabled / messageEntryAnimation / avatarPokeEnabled |
true |
动画总开关 / 消息入场 / 头像戳一戳 |
themeName |
— | 主题预设（frosted / modern） |
accentColor |
0xFF4A90E2 |
强调色（发送按钮 / 引用条 / 滚动条等） |
ownBubbleColor / bubbleTextColor |
0xFF1E90FF / 0xFFFFFFFF |
自己气泡底色 / 文字色 |
otherBubbleColor / otherBubbleTextColor |
0xFF2C3E50 / 0xFFFFFFFF |
他人气泡底色 / 文字色 |
secondaryCapsuleBg / secondaryCapsuleText |
0x962C3E50 / 0xDCAAAABA |
次要胶囊底色 / 文字色（系统消息、时间戳、引用胶囊共用） |
textPrimaryColor / textSecondaryColor |
0xFFFFFFFF / 0xDCAAAABA |
界面主文字 / 次要文字 |
panelBgColor / panelOutlineColor / panelOutline |
0xEE16191F / 0xFFFFFFFF / true |
面板背景 / 描边颜色 / 描边开关 |
timestampIntervalMinutes |
5 |
时间戳分隔间隔（0 = 关闭） |
imageMessagesEnabled |
true |
图片消息接收开关 |
antiSpamEnabled / compactMessagesEnabled |
true / false |
防刷屏合并 / 紧凑消息分组（默认关） |
chatHistoryEnabled / historyRetentionDays |
false / 7 |
保留聊天记录 / 历史保留天数（0 = 永久，默认 7 天） |
teleportCommandMode |
"auto" |
传送命令模式（auto / tp / tpa） |
debug |
false |
调试输出 / 头像采样 PNG（写入 config/atomchat/debug/） |
.minecraft/config/atomchat/ 下存放 atomchat-client.json 与各数据子目录：
| 路径 | 内容 |
|---|---|
atomchat-client.json |
主配置文件（首次启动自动生成） |
avatar/ |
自定义头像（256px PNG） |
emotes/ |
表情包（png / jpg / jpeg，最多 10 个） |
wallpaper/ |
自定义壁纸 |
history/ |
聊天记录（各存档 / 服务器独立） |
debug/ |
调试模式下导出的头像采样 PNG |
此外，自动下载的聊天图片缓存与他人头像数据位于 <游戏目录>/atomchat-data/（上限 500 文件 / 100 MB，可在 设置 → 关于 中查看并清空）。
| 项 | 状态 |
|---|---|
| Fabric 1.21.1 | ✅ 支持 |
| NeoForge 1.21.1 | ✅ 支持 |
| Java 21+ | ✅ 必需 |
| 服务端 | ✅ 无需安装（纯客户端）；服务端安装后激活自定义头像同步 |
[[CICode]] 图片协议 |
✅ 与 E33Chat / ChatImage 系互通 |
| 花名 / 昵称插件 | 🟡 尽力识别（点击私聊 / Tab 名 / 装饰名结构）；极端未知格式回退灰字 |
| 聊天头像（ChatHeads） | ✅ 兼容 |
| 聊天动画（Chat Animation）/ 同类型动画 Mod | ✅ 兼容 |
| EasyBot | 🟡 尽力识别（QQ 消息类型解析）；无法解析则回退灰字 |
| Quark | 🚫 不显示表情菜单，正尝试兼容 |
| 其他加载器 / 版本 | ❌ 目前仅支持 Fabric / NeoForge 的 1.21.1 |
- 目前支持 Fabric / NeoForge 1.21.1；Skija Windows x64 原生库已内置，Linux / macOS 尚未打包（无法运行）
- 图片默认上传第三方图床 uguu.se，约 3 小时过期；暂无服务端媒体托管（计划）
- 暂无 E33Chat 的私聊侧边栏、搜索等能力；服务端格式模板已支持（手改
chatTemplates/whisperTemplates），按世界聊天记录持久化已内置（默认关闭） - 玩家身份解析为尽力而为：tell-click 结构捕获、离线 seen 缓存、ownDisplayName 多级降级；极端未知格式回退灰字
- 聊天记录持久化默认关闭；开启后按服务器 / 世界保存在磁盘，重进同一服务器恢复，跨世界 / 服务器不会串台
Warning
你发送的本地图片会被上传到第三方图床（默认 uguu.se）且他人可保存。你的消息也可能被开启了聊天记录的用户保存。请勿发送敏感或私密内容。
- 模组不上传任何遥测 / 个人信息
- 图片上传仅在主动选择 / 粘贴 / 拖入图片时发生
- 本地配置与表情包仅存于
.minecraft/config/atomchat/，不会自动同步 - 皮肤头像解析会按玩家名 / UUID 请求 Minecraft 皮肤服务，属于原版同款行为
需要装服务端吗？ 不需要，AtomChat 是纯客户端模组，但服务端安装则激活自定义头像功能。
怎么发图片？ 点图片按钮选择本地图片，或拖图片进窗口 / Ctrl+V 粘贴；上传完成后自动插入草稿，再回车发送。
为什么某条消息显示为灰色系统消息？ 客户端无法确定它是玩家消息时会保守归为系统灰字（例如昵称插件使用无法解析的格式）。
表情包存在哪里？ .minecraft/config/atomchat/emotes/，最多 10 个，支持 png / jpg / jpeg。
怎么改颜色 / 大小？ 游戏内 设置 → 外观 即时调整（颜色项带预设与自定义拾色器）；也可以编辑 config/atomchat/atomchat-client.json 后重启游戏。
可以放进整合包吗？ 可以。AtomChat 代码为 MIT，无需额外授权；若整合包分发 JAR，请保留 THIRD_PARTY_NOTICES.md 中的第三方声明。
若发现 bug，或想提建议，可到 Issues 反馈，或直接在百科 / 平台评论区留言。
./gradlew.bat build产物位于 build/libs/atomchat-Fabric-1.21.1-<version>.jar。
./gradlew.bat test运行 JUnit 测试（纯逻辑层：动画 / 布局 / 消息解析 / 表情包存储）。
主要模块：
AtomChatScreen— Skia 自绘聊天面板（编排层）UiLayout/UiTokens/UiMotion— 布局数学、尺寸 Token、动画时长chat/— e33chat 思路移植的消息捕获 / 分类 / 呈现管线emote/— 表情包持久化与 Skia 图片缓存mixin/— 原版聊天捕获与 IME / 建议框接入
完整变更见源码分支 Fabric-1.21.1/CHANGELOG.md。
AtomChat 自身代码以 MIT 发布，但分发的 JAR 中捆绑了以下第三方组件，各自保留其许可证：
| 组件 | 许可证 |
|---|---|
| Skija（Java 绑定） | Apache License 2.0 |
| HumbleUI types | Apache License 2.0 |
| FlatLaf | Apache License 2.0 |
| Skia（原生库） | BSD 3-Clause |
完整版权与许可证文本见 THIRD_PARTY_NOTICES.md。
Copyright © 2026 E33EPUS