AI Localization

v0.1.3·Updated 2026-07-26

Make all mod interfaces display in your preferred language!

About this mod Machine translation

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. Data collection]

enable collection = true

[4. AI translation]

Enable AI translation = 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: graphics

Master Volume: master volume

Enable Shadows: Enable shadows

com.example.mod2:

Graphics:

Graphics: グラフィック

Master Volume: マスターボリューム

Enable Shadows: シャドウをeffectiveにする

💡 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. Data collection]

enable collection = 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 enable collection = false.

Exemptions (optional)

[2. Translation exemption]

Exemption list = 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 translation]

API key = your-key

enable AI translation = true

AI model = deepseek-v4-flash

Target language = English

Throughput parameter = 12|200

  • Target language: Chinese (Simplified) / English / Japanese / Deutsch (or zh / en / ja / de)
  • Non-Chinese files: AI_Locale_Translation.en.yaml.ja.yaml.de.yaml
  • Progress in log: translation progress: x/y batches (= translation progress)
  • After AI finishes, still do: delete those mods'.cfg → start agai …

Install & use Install: BepInEx plugin

  1. The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
  2. Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
  3. Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
  4. Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.

Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file. In multiplayer, the host and every client need the same mods installed.

Dependencies

Install these first, or the mod will not work:

ValheimModding-YamlDotNetValheimModding-JsonDotNETdenikson-BepInExPack_Valheim

File & checksum

Filename
AI_Localization-0.1.3.zip
File size
166.4 KiB