0 of 0
About this mod
The AutoLocalization Engine is a game localization tool designed specifically for BepInEx mods. It automatically translates descriptions and text for in-game config options Easily localize all your mod settings yourself!
- Requirements
- Permissions and credits
🚀 Mod Introduction: AutoLocalization Engine
The AutoLocalization Engine is a game localization tool designed specifically for BepInEx mods. It automatically translates descriptions and text for in-game config options Easily localize all your mod settings yourself!
Core Value: Eliminate English configuration struggles – create a fully localized mod experience!
✨ Core Features
💡 CRITICAL NOTE: This mod MUST be the first plugin loaded! Plugins loaded before AutoLocalization Engine will not be translated.
🛠️ Usage Guide
Hot-Reload Process:
Handling New Mods:
Example YAML Format:
yaml
Reset setting text: Reset setting textClear search text: Clear search textCancel button text: Cancel button textText on enabled toggle: Text shown when toggle is ONText on disabled toggle: Text shown when toggle is OFF
❓ Frequently Asked Questions
📜 Update Log
If this mod enhances your modding experience, please consider:
The AutoLocalization Engine is a game localization tool designed specifically for BepInEx mods. It automatically translates descriptions and text for in-game config options Easily localize all your mod settings yourself!
Core Value: Eliminate English configuration struggles – create a fully localized mod experience!
✨ Core Features
- 🌍 One-Click Translation: Automatically detects and translates config option descriptions.
- 🔄 Real-Time Hot-Reload: See translations update instantly (within ~5 seconds) without restarting the game.
- 📥 Smart Text Collection: Automatically gathers untranslated text from new mods.
- ⚡ Performance Optimized: Built for heavy loads (supports 20,000+ config items), uses smart caching, and processes in background threads for zero impact on game performance.
- Automatic Recognition: Identifies config descriptions across all mods.
- Simple Translation Format: Uses clean, easy-to-edit YAML files.
- Multi-Language Support: Translate into any language (Chinese, Japanese, Korean, etc.).
- Installation Steps:
- Download the mod files.
- Extract the files into your game's root directory.
- Place the file into the folder.
Autolocalization.dllBepInEx/plugins - Start the game. The mod will initialize automatically.
💡 CRITICAL NOTE: This mod MUST be the first plugin loaded! Plugins loaded before AutoLocalization Engine will not be translated.
🛠️ Usage Guide
- First Use:
- Start the game.
- The mod will generate these files in :
BepInEx/config/AutoLocalizationEngineAutolocalizationGlobalTranslations.yaml(Your translation file)AutolocalizationUntranslatedTexts.yaml(Collected untranslated text)
- Edit to add/update translations (Example format below).
AutolocalizationGlobalTranslations.yaml - Save the file.
- Wait ~5 seconds.
- Return to the game to see the updated translations.
- Install a new mod.
- Start the game.
- The new mod's untranslated text will automatically be added to .
AutolocalizationUntranslatedTexts.yaml - Copy these new entries into , add your translations, save, and they will load automatically.
AutolocalizationGlobalTranslations.yaml
Example YAML Format:
yaml
Reset setting text: Reset setting textClear search text: Clear search textCancel button text: Cancel button textText on enabled toggle: Text shown when toggle is ONText on disabled toggle: Text shown when toggle is OFF
❓ Frequently Asked Questions
- Q: Translations aren't working. What do I do?
- A:
- Check Text Matching: Ensure the text in your translation file exactly matches the untranslated text (including capitalization, spaces, and punctuation).
- Verify Load Order: AutoLocalization Engine MUST be the first loaded plugin! Use the BepInEx or settings to enforce this if needed.
DoorstopBepInEx.Preloader - Check YAML Syntax: Ensure your file has correct syntax (no missing colons, proper indentation, valid characters).
AutolocalizationGlobalTranslations.yaml - Wait for Reload: Remember to wait ~5 seconds after saving the file.
- Check File Location: Confirm the files are in .
BepInEx/config/AutoLocalizationEngine
- A:
📜 Update Log
- v1.0.0 (2025-07-04) - Initial Release
- First stable version release.
- Supports automatic translation of configuration description text.
- Implements hot-reload functionality.
- Adds debug mode.
If this mod enhances your modding experience, please consider:
- Sharing it with more players!
- Multiple feedback channels: QQ group 157845336 or Discord channel: https://discord.gg/Rb5sMKUt