PrefabLocalizer / 通用本地化模组

简介 / 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