ChatManager-Core

模组

· 作者 Fozeton

ChatManager-Core 是一个用于处理 Minecraft 聊天的库

0 本站下载 0 关注 更新于 1 个月前

需要前置:Cloth Config API

最新 1.2.0-neoforge · 1.21.4 · NeoForge

一键开服(送7天)

?? English

About

ChatManager-Core 是一个用于彻底重构 Minecraft 聊天处理的底层库。该模组本身不提供现成的可视化界面——相反,它在网络层和客户端层面拦截所有原版聊天处理流程,并用其自身的架构取而代之:包括频道、事件、消息解析以及可扩展的 API。

技术原理

Mixins 会拦截 handlePlayerChat 和 handleSystemChat 数据包,以及本地添加的客户端消息。这些数据包的标准处理流程会被完全取消——取而代之的是,每条消息都会被封装成一个统一的 Message 模型(包含类型:玩家、系统、客户端、错误、提及、动画、自定义),并通过基于 MegaEvents 构建的事件总线进行分发。Ferra13671 开发的开源事件库 MegaEvents 提供了这一支持。键盘、鼠标和滚轮输入也会被拦截,这是为了使频道窗口能够独立于标准游戏 UI 进行移动、调整大小和滚动。

频道系统

  • 消息根据 正则表达式模式 路由到可配置的频道中——例如,你可以将交易聊天、公会聊天或系统消息分流到不同的窗口。
  • 每个频道都维护着自己的消息历史记录,并支持配置最大存储量。
  • 可以通过设置显示或隐藏各个频道。
  • 如果你正在基于此核心开发自己的模组,可以使用完全编程式的 API 来注册自定义的消息解析器 (ChatMessageParser) 和处理程序 (MessageHandler)。

消息处理与生活质量功能

  • 内置数学引擎 (={...}) — 直接在聊天输入框中评估数学表达式,支持基本运算符、三角函数、阶乘、常数以及配置文件中的自定义常量和函数。具备实时预览(有效性颜色高亮)、Brigadier 自动补全功能,以及通过 TAB 键即时将公式替换为结果的功能。配置文件中还提供弧度模式、数字格式和自定义表达式前缀选项。
  • 输入历史(撤销 / 重做) — 完整的撤销和重做堆栈(undoStack 和 redoStack),支持在聊天中使用 Ctrl+Z 和 Ctrl+Y 快捷键实现流畅的撤销/重做操作。
  • 消息分块(ChatQueueManager) — 自动绕过标准的原版 256 字符限制:长消息会被整齐地分割成多个分块,并按可配置的延迟依次发送。
  • 重复折叠 — 如果在短时间内连续收到多条相同的消息,它们不会逐行重复显示;而是被折叠成单行并附带重复计数,例如 (x5)。
  • 提及检测 — 如果消息中包含你的昵称,它会被标记为特定的消息类型,并伴随声音通知。
  • 聊天别名 — 配置一个文本替换列表,在发送消息时会自动进行替换(例如常用短语的快捷方式)。别名也可以应用于命令,而不仅仅是普通消息。
  • 宏 — 一套独立的命名文本片段系统,带有启用/禁用开关和计时器,旨在自动化重复性的聊天操作。
  • 密码隐藏 — /login (/l)、/register (/reg) 和 /changepassword (/changepass) 的参数会在输入框中被掩码处理。

?️ 语音输入(语音转文字)

由 Vosk 支持的离线语音识别:麦克风音频在你的计算机上本地处理,永远不会发送到云端。

  • 支持 30 多种语言和许多模型,从紧凑型(约 30–50 MB)到大模型(高达数 GB)。默认使用小型俄语模型。
  • 模型按需下载并存储在模组的配置文件夹中。已加载的模型会缓存在内存中,并且可以随时释放。
  • 麦克风指示器显示加载状态、监听状态、错误以及实时输入音量。指示器的颜色可在 voice 配置中进行自定义。
  • 面向开发者的事件:模型缺失、模型下载(成功/失败)、麦克风不支持、部分识别结果和最终识别结果。

?️ 聊天 GIF

消息中的动态 GIF:搜索、热门、下载、转换为自定义 .mcanim 格式以及缓存。使用 :slug: 语法或数字 ID;此类消息会被赋予专门的 ANIMATED 类型。

GIF 搜索由 Klipy 提供支持。为了避免在模组内暴露 API 密钥,请求不会直接发送到 Klipy,而是通过 Cloudflare Workers 代理(https://core.chatmanager.workers.dev/gifs/)转发给 Klipy。请求包含搜索短语和客户标识符(customer_id),后者是由玩家昵称和 UUID 生成的 SHA-256 哈希值。

.mcanim 的转换由原生库完成,目前仅适用于 Windows x64。

游戏事件

  • PlayerDeathEvent — 玩家死亡事件,包含坐标(X/Y/Z);非常适合用于显示死亡坐标的消息。
  • SendPosEvent — 发送聊天消息时玩家的当前位置。

AI 文本样式

内置集成 Groq API(一种用于 LLM 推理的外部云服务)。用户可以定义多个命名的“风格”,每种风格拥有自己的模型、系统提示词和响应长度限制,并可用于在发送前自动重写文本。此功能需要用户自行从 Groq 网站获取 API 密钥,并将其输入到配置文件中。

Webhooks — 将消息转发到外部服务

该模组可以通过 POST 请求将聊天消息发送至外部 HTTP 地址——例如,可用于通过 Webhook 将游戏内聊天转发到 Discord 频道。配置分为两个层级:

  • 全局 Webhook —— 所有消息使用的单一默认地址。
  • 按频道 Webhook —— 针对特定频道覆盖全局设置;若启用,则优先使用此设置而非全局 Webhook。
  • 每个 Webhook 可独立选择有效载荷格式:纯文本或序列化 Minecraft 文本组件(包含颜色和样式,以 JSON 格式)。
  • 任何频道均可被完全排除在转发之外,不受全局设置影响。

此功能默认禁用,需要用户在配置文件中手动指定目标地址——否则不会向任何地方发送消息。

配置与数据存储

设置由 Cloth Config 驱动,并存储在 config/ChatManager-Core/ 目录中的人类可读文件(Jankson / JSON5)中,首次启动时会自动生成带有默认值的配置文件。自定义文件记录器会写入专用日志文件,用于诊断模组行为。

面向其他模组开发者

核心模块完全基于开放的 MegaEvents 事件总线构建(作者为 Ferra13671):接收消息、消息添加到频道、消息堆叠、玩家被提及、频道可见性更改、键盘/鼠标输入、客户端刻、玩家死亡、语音输入事件——这些事件中的任何一个都可以从你自己的模组中进行订阅,从而在核心之上构建自定义视觉层,而无需从头重新实现聊天拦截逻辑。

依赖特定 Minecraft 版本的代码隐藏在 utils.compat 抽象层之后。提供程序(ComponentSerializerProvider、ClickEventProvider、HoverEventProvider、ScreenProvider、GameProfileProvider、PacketCompatProvider、GraphicsProvider)为你提供静态入口点,使编写代码更加便捷:只需编写一次,无需关心特定内容在 1.21.4 与 26.2 版本中的具体表现形式。共享的键盘、鼠标及新增消息处理程序位于 utils.compat.handlers 中。

⚠️ 安装前的重要提示

  • 这是一个没有内置可视化界面的核心库。单独使用时,该模组会取消原版聊天处理,但不会绘制替代界面——如果没有实现渲染的附加模组支持,聊天虽然仍在内部处理,但不会在屏幕上显示。
  • Webhook 和 AI 样式功能可以将消息文本发送到外部服务器/服务(分别为指定的 HTTP 地址和 Groq API)。这两个功能均默认禁用,需要显式的手动配置(地址、API 密钥)才能激活——否则不会发送任何数据。
  • GIF 功能会与外部服务通信:请求发送至 core.chatmanager.workers.dev 代理,然后转发至 Klipy(搜索短语以及根据玩家名称和 UUID 生成的标识符)。
  • 语音输入会在首次使用时下载 Vosk 库(来自 Maven Central)和所选的语言模型。语音识别本身在本地运行。
  • 每个 jar 包仅对应单个 Minecraft 版本和单个加载器——请选择适合你版本的文件。

兼容性

参数 值
Minecraft 1.21.4 (Java 21+)、26.2 (Java 25+)
加载器 Fabric, NeoForge
依赖项 Cloth Config
构建格式 1 个 jar = 1 个 Minecraft 版本 + 1 个加载器

? 灵感来源

部分功能的灵感来自以下模组——感谢它们的作者:


?? Русский

О проекте

ChatManager-Core — это библиотека-ядро для полной переработки чата в Minecraft. Мод не добавляет готовый визуальный интерфейс сам по себе, а перехватывает всю обработку ванильного чата на уровне сети и клиента и заменяет её собственной архитектурой: каналами, событиями, парсингом сообщений и расширяемым API.

Как это работает технически

Через миксины перехватываются пакеты handlePlayerChat и handleSystemChat, а также добавление локальных клиентских сообщений. Стандартная обработка этих пакетов полностью отменяется — вместо неё каждое сообщение оборачивается в единую модель Message (с типами: игрок, система, клиент, ошибка, упоминание, анимированное, кастомное) и рассылается через событийную шину на базе MegaEvents — открытой библиотеки событий за авторством Ferra13671. Также перехватываются события клавиатуры, мыши и скролла — это нужно, чтобы окна каналов можно было двигать, изменять размер и прокручивать независимо от стандартного игрового интерфейса.

Система каналов

  • Сообщения распределяются по настраиваемым каналам на основе regex-паттернов — например, можно вынести торговый чат, клановый чат или системные сообщения в отдельные окна.
  • У каждого канала своя история сообщений с ограничением по количеству хранимых записей.
  • Каналы можно скрывать/показывать, менять их видимость через настройки.
  • Полностью программный API для регистрации собственных парсеров сообщений (ChatMessageParser) и обработчиков (MessageHandler), если вы разрабатываете свой мод поверх этого ядра.

Обработка и удобства чата

  • 内置数学引擎 (={...}) — 在输入行中直接计算数学表达式,支持基本运算符、三角函数、阶乘、常量,以及来自配置文件的自定义常量和函数。附带实时预览(通过绿色/红色高亮显示有效性)、智能自动补全(基于 Brigadier),并支持按 TAB 键将公式即时替换为结果。配置文件中提供弧度模式、数字格式和自定义表达式前缀选项。
  • 输入历史(撤销 / 重做) — 完整的撤销和重做堆栈(undoStack 和 redoStack),以便在聊天中使用 Ctrl+Z 和 Ctrl+Y 快捷键进行便捷操作。
  • 消息分块发送(ChatQueueManager) — 自动绕过原版默认的 256 字符限制:长消息会被拆分为多个部分,并按可配置的延迟依次发送到队列中。
  • 重复消息折叠 — 如果在短时间内连续收到相同的消息,它不会逐行重复显示,而是折叠为包含重复次数计数器的单行文本,格式如 (x5)。
  • 提及检测 — 如果消息中包含您的昵称,该消息会被标记为特殊类型,并伴随声音提示。
  • 聊天别名 — 可以配置一个文本替换列表,在发送消息时自动插入(例如缩短常用短语)。可选地,别名也可应用于命令,而不仅仅是普通消息。
  • 宏 — 一套独立的命名文本预设系统,支持启用/禁用及计时器功能,用于自动化聊天中的重复操作。
  • 密码隐藏 — /login (/l)、/register (/reg) 和 /changepassword (/changepass) 命令的参数会在输入行中被直接掩码处理。

?️ 语音输入(语音转文本)

基于 Vosk 的离线语音识别:麦克风音频在本地计算机上进行处理,无需上传至云端。

  • 支持 30 多种语言和多种模型——从紧凑的小型模型(约 30–50 MB)到大型模型(达数 GB)。默认使用小型俄语模型。
  • 模型按需下载并存储在模组配置文件夹中。已加载的模型会缓存于内存中,用户可随时释放其占用。
  • 麦克风指示器实时显示负载、监听状态、错误及音量水平。指示器颜色可在 voice 配置文件中自定义。
  • 为开发者提供了相关事件:模型缺失、模型加载(成功/失败)、麦克风不支持、中间识别结果及最终识别结果。

?️ 聊天中的 GIF

聊天中直接展示动画 GIF:搜索、趋势、加载、转换为专有 .mcanim 格式以及缓存。可通过 :slug: 或数字 ID 插入,此类消息会被赋予特殊的 ANIMATED 类型。

GIF 搜索通过 Klipy 实现。为避免在模组内暴露 API 密钥,请求并非直接发出,而是通过 Cloudflare Workers 上的代理服务器(https://core.chatmanager.workers.dev/gifs/)转发至 Klipy。请求中传递搜索词和客户标识符(customer_id),后者由玩家昵称和 UUID 的 SHA-256 哈希值生成。

.mcanim 格式的转换通过原生库执行,目前仅支持 Windows x64 平台。

游戏事件

  • PlayerDeathEvent — 玩家死亡事件,包含坐标信息(X/Y/Z),可用于构建包含死亡坐标的消息等。
  • SendPosEvent — 玩家在向聊天发送消息时的位置信息。

AI 文本美化

内置与 Groq API(外部云服务推理平台)的集成。用户可以创建多个命名的“风格”——每个风格可指定不同的模型、系统提示词和回复长度限制——并在发送前自动处理或改写文本。此功能需要用户自行从 Groq 网站获取 API 密钥,并将其填入配置文件。

Webhooks — 消息转发至外部服务

模组可将聊天消息通过 POST 方法发送至外部 HTTP 地址——例如,可用于将游戏聊天通过 webhook 转发至 Discord 频道。配置分为两级:

  • 全局 Webhook — 作为所有消息的默认接收地址。
  • 频道局部 Webhook — 针对特定频道覆盖全局设置;若启用,则优先使用局部设置而非全局设置。
  • 可为每个 webhook 单独选择数据传递格式:纯文本无格式内容,或序列化的 Minecraft 组件(以 JSON 形式保留颜色和样式)。
  • 任何频道均可完全排除在转发之外,不受全局设置影响。

该功能默认关闭,要求用户手动在配置文件中指定目标地址——否则不会有任何消息被发送。

配置与数据存储

设置基于 Cloth Config 实现,并以人类可读的文件格式(Jankson / JSON5)存储在 config/ChatManager-Core/ 文件夹中。首次运行时会自动生成带有默认值的配置文件。模组自带文件日志记录器,会生成独立的日志文件用于诊断模组运行情况。

供其他模组开发者使用

核心模块完全建立在开放的 MegaEvents 事件总线之上(作者:Ferra13671):包括消息接收、添加到频道、重复堆叠、玩家提及、频道可见性变更、键盘/鼠标输入、客户端 tick、玩家死亡、语音输入事件等。您可以从自己的模组订阅这些事件中的任意一个,并在此基础上构建自定义的视觉层,而无需从零开始重写聊天拦截逻辑。

Minecraft 的版本相关代码隐藏在 utils.compat 抽象层之后。提供程序(ComponentSerializerProvider、ClickEventProvider、HoverEventProvider、ScreenProvider、GameProfileProvider、PacketCompatProvider、GraphicsProvider)提供了静态访问点,略微简化了代码:只需编写一次,无需考虑在 1.21.4 和 26.2 中各种事物的具体表现。通用的键盘、鼠标和消息处理逻辑位于 utils.compat.handlers 中。

⚠️ 安装前须知

  • 这是一个无独立视觉界面的核心库。该模组本身会接管标准聊天处理,但不会绘制替代界面——如果仅单独安装它而没有实现显示功能的配套模组,聊天将不会在屏幕上以视觉形式呈现,尽管技术上仍会继续处理。
  • Webhook(网络钩子) 和 AI 风格化 功能可能会将消息文本发送到外部服务器/服务(分别为自定义 HTTP 地址和 Groq API)。这两项功能默认处于关闭状态,需要手动显式配置(地址、API 密钥)才能启用——否则不会向任何地方发送数据。
  • GIF 请求会联系外部服务:请求发送至代理 core.chatmanager.workers.dev,然后进入 Klipy(搜索词以及来自玩家昵称和 UUID 的标识符)。
  • 语音输入 在首次使用时会下载 Vosk 库(来自 Maven Central)及所选语言模型。语音识别过程在本地进行。
  • 每个 jar 文件仅适用于一个 Minecraft 版本和一个加载器——请根据你的版本选择合适的文件。

兼容性

参数 值
Minecraft 1.21.4 (Java 21+),26.2 (Java 25+)
加载器 Fabric, NeoForge
依赖项 Cloth Config
构建格式 1 个 jar = 1 个 Minecraft 版本 + 1 个加载器

? 灵感来源

部分功能的创意源自以下模组——感谢它们的作者:

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源