AI Localization

Make other mods' config text display in your preferred language

Successor to the deprecated Autolocalization.
Uninstall Autolocalization first. Do not mix with the old translations.yaml.

---

✨ What it does

• 🎯 Native config UI — show other mods' sections / option names / descriptions in your language
• 🔄 Auto collect — scan installed mods for config text that needs translation
• 📝 Edit YAML by hand — same idea as the old mod (no API required)
• 🤖 Optional AI — DeepSeek can draft translations (bring your own key; you pay DeepSeek)
• 🌐 Languages — Chinese / English / 日本語 / Deutsch, and more
• 🛡 Exemptions — skip entries you do not want translated

---

🎯 How it works

Step 1: Auto scan

On launch, the mod collects config text from other mods.

Step 2: Two files

Folder: BepInEx/config/AI_Localization/

• 📄 AI_Locale_Export.yaml — originals (collection result)
• 📄 AI_Locale_Translation.yaml — translations (you edit, or let AI fill)

Step 3: Land it and enjoy

After the translation file is ready, delete those mods' .cfg files, then start the game again. The config UI will show your translations.

---

📥 Install

Recommended: r2modman / Thunderstore Mod Manager (dependencies install automatically)

Manual install:

1. Install the packages listed under Dependencies below
2. Put only AI Localization.dll into BepInEx/plugins
3. Launch the game once, then quit (generates config)

This mod's config (key names are Chinese):

BepInEx/config/.com.HsgtLgt.AI_Localization.cfg

---

🛠️ How to use (manual — main path)

First time

1. Open the config. Keep collection on, AI off:

[1. 数据收集]
启用收集 = true

[4. AI 翻译]
启用AI翻译 = false

1. Start the game, wait until collection finishes, quit
2. Open BepInEx/config/AI_Localization/AI_Locale_Export.yaml
3. Copy it and rename the copy to AI_Locale_Translation.yaml
4. Edit only the text on the right of the colon; do not change GUID / section / left-hand keys
5. Quit the game, then in BepInEx/config/ delete the .cfg files of the mods you translated
   • Do not delete: .com.HsgtLgt.AI_Localization.cfg
   • Do not delete: YAML files under the AI_Localization folder
   • Note: those mods' settings reset to defaults — back up important values first
6. Start the game again — translations apply

Translation format example (grouped by mod GUID)

com.example.mod1:
  Graphics:
    Graphics: 图形
    Master Volume: 主音量
    Enable Shadows: 启用阴影

com.example.mod2:
  Graphics:
    Graphics: グラフィック
    Master Volume: マスターボリューム
    Enable Shadows: シャドウを有効にする

💡 Easiest: copy AI_Locale_Export.yaml to the translation file, then change the right-hand values.

After installing new mods

1. Launch once with collection enabled — new originals appear in the export
2. Add the new lines to your translation file
3. Delete those new mods' .cfg files, then start again

---

⚙️ Configuration

Edit: BepInEx/config/.com.HsgtLgt.AI_Localization.cfg

Collection toggle

[1. 数据收集]
启用收集 = true

You can turn collection off when:

• ✅ Translations are complete
• ✅ You only want to apply existing translations and do less work at startup

Keep collection on when:

• ✅ You are still translating
• ✅ You installed new mods and need fresh originals

💡 When translations are stable, set 启用收集 = false.

Exemptions (optional)

[2. 翻译豁免]
豁免名单 = Some.Mod.GUID|Some Section|*, *|*|Lock Configuration

Format: GUID|Section|Key, * wildcards, comma-separated rules.

---

🤖 Optional: AI draft

Only if you do not want to type by hand. DeepSeek key: https://platform.deepseek.com/api_keys

[4. AI 翻译]
API密钥 = your-key
启用AI翻译 = true
AI模型 = deepseek-v4-flash
目标语言 = English
吞吐参数 = 12|200

• 目标语言: 中文（简体） / English / 日本語 / Deutsch (or zh / en / ja / de)
• Non-Chinese files: AI_Locale_Translation.en.yaml / .ja.yaml / .de.yaml
• Progress in log: 翻译进度：x/y 批 (= translation progress)
• After AI finishes, still do: delete those mods' .cfg → start again
• Keep 吞吐参数 at 12|200

---

📦 Dependencies

• BepInExPack Valheim
• YamlDotNet
• JsonDotNET

---

❓ FAQ

Q: Translations not showing?

1. Confirm you edited AI_Locale_Translation.yaml (or the matching language file), and left-hand keys match the export
2. Confirm you deleted those mods' .cfg files, then restarted
3. Confirm files are under BepInEx/config/AI_Localization/
4. Restart the game

Q: How do I know the mod is working?

Check BepInEx/LogOutput.log and search for AI_Localization.

Q: Settings break after I uninstall this mod?

After localization, other mods' .cfg may use translated section/key names. Back up BepInEx/config before uninstalling, or keep this mod installed.

---

📞 Need help?

• Discord: https://discord.gg/kC934fnT2p
• QQ: 524660884

When reporting bugs, attach log lines containing AI_Localization.

---

Let language no longer block your game