AutoTranslator – Smart AI-Powered Minecraft Mod Translation<\/p>\n
https:\/\/img.shields.io\/badge\/License-MIT-green
\nhttps:\/\/img.shields.io\/badge\/NeoForge-1.21.1-blue
\nhttps:\/\/img.shields.io\/badge\/Translation%2520Data-CC%2520BY–NC–SA%25204.0-lightgrey<\/p>\n
**One-click AI translation \u2013 say goodbye to untranslated mods!**
\nAutoTranslator is a client-side NeoForge 1.21.1 mod that uses any AI model you configure (local or cloud) to\u00a0**batch-translate all installed mod language files into Simplified Chinese**\u00a0and automatically pack them as a resource pack for immediate effect.<\/p>\n
—<\/p>\n
## \u2728 Key Features<\/p>\n
### \ud83e\udd16 AI-Powered Automation<\/p>\n
No more manual searching for translation packs. Just configure your AI API endpoint, click “Start Translation”, and all missing Chinese entries are generated automatically. Enjoy a fully localized experience in minutes.<\/p>\n
### \ud83d\udcda Built-in Terminology Database<\/p>\n
Before sending requests to the AI, the mod queries a local SQLite dictionary (sourced from the CFPA project) for known Minecraft terms. This ensures consistent translations and drastically reduces API calls, saving token costs.<\/p>\n
### \ud83d\udd17 i18n Resource Pack Synergy<\/p>\n
Unique integration with existing i18n resource packs (e.g.,\u00a0`Minecraft-Mod-Language-Modpack`). The mod can\u00a0**read translations from an external Chinese resource pack**\u00a0and only forward the remaining missing entries to the AI. This further reduces costs and improves overall quality.<\/p>\n
### \u2699\ufe0f Full Transparency & Control<\/p>\n
– **In-game GUI**\u00a0for easy configuration: API URL, key, model name, local\/remote mode, etc.<\/p>\n
– **Detailed debug log**\u00a0at\u00a0`config\/autotranslator\/debug.log`\u00a0\u2013 tracks every request, dictionary hit, and progress.<\/p>\n
– **Whitelist \/ Blacklist filtering**\u00a0to translate only specific mods.<\/p>\n
– **Manual stop**\u00a0anytime without corrupting the generated pack.<\/p>\n
– **Atomic resource pack replacement**\u00a0\u2013 temporary file is atomically moved to the final pack, preventing incomplete reads.<\/p>\n
—<\/p>\n
## \ud83d\udce6 Quick Start<\/p>\n
### 1. Install<\/p>\n
Place the mod\u00a0`.jar`\u00a0into your\u00a0`mods`\u00a0folder and launch the game.<\/p>\n
### 2. Open Configuration<\/p>\n
Go to\u00a0**Options**\u00a0\u2192 click\u00a0**AI Translation Settings**.<\/p>\n
### 3. Enter API Details<\/p>\n
– **API URL**: e.g.,\u00a0`https:\/\/api.deepseek.com\/v1\/chat\/completions`\u00a0(cloud) or\u00a0`http:\/\/localhost:1234\/v1\/chat\/completions`\u00a0(local LM Studio).<\/p>\n
– **API Key**: For cloud services, enter your key. For local models, any string works (e.g.,\u00a0`lm-studio`).<\/p>\n
– **Model Name**: Exact model identifier, e.g.,\u00a0`deepseek-chat`,\u00a0`qwen2.5-7b-instruct`.<\/p>\n
– **Local Mode**: Enable when using a local API (runs tasks sequentially to avoid overload).<\/p>\n
### 4. (Optional) Advanced Configuration<\/p>\n
Edit\u00a0`config\/autotranslator\/config.json`\u00a0for hidden settings (preserved across saves even though not in GUI):<\/p>\n
– `timeout_seconds`: Request timeout in seconds (default\u00a0`300`; recommend\u00a0`600`\u00a0for slow local models).<\/p>\n
– `batch_size`: Number of entries per AI call (default\u00a0`30`; reduce to\u00a0`10`\u00a0if timeouts occur).<\/p>\n
– `requests_per_second`: Max API calls per second (default\u00a0`5`; can be increased for local models).<\/p>\n
– `filter_mode`\u00a0\/\u00a0`filter_list`: Mod filtering (whitelist\/blacklist).<\/p>\n
– `system_prompt`: Custom AI translation instructions.<\/p>\n
– **`i18n_resourcepack_name`**: Name of an external i18n resource pack file; set to\u00a0`”none”`\u00a0to disable (see i18n synergy below).<\/p>\n
### 5. Start Translation<\/p>\n
– Make sure the\u00a0`AutoTranslation.zip`\u00a0resource pack is\u00a0**disabled**\u00a0in the Resource Packs screen before starting.<\/p>\n
– Back in the configuration screen, click\u00a0**”Start Translation”**.<\/p>\n
– Progress is shown at the bottom. After completion, press\u00a0`F3+T`\u00a0to reload resource packs.<\/p>\n
—<\/p>\n
## \ud83c\udf10 i18n Resource Pack Synergy (Detailed)<\/p>\n
If you have a community-maintained i18n pack such as\u00a0`Minecraft-Mod-Language-Modpack-Converted-1.21.1.zip`, place it inside the\u00a0`resourcepacks`\u00a0folder and update\u00a0`config.json`:<\/p>\n
json<\/p>\n
“i18n_resourcepack_name”: “Minecraft-Mod-Language-Modpack-Converted-1.21.1.zip”<\/p>\n
When translating, the mod will\u00a0**extract all Chinese strings from that pack and overwrite its own output with them**. Only keys that are still missing will be sent to the AI. This can save over 70% of API calls.<\/p>\n
**Priority**: i18n pack > previous AutoTranslator cache > AI translation.
\n**Enabling**: After modifying config, click “Reload File” in the GUI or restart the game.<\/p>\n
—<\/p>\n
## \u26a0\ufe0f Important Notes<\/p>\n
– **Resource Pack Conflict**: Always disable the existing\u00a0`AutoTranslation.zip`\u00a0in the resource pack menu before starting a new translation.<\/p>\n
– **Network Issues**: If dictionary download or GitHub access fails in some regions, add\u00a0`-Djava.net.useSystemProxies=true`\u00a0to your launcher’s JVM arguments and enable a system proxy.<\/p>\n
– **Token Consumption**: When using cloud APIs, be aware of token billing. Using the built-in dictionary and an i18n pack drastically reduces costs.<\/p>\n
– **Local Model Tuning**: Set a higher timeout (e.g.,\u00a0`600`\u00a0seconds) and smaller batch size (e.g.,\u00a0`10`) to avoid request timeouts.<\/p>\n
– **Safety**: This mod only runs on the client, does not modify core game files, and only adds a resource pack.<\/p>\n
—<\/p>\n
## \ud83d\udcc2 File Structure<\/p>\n
text<\/p>\n
config\/autotranslator\/
\n\u251c\u2500\u2500 config.json # User configuration
\n\u251c\u2500\u2500 debug.log # Detailed translation log
\n\u2514\u2500\u2500 dict\/
\n \u2514\u2500\u2500 Dict-Sqlite.db # Automatically downloaded Minecraft terminology database
\nresourcepacks\/
\n\u2514\u2500\u2500 AutoTranslation.zip # Generated Chinese resource pack<\/p>\n
—<\/p>\n
## \ud83e\udd1d Open Source & Attribution<\/p>\n
This mod’s built-in translation database is sourced from\u00a0CFPATools\/i18n-dict, with original data maintained by\u00a0CFPAOrg\/Minecraft-Mod-Language-Package\u00a0under the\u00a0Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License (CC BY-NC-SA 4.0).<\/p>\n
The mod code is released under the MIT License.<\/p>\n
—<\/p>\n
## \ud83d\udcdd Debugging & Logs<\/p>\n
All translation activities are recorded in\u00a0`config\/autotranslator\/debug.log`\u00a0with timestamps (`[HH:mm:ss]`). The log is in Chinese for the developer’s convenience.<\/p>\n
Monitor it live:<\/p>\n
bash<\/p>\n
tail -f config\/autotranslator\/debug.log<\/p>\n
—<\/p>\n
## \ud83d\udca1 FAQ<\/p>\n
**Q: Why do some entries fail to translate?**
\nA: Usually an API timeout or malformed response. Increase\u00a0`timeout_seconds`, decrease\u00a0`batch_size`, and verify the model name.<\/p>\n
**Q: How to translate only specific mods?**
\nA: Set\u00a0`filter_mode`\u00a0to\u00a0`whitelist`\u00a0and add mod IDs to\u00a0`filter_list`\u00a0(comma-separated) in\u00a0`config.json`.<\/p>\n
**Q: How to update the built-in dictionary?**
\nA: The dictionary auto-updates every 7 days. Alternatively, delete\u00a0`config\/autotranslator\/dict\/Dict-Sqlite.db`\u00a0and restart the game.<\/p>\n
**Q: Can I share the generated resource pack?**
\nA: Absolutely!\u00a0`AutoTranslation.zip`\u00a0is a standard resource pack and can be shared freely.<\/p>\n
<\/p>\n","protected":false},"excerpt":{"rendered":"
Use private or public AI to translate mod files into Chinese language files<\/p>\n","protected":false},"featured_media":23927,"template":"","meta":{"_minecraft_slug":"autotranslator","_minecraft_project_id":"MGTITR8H","_minecraft_author":"li27744","_minecraft_license":"MIT","_minecraft_downloads":165,"_minecraft_follows":0,"_minecraft_client_side":"optional","_minecraft_server_side":"optional","_minecraft_storage_type":"zip","_minecraft_archive_name":"autotranslator.zip","_minecraft_size_bytes":41464694,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-16T14:45:12.246328Z","_minecraft_date_created":"2026-04-30T02:35:59.859216Z","_minecraft_date_modified":"2026-05-04T07:27:11.158580Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/autotranslator","_minecraft_icon_attachment_id":23927,"_minecraft_imported_at":"2026-06-01T08:03:43+00:00","_minecraft_import_hash":"c372ed119c9598c6b2b1e2f245c6e75e","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[158,92],"mod_loader":[160],"minecraft_version":[37],"class_list":["post-23926","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-neoforge","mod_category-utility","mod_loader-neoforge","minecraft_version-1-21-1"],"yoast_head":"\n