Custom Chat

Custom Chat

Custom Chat — клиентский мод на Fabric для Minecraft 1.21.11, который заменяет ванильный экран чата на более гибкий интерфейс, сохраняя совместимость обычного чата и команд Minecraft с ванильными серверами.

Добавляет локальную историю, несколько форматов логов, кликабельный текст со всплывающими подсказками, инструменты перевода, экспериментальные Rank Tooltips, темы и опциональный Twitch IRC HUD с отрисовкой эмоутов 7TV.

Текущая стабильная версия: 1.0.8

Активная разработка и регулярная поддержка сейчас приостановлены на неопределённый срок, пока я отхожу от разработки для Minecraft и сосредотачиваюсь на других проектах. Это не значит, что проект заброшен навсегда. Исходный код остаётся публичным, issues и pull requests остаются доступными, и разработка может возобновиться в будущем.

Возможности

Кастомный оверлей чата

Заменяет стандартный экран чата на стилизованный кастомный интерфейс.

Сохраняет совместимость обычных сообщений чата и команд Minecraft с ванильными серверами.

Только клиентская часть. Установка на сервер не требуется.

Отправка сообщений и команд, совместимая с ванилью

Обычные сообщения чата и команды работают как прежде.

Команды по-прежнему отправляются как команды Minecraft.

Сообщения чата по-прежнему отправляются как обычные сообщения чата Minecraft.

Локальный предпросмотр сессии

Показывает недавние входящие, исходящие и системные сообщения прямо в кастомном интерфейсе чата.

Сохраняет стилизацию Text Minecraft там, где это нужно для совместимости кликов и наведения.

Поддерживает стилизованные строки чата, не ломая ванильное поведение взаимодействия.

Использует ограниченную обработку предпросмотра/разметки, чтобы интерфейсу не приходилось перестраивать неограниченную историю каждый кадр.

История исходящих

Просмотр ранее отправленных сообщений и команд.

Горячая клавиша: Ctrl + Up / Down.

Локальная подсветка

Подсвечивает команды, упоминания игроков и URL в предпросмотре.

Помогает отделять обычные сообщения, команды и полезный интерактивный текст.

Совместимость с кликабельным чатом

SuggestCommand вставляет текст в поле ввода Custom Chat.

Обрабатываются RunCommand, OpenUrl и CopyToClipboard.

Поддерживаются события наведения, такие как подсказки текста, предметов и сущностей.

Существующие данные стиля Minecraft сохраняются там, где от них зависит поведение взаимодействия.

Локальные логи чата

Сохраняет локальную историю чата в формате JSONL.

Также создаёт читаемые .log файлы.

Включает индексированную бинарную историю через встроенную интеграцию GardeLogStore.

Поддерживает отдельные контексты логов для серверов, одиночных миров и глобального запасного варианта.

Использует ограниченную загрузку и фоновые записи совместимости, чтобы снизить лишнюю нагрузку на клиентский поток.

Просмотрщик Custom Chat Logs

Добавляет внутриигровой просмотрщик локальных логов.

Поддерживает чат, команды, системные сообщения и все логи.

Может использовать бинарные или читаемые данные логов в зависимости от конфигурации и доступности.

Включает поиск, переключение контекста, ограниченную загрузку, перенос строк и прокрутку.

Встроенный экран настроек

У Custom Chat есть собственный внутриигровой экран настроек.

Открыть его можно через /customchat settings.

Mod Menu опционален и служит лишь ярлыком, если установлен.

YACL не требуется.

Темы интерфейса

Включает несколько минималистичных тем интерфейса.

Выбор темы осуществляется через встроенный экран настроек.

Поддерживает тематические текстуры для чата, логов, перевода, Twitch HUD и интерфейса настроек.

Визуальная настройка

Регулируемая прозрачность фона.

Компактный режим.

Опциональные метки времени.

Опциональный текст помощи.

Переключатель локальной подсветки.

Опции разметки Twitch HUD.

Rank Tooltips

Экспериментальная локальная система подсказок для настроенных глифов рангов и цветов ников.

Использует config/custom-chat/rank-tooltips.json.

Не перезаписывает существующие серверные события наведения.

Сохраняет существующие события кликов нетронутыми.

Поддерживает глобальные и контекстно-зависимые привязки.

Экран перевода

Открывается по Shift + ПКМ на сообщении.

Перевод не отправляется в чат автоматически.

Переведённый текст можно вставить в поле ввода, скопировать или открыть в Google Translate.

Включает поддержку MyMemory как простого провайдера по умолчанию.

Поддерживает совместимые с LibreTranslate эндпоинты через расширенные настройки.

Пытается отделить префиксы никнейма/ранга от тела сообщения перед переводом.

Считает фактически неизменённый вывод провайдера неизменённым результатом, а не успешным переводом.

Twitch HUD

Добавляет отдельный оверлей Twitch-чата внутри Minecraft.

Сообщения Twitch отображаются в собственном оверлее, а не встраиваются в обычный чат Minecraft.

Поддерживает тестовые/фиктивные сообщения для проверки HUD без подключения к Twitch.

Поддерживает настраиваемые позицию HUD, ширину, прозрачность, метки времени, заголовок, количество видимых сообщений и время жизни сообщения.

Использует ограниченную буферизацию сообщений и кэшированные данные разметки.

Подключение к Twitch IRC

Подключение к каналу Twitch из Minecraft через Twitch IRC.

Просмотр Twitch-чата внутри HUD Minecraft.

Отправка сообщений в Twitch из Minecraft только по явному действию пользователя.

Включает команды подключения, отключения, переподключения и статуса.

Включает обработку переподключения и локальное подавление эха исходящих сообщений.

Отрисовка эмоутов 7TV

Загружает глобальные эмоуты 7TV.

Загружает эмоуты канала 7TV.

Отрисовывает эмоуты 7TV внутри Twitch HUD Minecraft.

Включает команды статуса 7TV, перезагрузки, очистки кэша и поиска эмоутов.

Использует ограниченные кэши метаданных/изображений и фоновую загрузку.

Custom Chat 1.0.8 в настоящее время отрисовывает предпочтительное статичное изображение эмоута; анимированное воспроизведение не реализовано.

Улучшения производительности и стабильности в 1.0.8

Ограниченная загрузка истории и логов.

Кэшированные разметки стилизованного текста и перенесённые строки.

Фоновая запись логов совместимости.

Ограниченные ответы перевода и асинхронные запросы к провайдерам.

Ограниченные кэши Twitch/7TV и буферы сообщений.

Дополнительная автоматическая валидация для локализации, стилизованного текста, разметки, перевода, бинарных логов и защищённых сборок.

Локализация

Английский

Русский

Испанский

Немецкий

Польский

Бразильский португальский

Французский

Упрощённый китайский

Управление

Открыть Custom Chat: U

Просмотр локальной истории исходящих: Ctrl + Up / Down

Прокрутка локального предпросмотра: колесо мыши или Page Up / Page Down

Переход по предпросмотру: Home / End

Открыть экран перевода: Shift + ПКМ на сообщении

Открыть Custom Chat Logs: настраиваемая клавиша, по умолчанию не назначена

Команды

Настройки

/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

Добавляет локальное фиктивное сообщение Twitch HUD.

/customchat twitchhud clear

Очищает сообщения Twitch HUD.

Twitch IRC

/customchat twitchhud connect

Подключается к настроенному каналу Twitch.

/customchat twitchhud connect

Подключается к указанному каналу Twitch.

/customchat twitchhud disconnect

Отключается от Twitch IRC.

/customchat twitchhud reconnect

Переподключается к Twitch IRC.

/customchat twitchhud status

Показывает статус Twitch HUD и IRC.

/customchat twitchhud send

Отправляет сообщение в Twitch-чат, если отправка включена и аккаунт подключён.

7TV

/customchat twitchhud 7tv status

Показывает статус загрузки/кэша 7TV.

/customchat twitchhud 7tv find

Проверяет, загружен ли эмоут 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 отображаются прямо внутри Twitch HUD в Minecraft. Custom Chat 1.0.8 сейчас использует статичные предпочитаемые изображения эмоутов; анимированное воспроизведение 7TV не реализовано.

Примечания по приватности

Custom Chat может хранить локальные логи чата и данные конфигурации.

Логи могут содержать сообщения чата, команды, имена игроков, контекст сервера/мира, временные метки и метаданные взаимодействий.

Распознанные аргументы команд, похожие на аутентификационные, скрываются перед сохранением, где это поддерживается, но это не гарантирует, что каждая чувствительная команда конкретного сервера будет обнаружена.

Если вы настроите Twitch OAuth или API-ключ, совместимый с LibreTranslate, эти значения являются локальными данными конфигурации. Не загружайте свои файлы конфигурации, токены, приватные логи или скриншоты, содержащие учётные данные.

Почему стоит скачать?

Custom Chat полезен игрокам, которые хотят более современный и организованный интерфейс чата, не меняя то, как обычный чат и команды работают на серверах.

Он добавляет более чистую компоновку, стилизованную локальную историю, несколько форматов логов, поддержку кликабельных сообщений, инструменты перевода, Rank Tooltips, просмотр чата Twitch, отображение 7TV и улучшения качества жизни, оставаясь при этом полностью клиентским.

Открытый исходный код и статус разработки

Custom Chat 1.0.8 распространяется под лицензией GNU General Public License v3.0 only (GPL-3.0-only).

Полный исходный код, система сборки, защищённый конвейер сборки, тесты и документация для разработчиков находятся в открытом доступе:

Исходный код: https://github.com/Gardeone12/CustomChat

Документация для разработчиков: https://github.com/Gardeone12/CustomChat/tree/main/docs

Проблемы: https://github.com/Gardeone12/CustomChat/issues

Активная разработка и регулярная поддержка в настоящее время приостановлены на неопределённый срок.

1.0.8 — последний стабильный релиз и финальный запланированный официальный релиз на обозримое будущее.

Это не значит, что проект заброшен навсегда. Разработка может возобновиться позже, а проблемы или пул-реквесты всё ещё могут рассматриваться, но на данный момент нет ни плана развития, ни графика релизов, ни гарантированного времени ответа.

Репозиторий предполагается оставить публичным, даже если активная разработка возобновится.

Примечание о честной игре / анти-чите

Custom Chat не изменяет передвижение, бой, хитбоксы, инвентарь, взаимодействие с миром или серверные проверки.

Он не предоставляет X-Ray, ESP, макросы, автоматизацию боя, читы на передвижение или другие игровые преимущества.

Мод предназначен для улучшения интерфейса чата, локальной истории, локальных логов, перевода, просмотра чата Twitch и других функций качества жизни, связанных с чатом.