🌍 AutoLocalization Engine
Make all mod configuration texts display in your preferred language!
✨ What This Mod Does For You
- 🎯 Native Language Experience - Convert all mod configuration texts to your preferred language
- 🔄 Automatic Detection - Intelligently discovers all text content that needs translation
- 📝 Easy Translation - Simple text editing to complete language conversion
- ⚡ Smooth Performance - Optimized for large numbers of mods, doesn't affect gameplay
- 🌐 Multi-language Support - Supports any language you prefer
- 🛡 Stable & Safe (v1.5.6) - Safer handling of invalid translations and config keys to prevent crashes
🎯 How It Works
Step 1: Automatic Scanning
The mod automatically scans all your installed mods to find text content that needs translation
Step 2: Generate Translation Files
The system creates two files:
- 📄
collected_items.yaml - Contains all original text needing translation
- 📄
translations.yaml - Where you add your language translations
Step 3: Enjoy Native Language Reading
Simply fill in your translations and restart the game to enjoy reading in your native language!
📥 Installation Guide
- Download the mod file
- Extract to your game's
BepInEx/plugins folder
- Start the game
- Begin enjoying automatic localization services!
💡 Recommended (optional): Placing this mod early in the load order can help capture more config texts, but it is not required
🛠️ How to Use
First Time Setup
- Start the game - the mod begins working automatically
- Find generated files in
BepInEx/config/Autolocalization
- Open the
translations.yaml file
- Add your translations using the format:
Original Text: Translation
- Save the file and restart the game
Translation Example
The system supports two YAML file formats. You can use either format:
Flat Format (Simple, backward-compatible)
# English to Chinese
Graphics Settings: 图形设置
Master Volume: 主音量
Enable Shadows: 启用阴影
# English to Japanese
Graphics Settings: グラフィック設定
Master Volume: マスターボリューム
Enable Shadows: シャドウを有効にする
# English to Korean
Graphics Settings: 그래픽 설정
Master Volume: 마스터 볼륨
Enable Shadows: 그림자 활성화
# English to French
Graphics Settings: Paramètres graphiques
Master Volume: Volume principal
Enable Shadows: Activer les ombres
# English to Spanish
Graphics Settings: Configuración de gráficos
Master Volume: Volumen principal
Enable Shadows: Habilitar sombras
# English to German
Graphics Settings: Grafik-Einstellungen
Master Volume: Hauptlautstärke
Enable Shadows: Schatten aktivieren
# English to Russian
Graphics Settings: Настройки графики
Master Volume: Основная громкость
Enable Shadows: Включить тени
Nested Format (Grouped by mod GUID, recommended for large projects)
# Grouped by mod GUID for better organization
com.example.mod1:
"Graphics Settings": "图形设置"
"Master Volume": "主音量"
"Enable Shadows": "启用阴影"
com.example.mod2:
"Graphics Settings": "グラフィック設定"
"Master Volume": "マスターボリューム"
"Enable Shadows": "シャドウを有効にする"
com.example.mod3:
"Graphics Settings": "그래픽 설정"
"Master Volume": "마스터 볼륨"
"Enable Shadows": "그림자 활성화"
com.example.mod4:
"Graphics Settings": "Paramètres graphiques"
"Master Volume": "Volume principal"
"Enable Shadows": "Activer les ombres"
com.example.mod5:
"Graphics Settings": "Configuración de gráficos"
"Master Volume": "Volumen principal"
"Enable Shadows": "Habilitar sombras"
com.example.mod6:
"Graphics Settings": "Grafik-Einstellungen"
"Master Volume": "Hauptlautstärke"
"Enable Shadows": "Schatten aktivieren"
com.example.mod7:
"Graphics Settings": "Настройки графики"
"Master Volume": "Основная громкость"
"Enable Shadows": "Включить тени"
💡 Tip: The system automatically detects and loads both formats. Use nested format for better organization when managing translations for multiple mods.
When Installing New Mods
- New mod text is automatically added to collection files
- Simply add translations for new content in your translation file
- Save and restart the game to apply changes
⚙️ Configuration
You can configure the mod behavior by editing .com.HsgtLgt.autolocalization.cfg in BepInEx/config/:
Collection Feature Toggle
[Collection]
# Enable or disable the collection feature
# true = Enable collection (collects untranslated content)
# false = Disable collection (only applies existing translations, improves startup speed)
EnableCollection = true
When to disable collection:
- ✅ All translations are complete
- ✅ You want faster game startup
- ✅ You only need to apply existing translations
When to enable collection:
- ✅ You're still adding new translations
- ✅ You want to discover new untranslated content from mods
- ✅ You're actively working on translations
💡 Tip: After completing your translations, set EnableCollection = false to improve game startup performance.
❓ Frequently Asked Questions
Q: Translations aren't showing up. What should I do?
- Make sure original text in translation file matches exactly
- Check mod loading order
- Restart the game for translations to take effect
- Confirm files are saved in the correct location
Q: How can I confirm the mod is working properly?
Check your game log files and search for "Autolocalization" related information to see the operational status.
🎉 Start Enjoying Native Language Reading!
Install now and let all mods communicate with you in your most comfortable language!
"Finally, I can navigate through menus in my native language!" - Satisfied User
📞 Need Help?
Join our community:
Let language no longer be a barrier to your gaming experience!
🔧 For Mod Developers
Your mod will be automatically supported! This engine works with standard BepInEx configuration systems. No additional setup required from mod authors.
Enjoy your personalized gaming experience! 🎮
