Localization

Localization is a BepInEx plugin for Valheim that translates hardcoded mod text at the final UI layer.

What it does

Patches final text assignment for TMPro.TMP_Text and UnityEngine.UI.Text.
Matches displayed strings against compiled exact and template rules.
Loads rules from BepInEx/config/com.paxton0505.localization/<LanguageCode>/*.json.
Uses English/*.json as an optional shared baseline.
Reloads when the active game language changes.

Install

Install BepInExPack_Valheim and JsonDotNET.
Install the plugin.
Launch the game once so the config folders are created.
Add JSON rule files under a language folder such as Chinese_Trad/.

Example rules

{
  "exact": [
    {
      "match": "Item is favorited and won't be stored",
      "replace": "物品已被收藏，不會被存放"
    },
    {
      "match": "Slot is favorited and won't be stored",
      "replace": "格位已被收藏，不會被存放"
    }
  ],
  "templates": [
    {
      "match": "Found {{$count}} items matching '{{$query}}' in nearby containers.",
      "replace": "在附近容器中找到 {{$count}} 個符合「{{localize($query)}}」的物品。"
    },
    {
      "match": "<color=red>No items matching '{{$query}}' found in nearby containers.</color>",
      "replace": "<color=red>在附近容器中找不到符合「{{localize($query)}}」的物品。</color>"
    },
    {
      "match": "Stored {{$total}} items from your inventory into nearby containers",
      "replace": "已將 {{$total}} 個物品從你的背包存放到附近容器中"
    },
    {
      "match": "<color=red>{{$itemName}} [{{$prefabName}}] is not in nearby containers</color>",
      "replace": "<color=red>附近容器中沒有 {{localize($itemName)}} [{{$prefabName}}]</color>"
    },
    {
      "match": "<color=red>{{$itemName}} [{{$prefabName}}] cannot be stored based on configuration settings</color>",
      "replace": "<color=red>根據設定，無法存放 {{localize($itemName)}} [{{$prefabName}}]</color>"
    },
    {
      "match": "AzuAutoStore Installed: {{$localVersion}}\n Needed: {{$remoteVersion}}",
      "replace": "已安裝 AzuAutoStore：{{$localVersion}}\n需要版本：{{$remoteVersion}}"
    }
  ]
}

Notes

English/ is optional and acts as a shared baseline.
{{localize($name)}} resolves through the plugin's exact rules first and then the game's own localization.
Unmatched text is left unchanged.

Before / After

These screenshots use local package assets, so they work in Thunderstore without external links.

Before

After

What it does

Patches final text assignment for TMPro.TMP_Text and UnityEngine.UI.Text.

Matches displayed strings against compiled exact and template rules.

Loads rules from BepInEx/config/com.paxton0505.localization/<LanguageCode>/*.json.

Uses English/*.json as an optional shared baseline.

Reloads when the active game language changes.

Example rules

{ "exact": [ { "match": "Item is favorited and won't be stored", "replace": "物品已被收藏，不會被存放" }, { "match": "Slot is favorited and won't be stored", "replace": "格位已被收藏，不會被存放" } ], "templates": [ { "match": "Found {{$count}} items matching '{{$query}}' in nearby containers.", "replace": "在附近容器中找到 {{$count}} 個符合「{{localize($query)}}」的物品。" }, { "match": "<color=red>No items matching '{{$query}}' found in nearby containers.</color>", "replace": "<color=red>在附近容器中找不到符合「{{localize($query)}}」的物品。</color>" }, { "match": "Stored {{$total}} items from your inventory into nearby containers", "replace": "已將 {{$total}} 個物品從你的背包存放到附近容器中" }, { "match": "<color=red>{{$itemName}} [{{$prefabName}}] is not in nearby containers</color>", "replace": "<color=red>附近容器中沒有 {{localize($itemName)}} [{{$prefabName}}]</color>" }, { "match": "<color=red>{{$itemName}} [{{$prefabName}}] cannot be stored based on configuration settings</color>", "replace": "<color=red>根據設定，無法存放 {{localize($itemName)}} [{{$prefabName}}]</color>" }, { "match": "AzuAutoStore Installed: {{$localVersion}}\n Needed: {{$remoteVersion}}", "replace": "已安裝 AzuAutoStore：{{$localVersion}}\n需要版本：{{$remoteVersion}}" } ] }