Autolocalization

---

✨ 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

1. Download the mod file
2. Extract to your game's BepInEx/plugins folder
3. Start the game
4. 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

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

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

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

---

⚙️ 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?

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

---