yiche’s AutoTranslator

AutoTranslator (Universal)

Break the language barrier in Minecraft! Automatically translate any mod into YOUR language.

📖 Overview

AutoTranslator is a powerful client-side utility mod for NeoForge 1.21 that automatically translates items, blocks, and tooltips from any mod into your native language using the Google Translate engine.

Are you tired of playing awesome mods that only support English? Or are you an English speaker trying to play a Japanese/Chinese mod? AutoTranslator solves this instantly.

✨ Key Features

• 🌍 Universal Language Support: The mod automatically detects your Minecraft language setting. Whether you play in Spanish, German, Polish, Chinese, Russian, or Korean, it translates everything to match your game settings.

• 🔑 No API Key Required: Uses the public Google Translate Web API. You don’t need to pay or configure complicated API keys. Just install and play!

• ⚡ Dual-Mode Engine:

  • Background Scan: Silently translates all items in the game registry in the background without causing lag.

  • VIP Instant Translation: Hovering over an item with your mouse triggers an instant priority translation for tooltips and dynamic data.

• 🧠 Smart Filtering:

  • Automatically skips text that is already in your language to save resources.

  • Ignores numbers, symbols, and internal mod IDs.

• 💾 Persistent Cache: Translations are saved locally to a .json file. You only need to translate once!

🚀 How to Use

1. Install the mod (NeoForge 1.21).

2. Launch the game. The mod detects your language setting (e.g., fr_fr for French, es_es for Spanish).

3. Wait a moment. You will see a message in the chat: [AutoTranslator] Engine Started.

4. Play! English item names will magically turn into your language as the background scanner works.

📝 How to Edit Translations (Manual Fixes)

Sometimes machine translation isn’t perfect. If you are not satisfied with a specific translation, you can manually edit the cache file:

1. Go to your Minecraft installation folder (usually the same folder where your mods, config, and saves folders are located).

2. Look for a file named autotranslator_cache_[language].json.

   • Example: If you play in Spanish, look for autotranslator_cache_es_es.json.

3. Open the file with a text editor (Notepad, VS Code, etc.).

4.Find the line with the incorrect translation. The format is:

“Original English Name”: “Translated Name”

5. Change the text on the right side to your preferred translation.

6. Save the file and restart the game

7. It is recommended to back up the file before modifying it to prevent it from being overwritten by the new file if it becomes corrupted.

⚠️ Important Notes

• Internet Connection: An active internet connection is required for the initial translation.

• Rate Limiting: To prevent Google from blocking your IP, the background scanner processes items at a safe speed (approx. 8 items every 5 seconds). Please be patient on the first run!

• Client-Side Only: You do not need to install this on the server.

📂 Technical Info

• Mod Loader: NeoForge

• Minecraft Version: 1.21.x

• Configuration: Zero-config (Auto-detects game language).