Chat Translation

Chat Translation Mod · 聊天翻译模组

自动翻译 Minecraft 聊天消息的客户端模组，支持免 API Key 场景下直接可用，并提供模组菜单配置界面。

简体中文 / English (see below)

✨ 特性

• 🎯 自动翻译聊天消息：进入服务器后自动翻译所有聊天信息
• 🔓 免 Key 可用：默认使用无需 API Key 的翻译服务（Google Proxy、彩云小译）

• 🎮 模组菜单支持：

  • Fabric：Mod Menu + Cloth Config GUI
  • NeoForge：Catalogue 菜单集成
• 🌐 多种翻译源：Google Translate、Google Proxy、彩云小译、DeepL、有道翻译、讯飞听见翻译
• 📡 连接测试：可以在配置里直接测试所选翻译源是否可用
• 🔁 智能回退：翻译失败（如 HTTP 403）自动显示原文
• 🛡️ SSL 兼容模式：可选关闭 SSL 校验以应对证书链问题
• 🧹 消息清洗：自动剥离 Hypixel 彩色码、Rank 等装饰信息

📦 支持的版本

🚀 安装

Fabric

1. 安装 Fabric Loader 和 Fabric API
2. 下载并安装 Mod Menu（用于配置界面）
3. 将本模组 jar 文件放入 .minecraft/mods/ 目录
4. 启动游戏

NeoForge

1. 安装 NeoForge Loader
2. 将本模组 jar 文件放入 .minecraft/mods/ 目录
3. 在模组列表中找到 Chat Translation，点击配置
4. 启动游戏

⚙️ 配置

进入游戏后：

• Fabric：在 Mod Menu 里点击 Chat Translation 的配置按钮
• NeoForge：在模组列表里点击 Chat Translation 的配置入口

可配置项：

• 翻译服务 Provider：Google Translate / Google Proxy / 彩云小译 / DeepL / 有道 / 讯飞听见
• 目标语言 Target Language：例如 zh-CN、en
• 源语言自动检测：默认开启
• SSL 不安全模式：如遇证书链问题可打开
• 测试连接：在配置界面直接测试当前 provider 是否可访问

🔑 翻译源说明

推荐优先使用： 1.Google Translate (官方) 2. 彩云小译（稳定，免 key）

如果遇到 403 或无法连接，可切换到其它 provider，或在配置里打开 SSL 不安全模式。

🛠️ 常见问题

模组加载时报 missing cloth-config / modmenu

Fabric 版本中这些是可选依赖；模组会自动降级运行，但没有图形配置界面。安装 Mod Menu + Cloth Config 即可获得完整 GUI。

日志中出现 SSLHandshakeException: PKIX path building failed

打开配置里的 SSL 不安全模式（跳过证书校验）再试。

日志中出现 Google Proxy Error: HTTP 403

这是 Google 代理接口触发了风控；模组会自动回退显示原文。建议切换到 彩云小译 或切换到带 API Key 的官方 Provider。

切换 provider 后没变化

在配置界面点击 重载 Provider / 保存配置后，或直接 重启游戏 即可生效。

在 Hypixel 上看不到聊天翻译

请确认：

1. 已经进入服务器（聊天事件只在联机世界里大量触发）
2. 模组在 Fabric/NeoForge 加载日志中显示 ChatTranslation
3. 日志里有 [ChatTranslation] Provider reloaded: 字样

📁 项目结构

Chat Translation/
├── 1.21.1/
│   ├── fabric/
│   └── neoforge/
├── 1.21.4/
│   ├── fabric/
│   └── neoforge/
├── 1.21.8/
│   ├── fabric/
│   └── neoforge/
├── 1.21.11/
│   ├── fabric/
│   └── neoforge/
└── 26.1.2/
    └── fabric/

主要源码路径（各版本目录内）：

• Fabric: src/main/java/com/chattranslation/
• NeoForge: src/main/java/com/chattranslation/

🏗️ 构建

进入具体版本目录，例如：

cd "d:\mod\Chat Translation\1.21.4\fabric"
.\gradlew.bat build

产物位置：

• Fabric: `build/libs/chattranslation-.jar`
• NeoForge: `build/libs/chattranslation-.jar`

Java 版本：

• 1.21.x：Java 21+
• 26.1.2：Java 25+

Chat Translation Mod

Клиентский мод для Minecraft, который автоматически переводит сообщения в чате. По умолчанию работает без API-ключей и предоставляет интерфейс настройки в меню модов.

✨ Возможности

• 🎯 Автоматически переводит каждое входящее сообщение в чате
• 🔓 По умолчанию работает без API-ключей (Google Proxy, Caiyun Translate)

• 🎮 Интерфейс в меню модов:

  • Fabric: Mod Menu + Cloth Config GUI
  • NeoForge: интеграция с Catalogue
• 🌐 Несколько провайдеров: Google Translate, Google Proxy, Caiyun, DeepL, Youdao, iFlyRec
• 📡 Встроенная в интерфейс настройки проверка соединения
• 🔁 Аккуратный откат: при ошибке перевода (например, HTTP 403) показывается оригинальное сообщение
• 🛡️ Необязательный небезопасный режим SSL для обхода проблем с цепочкой сертификатов
• 🧹 Автоматическая очистка серверных украшений (цветовые коды Hypixel, ранги)

📦 Поддерживаемые версии

🚀 Установка

Fabric

1. Установи Fabric Loader и Fabric API
2. Установи Mod Menu для интерфейса настроек
3. Закинь jar-файл мода в .minecraft/mods/
4. Запусти игру

NeoForge

1. Установи NeoForge Loader
2. Закинь jar-файл мода в .minecraft/mods/
3. В списке модов открой настройки Chat Translation
4. Запусти игру

⚙️ Настройка

• Fabric: в Mod Menu нажми кнопку настроек рядом с Chat Translation
• NeoForge: открой пункт настроек из списка модов

Доступные опции:

• Провайдер: Google Translate / Google Proxy / Caiyun / DeepL / Youdao / iFlyRec
• Целевой язык, с автоматическим определением исходного языка, включённым по умолчанию
• Небезопасный режим SSL (для окружений со сломанной цепочкой сертификатов)
• Встроенный тест соединения для выбранного провайдера

🔑 Провайдеры

Рекомендуемый порядок:

1. Google (официальный)
2. Caiyun

Если получаешь 403 или ошибки соединения, смени провайдера или включи небезопасный режим SSL.

🛠️ Решение проблем

Мод загружается, но ругается на отсутствие cloth-config / modmenu

В Fabric это необязательные зависимости. Мод всё равно работает, но без GUI. Установи Mod Menu + Cloth Config, чтобы вернуть полную настройку.

SSLHandshakeException: PKIX path building failed в логах

Включи небезопасный режим SSL в интерфейсе настроек.

Google Proxy Error: HTTP 403 в логах

Прокси-эндпоинт упирается в лимиты. Мод покажет оригинальное сообщение. Переключись на Caiyun или на провайдера с ключом.

После смены провайдера ничего не меняется

Нажми Reload Provider в интерфейсе или перезапусти игру.

Нет перевода чата на Hypixel

Убедись, что:

• Ты действительно подключён к серверу
• ChatTranslation есть в логе загрузки модов
• В логе есть [ChatTranslation] Provider reloaded:

📁 Структура проекта

Chat Translation/
├── 1.21.1/
│   ├── fabric/
│   └── neoforge/
├── 1.21.4/
│   ├── fabric/
│   └── neoforge/
├── 1.21.8/
│   ├── fabric/
│   └── neoforge/
├── 1.21.11/
│   ├── fabric/
│   └── neoforge/
└── 26.1.2/
    └── fabric/