I18nAutoUpdateMod

是一款客户端模组，可为 Minecraft 自动下载、更新并应用 CFPA 简体中文模组汉化包。

本项目基于 CFPAOrg/I18nUpdateMod3 重构，移除了启动阻塞逻辑，优化了镜像源竞速与容灾机制，并提供单 JAR 全加载器跨版本兼容。

特性

更新检查与下载均在独立守护线程完成，绝不拖慢游戏启动速度。
单一 JAR 文件同时兼容 MinecraftForge、NeoForge、Fabric 与 Quilt，无需按加载器分别下载。
直接对接官方发布源，不依赖更新易滞后的索引文件。
国内网络并发探测可用镜像源，海外直连 GitHub，遇到超时、404 或校验失败自动无感回退。
下载完成并校验 MD5 后再原子替换现有文件，网络中断或下载失败绝不损坏已有缓存。
根据当前游戏版本与加载器自动合并汉化资源，并生成适配当前版本的 pack.mcmeta（支持 1.6.1 到 26.3）。
默认自动将汉化包注册在资源包列表最底层，不与玩家自定义的材质包抢优先级。

安装与使用

前往 Modrinth 或 GitHub Releases 下载最新 JAR。
将 JAR 放入客户端的 mods 文件夹，启动游戏即可。

本模组仅需在客户端安装，服务端无需安装。首次启动且本地无缓存包时会有限等待数秒以直接载入汉化，若网络超时则在后台继续下载并在下次启动生效；日常已有缓存时完全异步检查更新，无需手动在资源包界面调整。

兼容性

游戏版本：Minecraft 1.6.1 至 26.3（具体版本见 gradle.properties）
模组加载器：MinecraftForge、NeoForge、Fabric、Quilt
Java 环境：模组字节码目标为 Java 8，运行时遵循对应 Minecraft 与加载器的 Java 要求。

设置

首次启动后会在游戏目录生成 config/i18nautoupdatemod.json，修改后重启游戏生效

{
  "forceBottom": true,
  "defaultSource": "auto",
  "mirrorPriority": ["CFPA", "Community", "GitHub"],
  "betaPack": false,
  "mergeLoaders": false,
  "initialTimeout": 10
}

forceBottom：是否每次启动都把汉化包强制移到资源包列表最底层，关闭后保留玩家手动调整的位置，仅首次添加时置底
defaultSource：默认下载源，可选 auto / GitHub / CFPA / Community，auto 为按地区自动测速选择
mirrorPriority：默认源之外的回退顺序，未列出的源自动追加到末尾
betaPack：是否使用 Beta 资源包，优先下载 CFPA-AutoMerge 每 6 小时合并全部未合并 PR 后打包的版本，下载失败时回退正式包
mergeLoaders：不区分加载器，同时下载并合并 Forge 与 Fabric 汉化包，翻译冲突时以当前加载器的版本为准
initialTimeout：首次启动无本地资源包时的最大等待秒数，设为 0 即完全不等待

补充说明

启动等待配置：JVM 参数 -Di18nautoupdatemod.initialTimeout=<秒数> 优先于配置文件中的 initialTimeout
缓存路径：汉化包缓存存放于用户数据目录下的 .i18nautoupdatemod 中。若先前使用过原版模组，旧版 .i18nupdatemod 缓存会自动平滑迁移。
网易版环境：检测到网易版 Minecraft 环境时将自动跳过在线下载，以遵守其开发者规范。

构建

项目使用 JDK 25 和 Gradle Wrapper：

./gradlew clean test shadowJar

构建产物位于 build/libs/I18nAutoUpdateMod-<version>-all.jar。

开源协议

本项目采用 AGPL-3.0-or-later 协议开源。

English

一款 Minecraft 客户端模组，可自动下载、更新并应用 CFPA Minecraft 模组语言包以提供简体中文翻译。

本项目基于 CFPAOrg/I18nUpdateMod3 重构，以消除游戏启动延迟、提升镜像可靠性及故障转移能力，并在单一 JAR 中提供通用的多加载器兼容性。

特性

更新检查与下载在后台守护线程进行，绝不拖慢游戏启动。
单一 JAR 开箱即支持 MinecraftForge、NeoForge、Fabric 与 Quilt。
直接从发布源下载，而非滞后的索引文件。
并发探测中国大陆镜像源，海外优先 GitHub，超时、404 或校验和不匹配时自动回退。
先下载到临时文件并校验 MD5 校验和后再替换，确保现有缓存绝不被损坏。
动态合并语言资源，并为你的 Minecraft 版本（1.6.1 至 26.3）生成正确的 pack.mcmeta 格式。
默认置于资源包列表底部，保留自定义材质包的优先级。

安装

从 Modrinth 或 GitHub Releases 下载最新 JAR。
将 JAR 放入你的 .minecraft/mods 目录。

仅客户端使用；请勿安装在专用服务器上。首次启动且无本地缓存时，游戏会等待几秒以便资源包立即加载；若下载超时则回退到下次启动；已有缓存的资源包会立即使用，不会阻塞启动。

兼容性

Minecraft：1.6.1 至 26.3（见 gradle.properties）
加载器：MinecraftForge、NeoForge、Fabric 和 Quilt
Java：目标为 Java 8 字节码；运行时要求取决于所选的 Minecraft 版本和加载器。

设置

首次启动时会在游戏目录下的 config/i18nautoupdatemod.json 生成配置文件，更改后需重启游戏生效

forceBottom：每次启动时将语言包移动到资源包列表底部；禁用时保留你手动设置的位置，仅在首次添加时将资源包置于底部
defaultSource：首选下载源，为 auto / GitHub / CFPA / Community 之一，其中 auto 会根据位置和探测选择源
mirrorPriority：其他源的回退顺序，未列出的源会自动追加
betaPack：优先使用来自 CFPA-AutoMerge 的测试版资源包，每 6 小时重新构建并合并所有开放的拉取请求，下载失败时回退到稳定版资源包
mergeLoaders：忽略加载器并同时合并 Forge 和 Fabric 资源包，冲突时以当前加载器的翻译为准
initialTimeout：首次启动且无本地缓存时的最大等待秒数，设为 0 可禁用等待

注意

启动超时配置：JVM 属性 -Di18nautoupdatemod.initialTimeout=<seconds> 优先于配置文件中的 initialTimeout
缓存位置：缓存文件存储在平台用户数据目录下的 .i18nautoupdatemod 中。来自旧版 .i18nupdatemod 文件夹的现有缓存会自动迁移。
网易客户端：检测到网易 Minecraft 环境时，在线下载会自动禁用。

构建

需要 JDK 25 和 Gradle Wrapper：

./gradlew clean test shadowJar

构建产物输出到 build/libs/I18nAutoUpdateMod-<version>-all.jar。

许可证

依据 AGPL-3.0-or-later 许可。

I18nAutoUpdateMod

介绍