I18nAutoUpdateMod

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

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

特性

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

安装与使用

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

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

兼容性

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

补充说明

• 启动等待配置：首次启动无本地资源包时的最大等待时间默认为 10 秒，可通过 JVM 参数 -Di18nautoupdatemod.initialTimeout=<秒数> 调整（设为 0 即完全不等待）。
• 缓存路径：汉化包缓存存放于用户数据目录下的 .i18nautoupdatemod 中。若先前使用过原版模组，旧版 .i18nupdatemod 缓存会自动平滑迁移。
• 网易版环境：检测到网易版 Minecraft 环境时将自动跳过在线下载，以遵守其开发者规范。

构建

项目使用 JDK 25 和 Gradle Wrapper：

./gradlew clean test shadowJar

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

开源协议

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

English

A Minecraft client-side mod that automatically downloads, updates, and applies the CFPA Minecraft Mod Language Package for Simplified Chinese translations.

Refactored from CFPAOrg/I18nUpdateMod3 to eliminate game startup delays, improve mirror reliability and failover, and provide universal multi-loader compatibility within a single JAR.

Features

• Updates are checked and downloaded on a background daemon thread, never slowing down game launch.
• A single JAR supports MinecraftForge, NeoForge, Fabric, and Quilt out of the box.
• Downloads directly from release sources instead of delayed index files.
• Concurrently probes mainland China mirrors while preferring GitHub abroad, with automatic fallback on timeout, 404, or checksum mismatch.
• Downloads to temporary files and verifies MD5 checksums before replacing, ensuring existing cache is never corrupted.
• Dynamically merges language assets and generates the correct pack.mcmeta format for your Minecraft version (1.6.1 through 26.3).
• Automatically placed at the bottom of the resource pack list, preserving custom texture pack priority.

Installation

1. Download the latest JAR from Modrinth or GitHub Releases.
2. Place the JAR into your .minecraft/mods directory.

Client-side only; do not install on dedicated servers. On first launch without local cache, the game waits a few seconds so the pack is loaded immediately, falling back to the next launch if the download times out; existing cached packs are used immediately without blocking launch.

Compatibility

• Minecraft: 1.6.1 to 26.3 (see gradle.properties)
• Loaders: MinecraftForge, NeoForge, Fabric, and Quilt
• Java: Targets Java 8 bytecode; runtime requirements depend on the selected Minecraft version and loader.

Notes

• Startup timeout configuration: The maximum wait time on first launch without local cache defaults to 10 seconds and can be configured via -Di18nautoupdatemod.initialTimeout=<seconds> (set to 0 to disable waiting completely).
• Cache location: Cached files are stored in .i18nautoupdatemod under the platform user data directory. Existing cache from the legacy .i18nupdatemod folder is migrated automatically.
• NetEase client: Online downloads are automatically disabled when the NetEase Minecraft environment is detected.

Building

Requires JDK 25 and Gradle Wrapper:

./gradlew clean test shadowJar

Artifacts are output to build/libs/I18nAutoUpdateMod-<version>-all.jar.

License

Licensed under AGPL-3.0-or-later.