S.T.A.L.K.E.R. 2 MOD本地化修补器

S.T.A.L.K.E.R. 2 MOD本地化修补器

这个程序让使用新的模组本地化系统变得更简单。

S.T.A.L.K.E.R. 2 MOD本地化修补器预览查看大图

该程序及其描述均由 AI 完全创建。

S.T.A.L.K.E.R. 2 模组本地化补丁工具

描述

S.T.A.L.K.E.R. 2 模组本地化补丁工具是一款一体化自动化图形界面工具，专为模组制作者和本地化人员设计。

在虚幻引擎 5.5（IOStore / Zen 格式）中进行模组本地化传统上非常繁琐——需要手动提取、检查二进制结构、编辑复杂的原始导出数据并重新打包。此工具将整个过程简化为简洁直观的 6 步工作流程。它会自动从任何目标模组中提取 LocalizationDatabase.uasset，将文本字符串导出为可编辑的 JSON 文件，将您的翻译安全地注入二进制包，并重新打包可供游戏使用的模组。

主要功能

  • 简易 6 步工作流程： 引导您从加密的 .utoc 模组文件无缝地完成到完全翻译并重新打包的模组。
  • 安全的二进制字符串注入： 正确处理虚幻引擎的 FString 编码（UTF-8 / UTF-16LE），并自动校准 .uasset 内部的 SerialSize 和 SerialOffset，以防止资源损坏或游戏崩溃。
  • 非破坏性文件夹暂存： 您的原始文件绝不会被覆盖。所有内容都会被整齐地组织到编号的子文件夹中：
    • 0_temp_input - 提取工作区
    • 1_extracted_legacy - 模组提取资源的干净备份
    • 2_json_data - 结构 JSON 和可编辑的翻译文件
    • 3_patched_legacy - 安全应用补丁的克隆目录
    • 4_repacked_mod - 最终、可直接用于游戏的 .pak、.utoc 和 .ucas 输出
  • 现代且清晰的界面： 通过高 DPI 缩放、清晰的排版（Segoe UI）以及干净的等宽控制台字体（Consolas）进行了优化，并增强了行间距，便于日志跟踪。
  • 便携式自动保存： 自动将您的工具路径和目录保存到同一文件夹下的本地 stalker2_patcher_settings.json 文件中。

系统要求

要使用此工具，您的系统上必须准备好以下工具和游戏文件：

  1. Python 3.10+ （如果通过 .py 脚本运行）
  2. retoc.exe： UE5 IOStore/Zen 重新打包工具
  3. UAssetGUI.exe： 用于将包结构解析并导出为 JSON
  4. Mappings.usmap： S.T.A.L.K.E.R. 2: Heart of Chornobyl 的结构映射文件（UAssetGUI 需要）
  5. 游戏 Paks 目录： 包含游戏原始 global.utoc 和 global.ucas 文件的文件夹（例如 Stalker2/Content/Paks）
  6. 目标模组： 您要本地化的模组的原始 .utoc 文件

更改目标语言（如何使用其他语言）

该工具会为脚本内定义的特定语言 ID 提取和修补字符串。 如果您想将模组翻译成英语以外的语言（例如，韩语、德语、法语等），您可以轻松更改目标语言：

  1. 使用任何文本编辑器（记事本、VS Code、Notepad++）打开 stalker2_mod_localization_patcher_EN.py。
  2. 在靠近顶部（大约第 23 行）查找：
    TARGET_LANGUAGE_ID = 4  # English (Default)
  3. 将数字 4 更改为您想要的语言 ID：
    0  = Arabic
1  = ChineseSimplified
2  = ChineseTraditional
3  = Czech
4  = English
5  = French
6  = German
7  = Italian
8  = Japanese
9  = Korean
10 = Polish
11 = PortugalBrazilian
12 = Russian
13 = Serbian
14 = SpanishEuropean
15 = SpanishLatinoAmerican
16 = Turkish
17 = Ukrainian
  4. 更改语言后，保存文件并运行应用程序。该工具现在将针对该特定语言导出和注入字符串！

安装说明

1. 设置

  1. 下载该工具并将其解压到您选择的任何文件夹。
  2. 启动应用程序（运行可执行文件或执行 stalker2_mod_localization_patcher_EN.py）。
  3. 在 工具与路径设置 下，点击 浏览 指向：
    • retoc.exe
    • UAssetGUI.exe
    • Mappings.usmap
    • 您游戏的 Paks 目录
    • 您要翻译的模组的 .utoc 文件
    • 一个空的 工作目录，将在其中创建所有处理文件夹

2. 如何本地化

只需按照 自动化工作流程 中的按钮从左到右操作：

  1. 检查模组： 验证该模组是否包含有效的 LocalizationDatabase.uasset。
  2. 提取旧版文件： 将模组文件提取到 1_extracted_legacy。
  3. 生成 JSON： 使用 UAssetGUI 生成结构 JSON。
  4. 导出翻译 JSON： 将字符串 ID (SID) 和文本值提取到 2_json_data 中的可编辑 JSON 文件。
  5. 翻译： 使用任何文本编辑器（VS Code、Notepad++ 等）打开导出的 JSON 文件，编辑您的翻译并保存。
  6. 应用补丁： 读取您翻译后的 JSON，并将补丁安全地应用到 3_patched_legacy 中的二进制文件。
  7. 重新打包 Zen（最终）： 将文件重新打包为位于 4_repacked_mod 中的最终 .pak、.utoc 和 .ucas 文件。
  8. 将 4_repacked_mod 中生成的文件复制到您游戏的 ~mods 文件夹中，尽情享受吧！

致谢

特别感谢 doomgiver24 开创并设计了修补 S.T.A.L.K.E.R. 2 本地化数据库所需的核心逆向工程方法和结构工作流程。

Nexus Mods - S.T.A.L.K.E.R. 2 本地化数据库逆向工程