自定义聊天
Custom Chat 是一款面向 Minecraft 1.21.11 的客户端 Fabric 模组,它将原版的聊天界面替换为更灵活的界面,同时保持与原版服务器兼容的正常 Minecraft 聊天和命令行为。
它添加了本地历史记录、多种日志格式、可点击/悬停的样式文本、翻译工具、实验性的 Rank Tooltips(排名提示)、主题,以及可选的 Twitch IRC HUD 并支持 7TV 表情渲染。
当前稳定版本:1.0.8
目前,在我暂时离开 Minecraft 开发并专注于其他项目期间,该模组的活跃开发和定期支持已无限期暂停。
这并不意味着该项目被永久弃用。源代码仍然公开,问题和拉取请求依然可用,未来可能会恢复开发。
功能
自定义聊天覆盖层
使用带样式的自定义界面替换默认的聊天屏幕。
保持正常的 Minecraft 聊天消息和命令与原版服务器兼容。
仅适用于客户端。无需安装服务器端组件。
与原版兼容的消息和命令发送
常规聊天消息和命令仍可正常工作。
命令仍作为 Minecraft 命令发送。
聊天消息仍作为正常的 Minecraft 聊天消息发送。
本地会话预览
在自定义聊天 UI 中直接显示最近的传入、传出和系统消息。
在需要点击和悬停兼容性时保留 Minecraft Text 样式。
支持带样式的聊天行,且不会破坏原版交互行为。
使用有界预览/布局处理,因此 UI 不需要每帧重建无限的历史记录。
传出历史
浏览之前发送的消息和命令。
快捷键:Ctrl + Up / Down。
本地高亮显示
在预览中高亮显示命令、玩家提及和 URL。
帮助区分普通消息、命令和有用的交互式文本。
可点击聊天兼容性
SuggestCommand 将文本插入到 Custom Chat 输入框中。
RunCommand、OpenUrl 和 CopyToClipboard 均可处理。
支持文本、物品和实体等悬停事件。
在交互行为依赖时保留现有的 Minecraft 样式数据。
本地聊天记录
以 JSONL 格式保存本地聊天记录。
同时创建可读的 .log 文件。
通过捆绑的 GardeLogStore 集成支持索引的二进制历史。
支持针对服务器、单人世界和全局后备的独立日志上下文。
使用有界加载和后台兼容写入以减少不必要的客户端线程工作。
自定义聊天记录查看器
添加用于本地日志的游戏内查看器。
支持聊天、命令、系统消息以及所有日志。
根据配置和可用性,可使用二进制或可读的日志数据。
包括搜索、上下文切换、有界加载、换行和滚动功能。
内置设置界面
Custom Chat 拥有自己的游戏内设置界面。
通过 /customchat settings 打开它。
Mod Menu 是可选的,仅在安装时作为快捷方式起作用。
不需要 YACL。
UI 主题
包含多种极简 UI 主题。
主题选择通过内置的设置界面进行处理。
支持聊天、日志、翻译、Twitch HUD 和设置 UI 的主题纹理。
视觉自定义
可调节背景不透明度。
紧凑模式。
可选的时间戳。
可选的帮助文本。
本地高亮显示开关。
Twitch HUD 布局选项。
Rank Tooltips(排名提示)
针对配置的排名符号和昵称颜色的实验性本地提示系统。
使用 config/custom-chat/rank-tooltips.json 配置文件。
不会覆盖现有的服务器悬停事件。
保持现有点击事件完整。
支持全局和特定上下文的映射。
翻译界面
通过 Shift + Right Click(Shift + 右键点击)某条消息打开。
翻译内容不会自动发送到聊天频道。
翻译后的文本可以插入到输入框中、复制或在 Google Translate 中打开。
包含 MyMemory 支持作为简单的默认提供商。
通过高级设置支持 LibreTranslate 兼容的端点。
尝试在翻译前将昵称/排名前缀与消息正文分离。
将实质上未改变的提供商输出视为未改变的结果,而不是成功的翻译。
Twitch HUD
在 Minecraft 内部添加一个独立的 Twitch 聊天 HUD 覆盖层。
Twitch 消息显示在其自己的覆盖层中,不会注入到正常的 Minecraft 聊天中。
支持模拟/测试消息,以便在不连接 Twitch 的情况下检查 HUD。
支持可配置的 HUD 位置、宽度、不透明度、时间戳、标题、可见消息数量和消息生命周期。
使用有界消息缓冲区和缓存的布局数据。
Twitch IRC 连接
通过 Twitch IRC 从 Minecraft 连接到 Twitch 频道。
在 Minecraft HUD 内查看 Twitch 聊天。
仅通过用户明确操作从 Minecraft 向 Twitch 发送消息。
包括连接、断开连接、重新连接和状态命令。
包括重新连接处理和本地传出回显抑制。
7TV 表情渲染
加载 7TV 全局表情。
加载 7TV 频道表情。
在 Minecraft Twitch HUD 内渲染 7TV 表情。
包括 7TV 状态、重新加载、清除缓存和表情查找命令。
使用有界的元数据/图像缓存和后台加载。
Custom Chat 1.0.8 目前渲染首选的静态表情图像;动画播放尚未实现。
1.0.8 中的性能和稳定性改进
有界历史和日志加载。
缓存的样式文本布局和换行。
后台兼容日志写入。
有界翻译响应和异步提供商请求。
有界 Twitch/7TV 缓存和消息缓冲区。
针对本地化、样式文本、布局、翻译、二进制日志和保护构建的其他自动化验证。
本地化
英语
俄语
西班牙语
德语
波兰语
巴西葡萄牙语
法语
简体中文
控制
打开自定义聊天:U
浏览本地传出历史:Ctrl + Up / Down
滚动本地预览:鼠标滚轮或 Page Up / Page Down
在预览中跳转:Home / End
打开翻译界面:Shift + 右键点击消息
打开自定义聊天记录:可配置按键绑定,默认未绑定
命令
设置
/customchat settings
打开内置的 Custom Chat 设置界面。
/customchat config
设置界面的别名。
/customchat options
设置界面的别名。
Twitch HUD
/customchat twitchhud on
启用 Twitch HUD 覆盖层。
/customchat twitchhud off
禁用 Twitch HUD 覆盖层。
/customchat twitchhud toggle
切换 Twitch HUD 覆盖层的启用状态。
/customchat twitchhud test
添加本地 Twitch HUD 测试消息。
不连接 Twitch 或发送任何内容。
/customchat twitchhud add <username> <message>
添加本地模拟的 Twitch HUD 消息。
/customchat twitchhud clear
清除 Twitch HUD 消息。
Twitch IRC
/customchat twitchhud connect
连接到配置的 Twitch 频道。
/customchat twitchhud connect <channel>
连接到特定的 Twitch 频道。
/customchat twitchhud disconnect
断开与 Twitch IRC 的连接。
/customchat twitchhud reconnect
重新连接 Twitch IRC。
/customchat twitchhud status
显示 Twitch HUD 和 IRC 状态。
/customchat twitchhud send <message>
如果启用了发送功能且账户已连接,则向 Twitch 聊天发送消息。
7TV
/customchat twitchhud 7tv status
显示 7TV 加载/缓存状态。
/customchat twitchhud 7tv find <name>
检查 7TV 表情是否已加载。
/customchat twitchhud 7tv reload
重新加载 7TV 表情。
/customchat twitchhud 7tv clearcache
清除 7TV 缓存。
要求
Fabric Loader
Fabric API
Fabric Language Kotlin
可选集成
Mod Menu
打开内置 Custom Chat 设置界面的可选快捷方式。
不需要 YACL。
Twitch 注意事项
Twitch 支持需要用户提供 Twitch 账户设置。
该模组不包含 Twitch OAuth 令牌、翻译 API 密钥、OpenAI 密钥、Gemini 密钥、Google 密钥或 DeepL 密钥。
仅在用户明确操作后才发送 Twitch 消息。
7TV 表情直接在 Minecraft Twitch HUD 内渲染。Custom Chat 1.0.8 目前使用静态首选表情图像;未实现动画 7TV 播放。
隐私注意事项
Custom Chat 可以存储本地聊天记录和配置数据。
日志可能包含聊天消息、命令、玩家名称、服务器/世界上下文、时间戳和交互元数据。
在支持的范围内,识别出的类似身份验证的命令参数在持久化之前会被脱敏,但这并不能保证检测到所有服务器特定的敏感命令。
如果您配置了 Twitch OAuth 或 LibreTranslate 兼容的 API 密钥,这些值属于本地配置数据。请勿上传您的配置文件、令牌、私有日志或包含凭据的截图。
为什么要下载它?
Custom Chat 对于希望拥有更现代和有条理的聊天界面,而不改变服务器上正常聊天和工作方式的玩家来说非常有用。
它提供了更简洁的布局、样式化的本地历史记录、多种日志格式、可点击的消息支持、翻译工具、Rank Tooltips、Twitch 聊天查看、7TV 渲染以及其他生活质量改进,同时仅作为客户端模组运行。
开源及开发状态
Custom Chat 1.0.8 仅采用 GNU General Public License v3.0 (GPL-3.0-only) 许可证。
完整的源代码、构建系统、受保护的构建管道、测试和开发者文档均为公开:
源代码:
开发者文档:
问题反馈:
目前的活跃开发和定期支持已无限期暂停。
1.0.8 是最新的稳定版本,也是未来一段时间内计划发布的最后一个官方版本。
这并不意味着该项目被永久放弃。开发可能会在未来恢复,问题和拉取请求仍可能被审查,但目前没有路线图、发布时间表或保证的响应时间。
即使恢复活跃开发,该仓库也将保持公开。
公平游戏 / 反作弊注意事项
Custom Chat 不会修改移动、战斗、碰撞箱、物品栏、世界交互或服务器端检查。
它不提供 X-Ray、ESP、宏、战斗自动化、移动作弊或其他游戏优势。
该模组旨在用于聊天界面改进、本地历史记录、本地日志、翻译、Twitch 聊天查看以及其他聊天相关的生活质量功能。
Custom Chat
Custom Chat is a client-side Fabric mod for Minecraft 1.21.11 that replaces the vanilla chat screen with a more flexible interface while keeping normal Minecraft chat and command behavior compatible with vanilla servers.
It adds local history, multiple log formats, clickable/hoverable styled text, translation tools, experimental Rank Tooltips, themes, and an optional Twitch IRC HUD with 7TV emote rendering.
Current stable version: 1.0.8
Active development and regular support are currently paused indefinitely while I step away from Minecraft development and focus on other projects.
This does not mean the project is permanently abandoned. The source code remains public, issues and pull requests remain available, and development may resume in the future.
Features
Custom chat overlay
Replaces the default chat screen with a styled custom interface.
Keeps normal Minecraft chat messages and commands compatible with vanilla servers.
Client-side only. No server installation required.
Vanilla-compatible message and command sending
Regular chat messages and commands still work normally.
Commands are still sent as Minecraft commands.
Chat messages are still sent as normal Minecraft chat messages.
Local session preview
Shows recent incoming, outgoing, and system messages directly in the custom chat UI.
Keeps Minecraft Text styling where needed for click and hover compatibility.
Supports styled chat lines without breaking vanilla interaction behavior.
Uses bounded preview/layout processing so the UI does not need to rebuild unlimited history every frame.
Outgoing history
Browse previously sent messages and commands.
Shortcut: Ctrl + Up / Down.
Local highlighting
Highlights commands, player mentions, and URLs in the preview.
Helps separate normal messages, commands, and useful interactive text.
Clickable chat compatibility
SuggestCommand inserts text into the Custom Chat input.
RunCommand, OpenUrl, and CopyToClipboard are handled.
Hover events such as text, item, and entity tooltips are supported.
Existing Minecraft style data is preserved where interaction behavior depends on it.
Local chat logs
Saves local chat history in JSONL format.
Also creates readable .log files.
Includes indexed binary history through the bundled GardeLogStore integration.
Supports separate log contexts for servers, singleplayer worlds, and global fallback.
Uses bounded loading and background compatibility writes to reduce unnecessary client-thread work.
Custom Chat Logs viewer
Adds an in-game viewer for local logs.
Supports chat, commands, system messages, and all logs.
Can use binary or readable log data depending on configuration and availability.
Includes search, context switching, bounded loading, wrapping, and scrolling.
Built-in settings screen
Custom Chat has its own in-game settings screen.
Open it with /customchat settings.
Mod Menu is optional and only acts as a shortcut when installed.
YACL is not required.
UI themes
Includes multiple minimal UI themes.
Theme selection is handled through the built-in settings screen.
Supports themed textures for chat, logs, translation, Twitch HUD, and settings UI.
Visual customization
Adjustable background opacity.
Compact mode.
Optional timestamps.
Optional help text.
Local highlighting toggle.
Twitch HUD layout options.
Rank Tooltips
Experimental local tooltip system for configured rank glyphs and nickname colors.
Uses config/custom-chat/rank-tooltips.json.
Does not overwrite existing server hover events.
Keeps existing click events intact.
Supports global and context-specific mappings.
Translation screen
Opens with Shift + Right Click on a message.
Translation is not sent to chat automatically.
The translated text can be inserted into the input field, copied, or opened in Google Translate.
Includes MyMemory support as a simple default provider.
Supports LibreTranslate-compatible endpoints through advanced settings.
Attempts to separate nickname/rank prefixes from the message body before translation.
Treats effectively unchanged provider output as an unchanged result instead of a successful translation.
Twitch HUD
Adds a separate Twitch chat HUD overlay inside Minecraft.
Twitch messages are shown in their own overlay, not injected into normal Minecraft chat.
Supports mock/test messages for checking the HUD without connecting to Twitch.
Supports configurable HUD position, width, opacity, timestamps, title, visible message count, and message lifetime.
Uses bounded message buffering and cached layout data.
Twitch IRC connection
Connect to a Twitch channel from Minecraft through Twitch IRC.
View Twitch chat inside the Minecraft HUD.
Send messages to Twitch from Minecraft only by explicit user action.
Includes connect, disconnect, reconnect, and status commands.
Includes reconnect handling and local outgoing echo suppression.
7TV emote rendering
Loads 7TV global emotes.
Loads 7TV channel emotes.
Renders 7TV emotes inside the Minecraft Twitch HUD.
Includes 7TV status, reload, cache clear, and emote lookup commands.
Uses bounded metadata/image caches and background loading.
Custom Chat 1.0.8 currently renders the preferred static emote image; animated playback is not implemented.
Performance and stability improvements in 1.0.8
Bounded history and log loading.
Cached styled text layouts and wrapped lines.
Background compatibility-log writing.
Bounded translation responses and asynchronous provider requests.
Bounded Twitch/7TV caches and message buffers.
Additional automated validation for localization, styled text, layout, translation, binary logs, and protected builds.
Localization
English
Russian
Spanish
German
Polish
Brazilian Portuguese
French
Simplified Chinese
Controls
Open Custom Chat: U
Browse local outgoing history: Ctrl + Up / Down
Scroll local preview: mouse wheel or Page Up / Page Down
Jump through preview: Home / End
Open translation screen: Shift + Right Click on a message
Open Custom Chat Logs: configurable keybind, unbound by default
Commands
Settings
/customchat settings
Opens the built-in Custom Chat settings screen.
/customchat config
Alias for the settings screen.
/customchat options
Alias for the settings screen.
Twitch HUD
/customchat twitchhud on
Enables the Twitch HUD overlay.
/customchat twitchhud off
Disables the Twitch HUD overlay.
/customchat twitchhud toggle
Toggles the Twitch HUD overlay.
/customchat twitchhud test
Adds local Twitch HUD test messages.
Does not connect to Twitch or send anything.
/customchat twitchhud add <username> <message>
Adds a local mock Twitch HUD message.
/customchat twitchhud clear
Clears Twitch HUD messages.
Twitch IRC
/customchat twitchhud connect
Connects to the configured Twitch channel.
/customchat twitchhud connect <channel>
Connects to a specific Twitch channel.
/customchat twitchhud disconnect
Disconnects from Twitch IRC.
/customchat twitchhud reconnect
Reconnects Twitch IRC.
/customchat twitchhud status
Shows Twitch HUD and IRC status.
/customchat twitchhud send <message>
Sends a message to Twitch chat if sending is enabled and the account is connected.
7TV
/customchat twitchhud 7tv status
Shows 7TV load/cache status.
/customchat twitchhud 7tv find <name>
Checks whether a 7TV emote is loaded.
/customchat twitchhud 7tv reload
Reloads 7TV emotes.
/customchat twitchhud 7tv clearcache
Clears the 7TV cache.
Requirements
Fabric Loader
Fabric API
Fabric Language Kotlin
Optional integrations
Mod Menu
Optional shortcut to open the built-in Custom Chat settings screen.
YACL is not required.
Twitch notes
Twitch support requires user-provided Twitch account settings.
The mod does not include Twitch OAuth tokens, translation API keys, OpenAI keys, Gemini keys, Google keys, or DeepL keys.
Twitch messages are only sent after explicit user action.
7TV emotes are rendered directly inside the Minecraft Twitch HUD. Custom Chat 1.0.8 currently uses static preferred emote images; animated 7TV playback is not implemented.
Privacy notes
Custom Chat can store local chat logs and configuration data.
Logs may contain chat messages, commands, player names, server/world context, timestamps, and interaction metadata.
Recognized authentication-style command arguments are redacted before persistence where supported, but this is not a guarantee that every server-specific sensitive command will be detected.
If you configure Twitch OAuth or a LibreTranslate-compatible API key, those values are local configuration data. Do not upload your config files, tokens, private logs, or screenshots containing credentials.
Why download it?
Custom Chat is useful for players who want a more modern and organized chat interface without changing how normal chat and commands work on servers.
It adds a cleaner layout, styled local history, multiple log formats, clickable message support, translation tools, Rank Tooltips, Twitch chat viewing, 7TV rendering, and quality-of-life improvements while remaining client-side only.
Open source and development status
Custom Chat 1.0.8 is licensed under GNU General Public License v3.0 only (GPL-3.0-only).
The complete source code, build system, protected build pipeline, tests, and developer documentation are public:
Source:
Developer documentation:
Issues:
Active development and regular support are currently paused indefinitely.
1.0.8 is the latest stable release and the final planned official release for the foreseeable future.
This does not mean the project is permanently abandoned. Development may resume later, and issues or pull requests may still be reviewed, but there is currently no roadmap, release schedule, or guaranteed response time.
The repository is intended to remain public even if active development resumes.
Fair Play / Anti-cheat note
Custom Chat does not modify movement, combat, hitboxes, inventory, world interaction, or server-side checks.
It does not provide X-Ray, ESP, macros, combat automation, movement cheats, or other gameplay advantages.
The mod is intended for chat UI improvements, local history, local logs, translation, Twitch chat viewing, and other chat-related quality-of-life features.
评论 0
登录后参与评分
还没有评论,来抢沙发吧