🚀 AutoLocalization Introduction

A game localization tool designed specifically for BepInEx mods, automatically exports configuration option text for player translation, making mod settings localization effortless!

✨ Core Features

• 🌍 One-Click Translation: Automatically detects and translates configuration option descriptions
• 🔄 Hot-Reload Compatible: No game restart needed after translation updates (takes effect in ~5 seconds)
• 📥 Smart Text Collection: Automatically collects untranslated text from new mods
• 🧠 Auto Detection: Recognizes configuration descriptions from all mods
• 📝 Simple Translation Format: Uses easy-to-edit YAML files
• 🌐 Multi-Language Support: Supports Chinese/Japanese/Korean and any other languages

---

📥 Installation Steps

1. Download the mod file
2. Extract to game root directory
3. Place Autolocalization.dll in the BepInEx/plugins folder
4. Start the game for automatic initialization

⚠️ Important Note: This mod MUST be the first loaded plugin! Plugins loaded before AutoLocalization cannot be translated

---

🛠️ User Guide

First Time Setup

1. Start the game
2. The mod will generate in BepInEx/config/AutoLocalizationEngine:
   • AutolocalizationGlobalTranslations.yaml (translation file)
   • AutolocalizationUntranslatedTexts.yaml (untranslated text)

🔧 Hot-Reload Process

1. Edit AutolocalizationGlobalTranslations.yaml to add/update translations
2. Save the file
3. Wait about 5 seconds
4. Return to game to see updates

➕ Handling New Mods

1. Install new mod and start the game
2. New text will be automatically added to AutolocalizationUntranslatedTexts.yaml
3. Copy new entries to AutolocalizationGlobalTranslations.yaml
4. Add translations and save for automatic loading

---

📝 Example YAML Format

Offset relative to the upper right corner of the inventory (side elements included): Offset from the inventory's upper right corner (including side elements)
Enabled slot obtaining progression. If disabled - all enabled slots will be available from the start. [Synced with Server]: Enable slot unlocking progression. When disabled - all slots available from start. [Synced with Server]
Main menu button caption: Main Menu Button Text
'[ServerSync] Gain XP when interacting with Pickables': '[ServerSync] Gain XP when interacting with Pickable objects'

---

❓ FAQ

Q: What to do if translations aren't working?
A:

1. Check text matching: Ensure text in translation file exactly matches untranslated text (including case/spaces/punctuation)
2. Verify load order: AutoLocalization must be the first loaded plugin
3. Check YAML syntax: Ensure no missing colons/correct indentation/valid characters
4. Wait for reload: Wait about 5 seconds after saving file
5. Confirm file location: Located in BepInEx/config/AutoLocalizationEngine/

---

📜 Changelog

v1.0.0 (2025-07-23)

• First stable release
• Added debug mode

---

❤️ Support the Developer

If this mod has improved your gaming experience:

• Please share it with more players!
• Feedback channels:
  QQ Group: 157845336
  Discord: https://discord.gg/Rb5sMKUt

Developer's Note: Thank you for using AutoLocalization! Your support drives continuous improvement