✨ What This Mod Does For You

• 🎯 Native Language Experience - Convert all mod interfaces 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

🎯 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

1. Download the mod file
2. Extract to your game's BepInEx/plugins folder
3. Start the game
4. Begin enjoying automatic localization services!

⚠️ Important: For best results, load this mod as your first plugin

🛠️ How to Use

First Time Setup

1. Start the game - the mod begins working automatically
2. Find generated files in BepInEx/config/Autolocalization
3. Open the translations.yaml file
4. Add your translations using the format: Original Text: Translation
5. Save the file and restart the game

Translation Example

# 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: Включить тени

When Installing New Mods

1. New mod text is automatically added to collection files
2. Simply add translations for new content in your translation file
3. Save and restart the game to apply changes

❓ Frequently Asked Questions

Q: Translations aren't showing up. What should I do?

1. Make sure original text in translation file matches exactly
2. Check mod loading order
3. Restart the game for translations to take effect
4. 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!

📞 Need Help?

Join our community:

• QQ Group: 157845336, 524660884
• Discord: https://discord.gg/kC934fnT2p

🔧 For Mod Developers

Your mod will be automatically supported! This engine works with standard BepInEx configuration systems. No additional setup required from mod authors.

📜 Changelog

v1.5.2

• 🔧 Fixed Translation File Loading - System now correctly recognizes and loads user-provided translation files

v1.5.0

• Complete core architecture rebuild
• New high-performance caching system
• Improved file management and user experience
• Optimized translation workflow

📜 Changelog

v1.5.6

• 🔧 Translation Key Conflict Detection - Added automatic detection and resolution for translation key conflicts:
  • System automatically detects when multiple original texts are translated to the same key
  • Automatically generates unique suffixes based on MD5 hash to prevent duplicate key errors
  • Prevents BepInEx configuration errors caused by duplicate keys
• ✅ Translation Validation Mechanism - Enhanced translation validation to ensure compliance with BepInEx requirements:
  • Validates that translated text does not contain invalid characters (=, \n, \t, , ", ', [, ])
  • Ensures translated text has no leading or trailing spaces
  • Automatically removes invalid translations to prevent mod crashes
• 🔄 Fixed Translation File Merging - Fixed issue where translation files were automatically merged during secondary collection:
  • Translation files now correctly merge without data loss
  • Improved file merging logic to handle multiple translation sources (translations.yaml and collected_items.yaml)
  • Added persistent group memory to maintain grouping stability across file saves
  • Note: This fix only affects grouping metadata, not user-provided translation text in translations.yaml
• 🛡️ Enhanced Exception Handling - Optimized exception handling in configuration and GUID mapping stages:
  • Improved exception detection and handling during ConfigEntry/ConfigDefinition processing
  • Better error recovery and logging when building GUID mappings
  • Prevents crashes caused by unhandled exceptions in configuration processing

v1.5.5

• 📝 YAML File Format Documentation Update - Translation files now support two formats:
  • Nested format: Grouped by mod GUID for easier management and organization of translation content
  • Flat format: A simple backward-compatible format suitable for small-scale translations
  • The system automatically recognizes and loads both formats, users can choose according to their needs
• ⚙️ New Collection Feature Toggle Configuration - Added [Collection] configuration section in .com.HsgtLgt.autolocalization.cfg:
  • EnableCollection: Controls whether to enable the collection feature
  • After translation is complete, the collection feature can be disabled to improve game startup speed
  • When disabled, the system only applies existing translations and no longer collects new content

v1.5.4

• 🎨 Updated Icons - Improved visual design and user interface with new icons
• 📝 Updated MD Content - Enhanced documentation and markdown files for better readability and user guidance

v1.5.2

• 🔧 Fixed Translation File Loading - System now correctly recognizes and loads user-provided translation files

v1.5.0

• Complete core architecture rebuild
• New high-performance caching system
• Improved file management and user experience
• Optimized translation workflow