?? 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 个加载器 |
? 灵感来源
部分功能的创意源自以下模组——感谢它们的作者:
?? English
About
ChatManager-Core is a core library for a complete overhaul of Minecraft's chat handling. The mod does not add a ready-made visual interface on its own — instead, it intercepts all vanilla chat processing at the network and client level and replaces it with its own architecture: channels, events, message parsing, and an extensible API.
How it works technically
Mixins intercept the handlePlayerChat and handleSystemChat packets, as well as locally added client-side messages. Standard processing of these packets is fully cancelled — instead, every message is wrapped into a unified Message model (with types: player, system, client, error, mentioned, animated, custom) and dispatched through an event bus built on MegaEvents, an open-source event library by Ferra13671. Keyboard, mouse, and scroll input are also intercepted, which is required so that channel windows can be moved, resized, and scrolled independently of the standard game UI.
Channel system
- Messages are routed into configurable channels based on regex patterns — for example, you can split trade chat, clan chat, or system messages into separate windows.
- Each channel keeps its own message history with a configurable size limit.
- Channels can be shown or hidden through settings.
- A fully programmatic API is available for registering custom message parsers (
ChatMessageParser) and handlers (MessageHandler) if you're building your own mod on top of this core.
Message processing and quality-of-life features
- Built-in math engine (
={...}) — evaluate mathematical expressions directly in the chat input box with support for basic operators, trigonometry, factorials, constants, and custom constants and functions from the config. Features real-time preview (validity color highlighting), Brigadier autocomplete, and instant formula-to-result replacement via the TAB key. The config offers a radians mode, number format, and a custom expression prefix.
- Input history (Undo / Redo) — full undo and redo stacks (
undoStack and redoStack) enabling smooth Ctrl+Z and Ctrl+Y hotkey functionality in chat.
- Message chunking (
ChatQueueManager) — automatic bypass of the standard vanilla 256-character limit: long messages are neatly split into chunks and sent sequentially with a configurable delay.
- Repeat collapsing — if an identical message arrives multiple times in a row within a short window, it isn't duplicated line by line; instead it's collapsed into a single line with a repeat counter, e.g.
(x5).
- Mention detection — if your nickname appears in a message, it's flagged with a dedicated message type and accompanied by a sound notification.
- Chat aliases — configure a list of text replacements that are automatically substituted when sending a message (e.g. shortcuts for frequently used phrases). Aliases can optionally be applied to commands as well, not just regular messages.
- Macros — a separate system of named text snippets with an enable/disable toggle and a timer, intended for automating repetitive chat actions.
- Password hiding — arguments of
/login (/l), /register (/reg) and /changepassword (/changepass) are masked right in the input box.
?️ Voice input (Speech-to-Text)
Offline speech recognition powered by Vosk: microphone audio is processed locally on your computer and is never sent to the cloud.
- 30+ languages and many models are supported, from compact (~30–50 MB) to large (up to several GB). A small Russian model is used by default.
- Models are downloaded on demand and stored in the mod's config folder. A loaded model is cached in memory and can be released at any time.
- A mic indicator shows loading, listening, errors and real-time input volume. Indicator colors are configurable in the
voice config.
- Events for developers: model missing, model download (success/failure), microphone not supported, partial and final recognition results.
?️ Chat GIFs
Animated GIFs right in messages: search, trending, download, conversion to a custom .mcanim format, and caching. Use the :slug: syntax or a numeric ID; such messages get the dedicated ANIMATED type.
GIF search is powered by Klipy. To avoid exposing the API key inside the mod, requests don't go directly to Klipy — they go through a Cloudflare Workers proxy (https://core.chatmanager.workers.dev/gifs/), which forwards them to Klipy. A request contains the search phrase and a client identifier (customer_id), which is a SHA-256 hash generated from the player's nickname and UUID.
Conversion to .mcanim is done by a native library, which is currently available for Windows x64 only.
Game events
PlayerDeathEvent — player death with coordinates (X/Y/Z); handy for, say, a message with your death coordinates.
SendPosEvent — the player's position at the moment a chat message is sent.
AI text styling
Built-in integration with the Groq API (an external cloud service for LLM inference). Users can define several named "styles," each with its own model, system prompt, and response length limit, and use them to automatically rephrase text before sending it. This feature requires the user's own API key, obtained independently from Groq's website and entered into the config.
Webhooks — forwarding messages to external services
The mod can send chat messages to an external HTTP address via a POST request — useful, for example, for forwarding in-game chat to a Discord channel through a webhook. Configuration is two-tiered:
- Global webhook — a single default address for all messages.
- Per-channel webhook — overrides the global one for a specific channel; if enabled, it's used instead of the global webhook.
- Each webhook can independently choose the payload format: plain unformatted text, or a serialized Minecraft text component (with colors and styling, as JSON).
- Any channel can be fully excluded from forwarding, regardless of global settings.
This feature is disabled by default and requires the user to manually specify a destination address in the config file — without that, no message is ever sent anywhere.
Configuration and data storage
Settings are powered by Cloth Config and stored in human-readable files (Jankson / JSON5) in config/ChatManager-Core/, automatically generated with default values on first launch. A custom file logger writes a dedicated log file for diagnosing mod behavior.
For other mod developers
The core is built entirely around the open MegaEvents event bus (by Ferra13671): message received, message added to a channel, message stacked, player mentioned, channel visibility changed, keyboard/mouse input, client ticks, player death, voice input events — any of these events can be subscribed to from your own mod to build a custom visual layer on top of the core, without having to reimplement chat interception logic from scratch.
Version-dependent Minecraft code is hidden behind the utils.compat abstraction layer. Providers (ComponentSerializerProvider, ClickEventProvider, HoverEventProvider, ScreenProvider, GameProfileProvider, PacketCompatProvider, GraphicsProvider) give you static entry points that make writing code a little bit more convenient: write it once without caring how a given thing looks in 1.21.4 vs 26.2. Shared keyboard, mouse and added-message handlers live in utils.compat.handlers.
⚠️ Important before installing
- This is a core library with no built-in visual interface. On its own, the mod cancels vanilla chat processing but does not draw an alternative interface — without an add-on mod that implements rendering, chat will not visually appear on screen, even though it's still being processed internally.
- The webhook and AI styling features can send message text to external servers/services (a user-specified HTTP address and/or the Groq API, respectively). Both features are disabled by default and require explicit manual configuration (address, API key) to activate — without that, no data is sent anywhere.
- GIFs talk to an external service: requests go to the
core.chatmanager.workers.dev proxy and then on to Klipy (the search phrase and an identifier built from the player's name and UUID).
- Voice input downloads the Vosk library (Maven Central) and the selected language model on first use. Speech recognition itself runs locally.
- Each jar fits a single Minecraft version and a single loader — pick the file for your version.
Compatibility
| Parameter |
Value |
| Minecraft |
1.21.4 (Java 21+), 26.2 (Java 25+) |
| Loaders |
Fabric, NeoForge |
| Dependencies |
Cloth Config |
| Build format |
1 jar = 1 Minecraft version + 1 loader |
? Inspiration
Ideas for some of the features came from these mods — thanks to their authors:
?? Русский
О проекте
ChatManager-Core — это библиотека-ядро для полной переработки чата в Minecraft. Мод не добавляет готовый визуальный интерфейс сам по себе, а перехватывает всю обработку ванильного чата на уровне сети и клиента и заменяет её собственной архитектурой: каналами, событиями, парсингом сообщений и расширяемым API.
Как это работает технически
Через миксины перехватываются пакеты handlePlayerChat и handleSystemChat, а также добавление локальных клиентских сообщений. Стандартная обработка этих пакетов полностью отменяется — вместо неё каждое сообщение оборачивается в единую модель Message (с типами: игрок, система, клиент, ошибка, упоминание, анимированное, кастомное) и рассылается через событийную шину на базе MegaEvents — открытой библиотеки событий за авторством Ferra13671. Также перехватываются события клавиатуры, мыши и скролла — это нужно, чтобы окна каналов можно было двигать, изменять размер и прокручивать независимо от стандартного игрового интерфейса.
Система каналов
- Сообщения распределяются по настраиваемым каналам на основе regex-паттернов — например, можно вынести торговый чат, клановый чат или системные сообщения в отдельные окна.
- У каждого канала своя история сообщений с ограничением по количеству хранимых записей.
- Каналы можно скрывать/показывать, менять их видимость через настройки.
- Полностью программный API для регистрации собственных парсеров сообщений (
ChatMessageParser) и обработчиков (MessageHandler), если вы разрабатываете свой мод поверх этого ядра.
Обработка и удобства чата
- Встроенный математический движок (
={...}) — вычисление математических выражений прямо в строке ввода с поддержкой базовых операторов, тригонометрии, факториалов, констант, а также кастомных констант и функций из конфига. Сопровождается реал-тайм превью (зелёная/красная подсветка валидности), умным автокомплитом (Brigadier) и возможностью мгновенной замены формулы на результат по клавише TAB. В конфиге доступны режим радиан, формат чисел и свой префикс выражений.
- История ввода (Undo / Redo) — полноценные стеки отмены и повтора (
undoStack и redoStack) для удобной работы горячих клавиш Ctrl+Z и Ctrl+Y прямо в чате.
- Чанкование сообщений (
ChatQueueManager) — автоматический обход стандартного ванильного лимита в 256 символов: длинные сообщения аккуратно разбиваются на части и отправляются в очередь с настраиваемой задержкой.
- Сворачивание повторов — если одинаковое сообщение приходит несколько раз подряд в течение короткого промежутка времени, оно не дублируется построчно, а сворачивается в один текст со счётчиком повторов вида
(x5).
- Обнаружение упоминаний — если в сообщении встречается ваш никнейм, оно помечается отдельным типом и сопровождается звуковым сигналом.
- Алиасы чата — можно настроить список текстовых замен, которые автоматически подставляются при отправке сообщения (например, сокращение часто используемых фраз). Опционально алиасы можно применять и к командам, а не только к обычным сообщениям.
- Макросы — отдельная система именованных текстовых заготовок с возможностью включения/выключения и таймером, для автоматизации повторяющихся действий в чате.
- Скрытие паролей — аргументы команд
/login (/l), /register (/reg) и /changepassword (/changepass) маскируются прямо в строке ввода.
?️ Голосовой ввод (Speech-to-Text)
Офлайн-распознавание речи на базе Vosk: звук с микрофона обрабатывается локально, на вашем компьютере, без отправки в облако.
- Поддерживается 30+ языков и множество моделей — от компактных (~30–50 МБ) до больших (до нескольких ГБ). По умолчанию используется небольшая русская модель.
- Модели скачиваются по требованию и хранятся в папке конфигов мода. Загруженная модель кэшируется в памяти, а освободить её можно в любой момент.
- Индикатор микрофона показывает загрузку, прослушивание, ошибки и уровень громкости в реальном времени. Цвета индикатора настраиваются в конфиге
voice.
- Для разработчиков доступны события: модель отсутствует, загрузка модели (успех/ошибка), микрофон не поддерживается, промежуточный и итоговый результат распознавания.
?️ GIF в чате
Анимированные GIF прямо в сообщениях: поиск, тренды, загрузка, конвертация в собственный формат .mcanim и кэширование. Вставляются в формате :slug: или по числовому ID, а такие сообщения получают отдельный тип ANIMATED.
Поиск GIF работает через Klipy. Чтобы не раскрывать API-ключ в самом моде, запросы идут не напрямую, а через прокси на Cloudflare Workers (https://core.chatmanager.workers.dev/gifs/), который переадресует их в Klipy. В запросе передаются поисковая фраза и идентификатор клиента (customer_id), представляющий собой хэш SHA-256 из ника и UUID игрока.
Конвертация в .mcanim выполняется нативной библиотекой, и сейчас она доступна только под Windows x64.
Игровые события
PlayerDeathEvent — смерть игрока с координатами (X/Y/Z), на нём можно построить, например, сообщение с координатами смерти.
SendPosEvent — позиция игрока в момент отправки сообщения в чат.
AI-стилизация текста
Встроена интеграция с Groq API (внешний облачный сервис для инференса языковых моделей). Пользователь может создать несколько именованных "стилей" — каждый со своей моделью, системным промптом и ограничением на длину ответа — и использовать их для автоматической обработки/переформулирования текста перед отправкой. Для работы этой функции нужен собственный API-ключ, который пользователь получает самостоятельно на сайте Groq и вписывает в конфиг.
Вебхуки — пересылка сообщений на внешние сервисы
Мод умеет отправлять сообщения чата на внешний HTTP-адрес методом POST — это можно использовать, например, для пересылки игрового чата в Discord-канал через вебхук. Настройка двухуровневая:
- Глобальный вебхук — единый адрес для всех сообщений по умолчанию.
- Локальный вебхук канала — переопределяет глобальный для конкретного канала; если он включён, используется вместо глобального.
- Для каждого вебхука отдельно можно выбрать формат передаваемых данных: обычный текст без форматирования или сериализованный Minecraft-компонент (с цветами и стилями в виде JSON).
- Любой канал можно полностью исключить из пересылки, независимо от глобальных настроек.
Функция выключена по умолчанию и требует, чтобы пользователь сам вручную указал адрес назначения в конфигурационном файле — без этого ни одно сообщение никуда не отправляется.
Конфигурация и хранение данных
Настройки работают на базе Cloth Config и хранятся в человекочитаемых файлах (Jankson / JSON5) в папке config/ChatManager-Core/. Они генерируются автоматически со значениями по умолчанию при первом запуске. Есть собственный файловый логгер, пишущий отдельный лог-файл для диагностики работы мода.
Для разработчиков других модов
Ядро полностью построено вокруг открытой событийной шины MegaEvents (автор — Ferra13671): получение сообщения, добавление в канал, стак повторов, упоминание игрока, изменение видимости канала, ввод с клавиатуры/мыши, тики клиента, смерть игрока, события голосового ввода — на любое из этих событий можно подписаться из своего мода и построить поверх ядра собственный визуальный слой, не переписывая логику перехвата чата с нуля.
Версионно-зависимый код Minecraft скрыт за слоем абстракций utils.compat. Провайдеры (ComponentSerializerProvider, ClickEventProvider, HoverEventProvider, ScreenProvider, GameProfileProvider, PacketCompatProvider, GraphicsProvider) дают статические точки доступа, которые немного упрощают код: его можно писать один раз, не задумываясь, как та или иная вещь выглядит в 1.21.4 и в 26.2. Общие обработчики клавиатуры, мыши и добавления сообщений лежат в utils.compat.handlers.
⚠️ Важно перед установкой
- Это библиотека-ядро без собственного визуального интерфейса. Сам по себе мод отменяет стандартную обработку чата, но не рисует альтернативный интерфейс — если поставить только его без мода-надстройки, реализующего отображение, чат визуально не будет отображаться на экране, хотя технически продолжит обрабатываться.
- Функции вебхуков и 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
登录后参与评分
还没有评论,来抢沙发吧