Universal Localization Mod / 通用本地化模组

简介 / Introduction

这是一个专为《英灵神殿》模组设计的通用本地化框架。 This is a universal localization framework designed for Valheim mods.

本模组的主要功能是为游戏中的各类模组内容提供一个便捷的本地化翻译环境。它允许翻译者轻松地本地化其他模组添加的内容。 The main function of this mod is to provide a convenient localization environment for various mod content in the game, allowing translators to easily localize content added by other mods.

功能特性 / Features

本模组支持对以下模组内容进行本地化： This mod supports the localization of the following mod content:

• 物品：武器、盔甲、材料、食物等的名称与描述（能放在背包里的东西）

  • Items: Names and descriptions of weapons, armor, materials, food, etc. (Anything that can be placed in the inventory).

• 效果：Buff、Debuff 的状态名称与描述（UI右上角显示的各种状态）

  • Status Effects: Names and descriptions of Buffs and Debuffs (various states displayed in the top-right UI corner).

• 生物：怪物、Boss 的名称

  • Creatures: Names of monsters and bosses.

• 建筑：工具锤右键界面的东西，如工作台、传送门、建筑材料等的名字和描述

  • Pieces: Names and descriptions of buildable pieces accessible via the Hammer's build menu, such as workbenches, portals, and building materials.

前置需求 / Prerequisites

• 游戏本体：《英灵神殿》（Valheim）

  • Game: Valheim

• BepInEx：Valheim 模组框架。必须安装

  • BepInEx: Valheim mod framework. Must be installed.

安装步骤 / Installation

1. 下载本模组的最新版本（.dll 文件）

   • Download the latest version of this mod (.dll file)

2. 手动安装：

   • Manual Installation:

   • 将下载的文件复制到您的 Valheim 游戏根目录下的 BepInEx/plugins 文件夹中

     • Copy the downloaded file into your Valheim game root directory under the BepInEx/plugins folder

   • 确保文件路径类似于 ...\Valheim\BepInEx\plugins\懒濑的本地化.dll

     • Ensure the file path resembles ...\Valheim\BepInEx\plugins\懒濑的本地化.dll

使用说明 / Usage

1. 首次启动：首次运行游戏后，模组会在 Valheim\BepInEx\config\mod汉化 文件夹内生成四个 .txt 文件（筛选文件）

   • First Launch: After running the game for the first time, the mod will generate four .txt files (filter files) in the Valheim\BepInEx\config\mod汉化 folder

2. 设置筛选条件：根据您想要本地化的模组内容的预制名，在相应的筛选文件中填入搜索条件。如果筛选条件为空，则会导出所有文本

   • Set Filters: Based on the prefab names of the mod content you wish to localize, fill in the search criteria in the corresponding filter files. If the filter is left empty, all text will be exported

3. 导出文本：启动游戏并加载一个世界。在游戏中按 F12 键，模组会根据您的筛选条件导出文本到新的本地化文件（同样是四个 .txt 文件）

   • Export Text: Launch the game and load a world. Press the F12 key in-game. The mod will export text based on your filters into new localization files (also four .txt files)

4. 进行本地化：打开步骤 3 中生成的本地化 .txt 文件。修改里面的 name（名称）和 description（描述）等内容进行本地化。注意：请勿修改其他信息、符号或文件结构

   • Localize: Open the localization .txt files generated in step 3. Modify the name and description fields, etc., to create your localization. Note: Do not modify other information, symbols, or the file structure

5. 生效：完成本地化后，重启游戏即可生效

   • Apply Changes: After localization is complete, restart the game for the changes to take effect

重要提示 / Important Note 筛选条件只在游戏启动时读取一次。您必须在启动游戏之前修改并保存筛选文件 Filter conditions are only read once when the game starts. You must modify and save the filter files before launching the game

简单流程 / Simple Workflow

1. 安装本模组 -> Install this mod
2. 首次启动游戏，自动创建 mod汉化 文件夹 -> First launch auto creates the mod汉化 folder
3. 进入文件夹，打开筛选文件并填入条件 -> Enter the folder, open filter files and set criteria
4. 重新启动游戏 -> Restart the game
5. 在游戏内按 F12 导出文本 -> Press F12 in-game to export text
6. 在文件夹内，对导出的文本内容进行本地化 -> Localize the content in the exported text files within the folder
7. 本地化完成后，重启游戏生效 -> Restart the game to apply the localization

文件结构 / File Structure

Valheim/ ├── BepInEx/ └── plugins/ └── 懒濑的本地化.dll └── BepInEx/ └── config/ └── mod汉化/ ├── 筛选条件_物品.txt # 物品筛选条件 / Items filter ├── 筛选条件_效果.txt # 效果筛选条件 / Effects filter ├── 筛选条件_怪物.txt # 生物筛选条件 / Creatures filter ├── 筛选条件_工具.txt # 建筑筛选条件 / Pieces filter ├── 汉化信息_物品.txt # 物品本地化文件 / Items localization ├── 汉化信息_效果.txt # 效果本地化文件 / Effects localization ├── 汉化信息_怪物.txt # 生物本地化文件 / Creatures localization └── 汉化信息_工具.txt # 建筑本地化文件 / Pieces localization

CHANGELOG

All notable changes to this project will be documented in this file.

[1.6.2]

• 修复“筛选条件.txt”不生效的问题。注：api接入翻译的格式和应用翻译的格式一致。

[1.6.1]

• 修复收集怪物文本时，重复收集引起的错误。

[1.6.0]

• 支持deepseek接入翻译，但是速度很慢。支持游戏内应用翻译。现在有配置文件了，自定义触发按键，应用翻译是否开启，api填入等。

[1.5.1]

• Adjust README.md

[1.5.0]

• English: The current exported text is the actual displayed text, making it easier to compare with the translation.

• 中文: 现在导出的文本为实际显示的文本了，可以更方便的对照翻译。

[1.4.0]

• English: Add the preposition "with Jotunn". Support the export based on the mod name as the condition. Merge the four types of screening condition files into one. Add some English instructions to the exported file to facilitate understanding.

• 中文: 加入前置 Jotunn，支持基于模组名称作为条件导出文本。合并四类筛选条件文件为一个。（注：英文描述中 “Add some English instructions to the exported file to facilitate understanding” 未对应中文，已保留原文以确保信息完整）

[1.3.2]

• Adjust README.md

[1.3.1]

• Adjust README.md

[1.3.0]

• First release