自动翻译-下一个

自动翻译-下一个

自动翻译Minecraft中未翻译的语言文件，让你无需等待手动翻译或PR合并，即可用首选语言畅玩任意模组。

工具

English | 中文

English

由于原作者表示该项目已停止开发，本仓库是 Moirstral/AutoTranslation 的续更项目。

AutoTranslation Next

Modrinth CurseForge GitHub Minecraft License Platform

自动翻译 Minecraft 中未翻译的语言文件，让你无需等待人工翻译或 PR 合并，就能用自己偏好的语言畅玩任何模组。

⚠️ V2.0.0 重大变更： 已从 Architectury (Forge/Fabric) 迁移至纯 NeoForge，现仅支持 Minecraft 1.21.1。屏幕翻译功能已移除，仅保留语言文件自动翻译。详见 CHANGELOG。

背景

许多 Minecraft 模组仅有英文。即便你提交翻译 PR，更新周期也难以预料，而且很多模组作者根本不接受翻译 PR。虽然已有一些“自动翻译”模组，但仍存在更新延迟、小众模组无人翻译以及无法处理硬编码文本等问题。

AutoTranslation Next 正是为解决这些痛点而生——它在资源加载时自动检测并翻译缺失的语言条目，无需修改任何模组文件。翻译结果会缓存在本地，可随时润色并导出为资源包。

功能特性

🔤 自动语言文件翻译

核心功能。Minecraft 加载资源时，AutoTranslation Next 会检测缺少当前游戏语言翻译的语言条目，使用配置的引擎进行翻译，并在运行时注入翻译——全程不修改任何模组文件。

  • 适用于任何使用标准 Minecraft 语言文件（.json）的模组
  • 翻译后的文件保存在游戏目录下的 AutoTranslationNext/ 文件夹中，你可以在此审阅、润色，甚至可以将其重新打包成资源包
  • 支持 /auto_translation reload 热重载翻译，无需重启游戏

🌐 内置翻译引擎

引擎 描述
谷歌翻译 (默认) 首次启动时根据游戏语言自动选择最佳域名：简体中文使用 google-translate-proxy.tantu.com（中国大陆可访问），所有其他语言使用 translate.google.com。也可手动设置 google.domain 配置项。
AAAABBBB 测试用途的翻译器。对所有输入始终返回 "AAAABBBB"。适用于验证翻译管线是否正常工作。

🧠 智能英文检测

一个可配置的正则表达式（默认：^(?!.*%[A-Za-z0-9])(?!.*_)(?=.*([A-Z]?[a-z]{2,})).+$）确保只翻译实际的英文文本，同时跳过：

  • 格式说明符（例如 %s、%1$d）
  • 翻译键（基于下划线的标识符）
  • 已本地化的条目

⚙️ 丰富的配置

所有设置均可通过游戏内 Mod 菜单进行配置。选项包括：

  • 翻译引擎选择
  • 源语言 & 目标语言
  • 英文特征正则表达式
  • 过滤模式 (白名单/黑名单)
  • 单词黑名单
  • 调试模式

自动缓存清理： 更改关键设置（过滤模式、正则表达式、语言、翻译器、单词黑名单）时，会自动清除翻译缓存并提示你重启以使更改生效。

🪶 零额外依赖

HTTP 客户端使用 JDK 内置的 java.net.http.HttpClient — 除 Mod 加载器和 Cloth Config 外，无需 Apache HttpClient、OkHttp 或任何额外库。

📦 资源包打包

润色自动翻译的文本后，可导出为标准 Minecraft 资源包：

/auto_translation pack_resource full        # 完整导出
/auto_translation pack_resource increment   # 增量导出（仅变更内容）

这对于整合包作者和翻译团队尤为实用。

前置依赖

依赖 必需 备注
NeoForge ✅ Minecraft 1.21.1
Cloth Config API ✅ v15+

命令

所有命令首先需要确认。在执行任何其他命令前，先运行 /auto_translation confirm：

/auto_translation reload                    重载已翻译的资源
/auto_translation confirm                   确认待执行的命令
/auto_translation pack_resource full        导出完整资源包
/auto_translation pack_resource increment   导出增量资源包

配置

打开 Mods → AutoTranslation Next → Config (需要 Cloth Config API) 即可在游戏中访问所有设置。或者，编辑配置文件 config/autotranslation.json。

关键配置项：

  • 翻译引擎 — 在谷歌翻译、AAAABBBB 或自定义翻译器之间切换
  • 源语言 — 待翻译的语言 (默认：英语)
  • 目标语言 — 自动从你的游戏语言设置中检测
  • 英文特征正则表达式 — 用于识别需要翻译的文本的模式
  • 过滤模式 — 从翻译中白名单或黑名单特定模组/键
  • 单词黑名单 — 翻译时需要跳过的单词或模式

翻译 API

AutoTranslation Next 拥有可扩展的翻译器架构。要添加自定义翻译引擎：

  1. 实现 ITranslator 接口
  2. 通过 TranslatorManager.registerTranslator(String name, Supplier<ITranslator> getInstance) 注册
  3. 在配置菜单中选择
// 示例：注册自定义翻译器
TranslatorManager.registerTranslator("my_translator", MyTranslator::new);

你的翻译器随后会作为选项出现在游戏内配置菜单中。

工作原理

  1. 当 Minecraft 加载资源时，AutoTranslation Next 会拦截语言加载过程
  2. 对于每个没有当前游戏语言翻译的语言条目，它会根据可配置的英文特征正则表达式检查该条目
  3. 匹配的条目被发送到配置的翻译引擎
  4. 翻译结果缓存在游戏目录下的 AutoTranslationNext/ 文件夹中
  5. 后续启动时，会立即加载缓存的翻译——无需重新翻译

AutoTranslationNext/ 文件夹包含：

  • 原始文件 (未翻译的源文本)
  • 翻译文件 (机器翻译的输出结果)

你可以手动润色翻译后的文件，并使用 pack_resource 命令将它们打包成一个标准的 Minecraft 资源包以供分发。

支持版本

本 Mod 仅为以下版本开发和维护。此表之外的版本适配请求将不予考虑。

游戏版本 / 加载器 支持状态
1.21.1 NeoForge 活跃
26.2 NeoForge 即将支持

许可协议

本项目基于 GNU Affero General Public License v3.0 许可。

中文

由于原作者表示该项目已停止开发，本仓库是 Moirstral/AutoTranslation 的续更项目。

AutoTranslation Next（自动翻译 Next）

Modrinth CurseForge GitHub Minecraft License Platform

自动翻译 Minecraft 中未翻译的语言文件，让你无需等待人工翻译或 PR 合并，就能用自己偏好的语言畅玩任何模组。

⚠️ V2.0.0 重大变更： 已从 Architectury (Forge/Fabric) 迁移至纯 NeoForge，现仅支持 Minecraft 1.21.1。屏幕翻译功能已移除，仅保留语言文件自动翻译。详见 CHANGELOG。

背景

很多模组只有英文，即使向作者提交翻译 PR，更新周期也不确定，更有不少模组根本不接受翻译 PR。虽然已有「自动汉化更新」模组，但仍存在更新不及时、小众模组无人翻译、硬编码文本无法汉化等问题。

AutoTranslation Next 正是为解决这些痛点而生——它在游戏加载资源时自动检测并翻译缺失的语言条目，不修改任何模组文件，翻译结果缓存在本地，可随时润色、导出为资源包。

功能特性

🔤 自动翻译语言文件

核心功能。游戏加载资源时，自动检测缺少当前语言翻译的文本条目，调用翻译引擎进行翻译并注入——全程不修改任何模组文件。

  • 兼容所有使用标准 Minecraft 语言文件（.json）的模组
  • 翻译结果保存在游戏目录的 AutoTranslationNext/ 文件夹中，可手动润色后打包为资源包——对整合包和汉化组尤其有用
  • 支持 /auto_translation reload 热重载翻译，无需重启游戏

🌐 内置翻译引擎

引擎 说明
谷歌翻译（默认） 首次启动时根据游戏语言自动选择最优域名：简体中文使用 google-translate-proxy.tantu.com（国内可直连），其他语言使用 translate.google.com。也可手动修改 google.domain 配置项。
AAAABBBB 测试用翻译器，所有翻译固定返回 "AAAABBBB"，方便验证翻译管线是否正常工作

🧠 智能英文识别

通过可配置的正则表达式精确识别需要翻译的英文文本。默认正则 ^(?!.*%[A-Za-z0-9])(?!.*_)(?=.*([A-Z]?[a-z]{2,})).+$ 会智能跳过：

  • 格式化占位符（如 %s、%1$d）
  • 翻译 key（下划线标识符）
  • 已有翻译的条目

⚙️ 丰富的配置项

通过游戏内模组菜单即可配置所有参数：

  • 翻译引擎切换
  • 源语言 / 目标语言
  • 英语特征正则表达式
  • 筛选模式（白名单/黑名单）
  • 单词黑名单
  • 调试模式

自动清理缓存： 修改筛选模式、正则、语言、翻译引擎、单词黑名单等关键设置时，自动删除翻译缓存并提示重启生效。

🪶 零额外依赖

HTTP 客户端采用 JDK 内置的 java.net.http.HttpClient，无需 Apache HttpClient、OkHttp 等任何额外网络库。

📦 资源包打包

润色翻译结果后，可直接导出为标准 Minecraft 资源包：

/auto_translation pack_resource full        # 全量打包
/auto_translation pack_resource increment   # 增量打包（仅变更部分）

对整合包作者和汉化组极其便利。

前置依赖

前置 必须 备注
NeoForge ✅ Minecraft 1.21.1
Cloth Config API ✅ v15+

命令

所有命令需要先确认执行。先运行 /auto_translation confirm，再执行其他指令：

/auto_translation reload                    重载翻译资源
/auto_translation confirm                   确认执行指令
/auto_translation pack_resource full        全量打包资源包
/auto_translation pack_resource increment   增量打包资源包

配置

在游戏中打开 Mods → AutoTranslation Next → Config（需安装 Cloth Config API）即可可视化配置。也可直接编辑 config/autotranslation.json 配置文件。

主要配置项：

  • 翻译引擎 — 切换 Google、AAAABBBB 或自定义翻译器
  • 源语言 — 待翻译的语言（默认：英语）
  • 目标语言 — 自动跟随游戏语言设置
  • 英语特征 — 用于识别需翻译文本的正则表达式
  • 筛选模式 — 白名单/黑名单模式，控制哪些模组或 key 纳入/排除翻译
  • 单词黑名单 — 跳过包含特定词汇的文本

翻译 API（开发者）

AutoTranslation Next 拥有可扩展的翻译器架构。添加自定义翻译引擎：

  1. 实现 ITranslator 接口
  2. 调用 TranslatorManager.registerTranslator(String name, Supplier<ITranslator> getInstance) 注册
  3. 在配置菜单中即可选择你的翻译器
// 示例：注册自定义翻译器
TranslatorManager.registerTranslator("my_translator", MyTranslator::new);

注册后，你的翻译器会自动出现在游戏内的翻译引擎选项中。

工作原理

  1. Minecraft 加载资源时，AutoTranslation Next 拦截语言加载流程
  2. 对每个缺少当前语言翻译的条目，使用可配置的正则表达式判断是否需要翻译
  3. 匹配的条目发送至指定的翻译引擎进行翻译
  4. 翻译结果缓存在游戏目录的 AutoTranslationNext/ 文件夹中
  5. 下次启动时直接从缓存加载，无需重复翻译

AutoTranslationNext/ 文件夹内容：

  • 原始文件 — 未翻译的源文本
  • 翻译文件 — 机翻输出

你可以手动润色翻译文件，然后用 pack_resource 指令打包为标准 Minecraft 资源包进行分发。

支持版本

模组仅在以下版本上开发和维护，暂不考虑表格之外的版本适配请求。

游戏版本 / 加载器 支持状态
1.21.1 NeoForge 持续更新
26.2 NeoForge 即将支持

许可协议

本项目基于 GNU Affero General Public License v3.0 开源。