AI Localization

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 Mod Manager (dependencies install automatically)

Manual install:

• Install the packages listed under Dependencies below
• Put only AI Localization.dll into BepInEx/plugins
• 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

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

[1. 數據收集]

啓用收集 = true

[4. AI 翻譯]

啓用AI翻譯 = false

• Start the game, wait until collection finishes, quit
• Open BepInEx/config/AI_Localization/AI_Locale_Export.yaml
• Copy it and rename the copy to AI_Locale_Translation.yaml
• Edit only the text on the right of the colon; do not change GUID / section / left-hand keys
• 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
• 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

• Launch once with collection enabled — new originals appear in the export
• Add the new lines to your translation file
• 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:

[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?

• Confirm you edited AI_Locale_Translation.yaml (or the match