DualSub 双语字幕，助力语言学习

================================================================
漫威蜘蛛侠：重制版 - DualSub 双字幕 v1.0
让整个游戏同时显示两种语言，专为边玩游戏边学习语言的人设计

游戏中每个人说的每句话，字幕下方都会实时显示第二语言：

你真的想帮忙吗？（中文）
Du möchtest wirklich helfen?（德语）

前往时代广场，听起来他的人正试图阻止我的后援到达现场……
Dann auf zum Times Square. Wie's aussieht, halten seine Männer meinen Nachschub auf ...

这两个部分会在整句台词中始终同步显示。长段台词会像游戏原本那样分段逐句浮现，翻译也会随之逐句跟进，而不是一次性显示一大段文字。

任务目标、教程弹窗、背包物品以及你收集的文件也同样支持双字幕。

你可以选择两种语言，游戏自带的 21 种语言中任意一种都可以作为主语言或副语言——总共 420 种组合。

你还可以选择多少内容被双化，从仅口语字幕一直到菜单界面。安装程序会记住你的选择。

本模组本身不包含任何游戏文本。《漫威蜘蛛侠：重制版》为所有玩家安装了全部 21 种语言，因此安装程序会读取你自己的游戏文件，并在你的 PC 上构建双语言文本。这就是为什么下载文件只有几十 KB 而非数百 MB，为什么所有组合都可用，以及为什么游戏更新后它仍然有效——你只需重新运行一次即可。

---------------- 开始之前 ------------------------------

你需要安装 Python。它是免费的、安全的，由 python.org 提供，只需安装一次：

Windows https://www.python.org/downloads/ -> 点击那个大黄色 "Download Python" 按钮。在安装程序中，务必勾选 "Add python.exe to PATH" 选项，然后再点击 Install。

Steam Deck / Linux 你系统里已经有了。

你需要在游戏所在的硬盘上留有约 20 MB 的可用空间。

安装前请关闭游戏。游戏在启动时只会读取一次其文件列表，所以在游戏运行时更改其文件不会有什么好处。

---------------- 安装 ---------------------------------------

1. 将 dualsub_installer.py 放在任何你喜欢的位置。桌面就很好。 它不需要放在游戏文件夹里，放里面也没关系。

2. 运行它。

   Windows 双击 dualsub_installer.py

         如果双击打开的是记事本而非黑色窗口，请右键点击该文件 -> 打开方式 -> Python。
   
         如果出现蓝色的 "Windows protected your PC" 提示框，那是 SmartScreen 还不认识 Python：点击 更多信息 -> 仍要运行。
   

   Linux / Steam Deck 在该文件夹中打开终端并运行 python3 dualsub_installer.py

3. 它会显示它找到的游戏文件夹。按 Enter 接受，或粘贴正确的路径。

   游戏文件夹是包含 Spider-Man.exe 的文件夹。在 Steam 中，右键点击游戏 -> 管理 -> 浏览本地文件。

4. 选择你游玩时使用的语言。这是你已经熟悉的语言，并会显示在上方。

5. 选择你正在学习的语言。这是会显示在下方的语言。

6. 勾选你想要双化的内容，或直接按 Enter 使用合理的默认设置。

7. 它会准确显示它将要执行的操作。按 y 确认。

这需要几秒钟。它会告诉你它合并了多少行文本——通常一对语言组合大约有 34,000 行。

---------------- 设置游戏语言 --------------------------------

启动游戏，确保其文本语言设置为你在第 4 步中选择的游玩语言。

选项 -> 设置 -> 语言

如果它已经设置为该语言，请切换到其他语言再切回来。游戏会缓存其文本，切换语言会使其读取新的文件。

本模组不会改变游戏的音频语言。如果你想用另一种语言听、用另一种语言读，可以在同一个菜单中单独设置音频语言——这是正常的游戏功能，与本模组完全不冲突。

---------------- 卸载 -----------------------------------------

再次运行 dualsub_installer.py 并按 R 键。

它会恢复游戏自带的文件列表，删除它添加的一个文件，并检查结果。不会有任何残留。

如果你想手动卸载：在游戏的 asset_archive 文件夹中，将 toc.dualsub-bak 复制回 toc，然后删除 toc.dualsub-bak 和 g00s046。通过 Steam 验证游戏文件完整性也可以。

---------------- 哪些语言组合可用 ----------------------------

全部 21 种语言，任意顺序，双向均可。共 420 种组合：

English（英语） French（法语） Japanese（日语） Portuguese (Brazil)（葡萄牙语（巴西）） Czech（捷克语） German（德语） Korean（韩语） Russian（俄语） Danish（丹麦语） Greek（希腊语） Norwegian（挪威语） Spanish（西班牙语） Dutch（荷兰语） Hungarian（匈牙利语） Polish（波兰语） Spanish (Lat. Am.)（西班牙语（拉丁美洲）） Finnish（芬兰语） Italian（意大利语） Portuguese（葡萄牙语） Swedish（瑞典语） Chinese (Traditional)（中文（繁体））

游戏的字库为所有语言共享，而不是在切换语言时更换，因此包含两种字母的台词——例如英语在上、日语在下，或希腊语在上、俄语在下——会使用游戏已经使用的字体进行绘制。英语与德语组合已在屏幕上逐行检查；其他组合的构建方式完全相同。

游戏还有一个阿拉伯语设置，但其背后的文本是英语，因此不提供作为第二语言。

并非每行文本在所有语言中都存在。大约 2,600 行文本——主要是警用无线电和人群喊叫——仅以英语录制，从未本地化，游戏为其他语言存储的对应内容为空。这些行将仅以一种语言显示。从游戏外部对此无能为力。

---------------- 哪些内容会被双化 ---------------------------

口语字幕 默认开启 ~31,400 行 所有角色的说话内容：过场动画、电话通话、荡秋千时的闲聊、罪犯的喊叫。

任务目标 默认开启 ~1,300 行 右上角的追踪器、任务简报和支线任务描述。任务标题用斜杠连接而非换行，因为追踪器在单行内显示它们："Clearing the Way / Den Weg frei machen"。

教程与提示 默认开启 ~1,100 行 教你操作技巧的弹窗、提示、招式列表。

文件与收集品 默认开启 ~500 行 背包物品、你找到的文件、地标介绍。

社交媒体动态 默认关闭 游戏内的社交动态和角色介绍。默认关闭是因为这些面板是固定高度且没有滚动条，双语言内容会被底部截断。如果你不介意被截断，可以开启它。

菜单与设置 默认关闭 选项名称及其描述。默认关闭是因为菜单标签很短，布局紧凑。

人名、地名、服装、装置、奖杯、按键提示和制作人员名单永不双化。双化名称不会带来任何信息，只会让屏幕更拥挤。

---------------- 需要了解的信息 ----------------------------------

它写入什么 两个文件，均在游戏的 asset_archive 文件夹中：

  g00s046            合并后的文本文件，约 8 MB
  toc                游戏的文件列表，其中三个数字被修改，使其指向新文件

在更改任何内容之前，它会将原始文件列表复制到 toc.dualsub-bak，并且之后绝不会再修改该副本。卸载模组就是恢复它。

你机器上的其他任何内容都不会被更改。不写入注册表，不修改其他文件夹，游戏目录之外不写入任何文件。

你的存档 不受影响。本模组仅更改显示的文本。你可以随时安装、卸载或在游戏中途切换语言，次数不限。

成就 不受影响。

游戏更新后 更新会替换游戏的文件列表，从而移除模组。再次运行安装程序并按 I 键。如果更新留下了备份文件，先卸载再安装。

在线 本模组从不使用网络。它只读取游戏自身的文件，并仅在其旁边写入两个文件。仅此而已。

模组管理器 不要通过 Vortex 或 Mod Organizer 安装本模组。它不是可直接替换的文件——它必须读取你的游戏副本并构建文本。请直接运行它。

---------------- 如果出现问题怎么办 ----------------------------

"它说这不是游戏文件夹" 你指向了错误的位置。它需要包含 Spider-Man.exe 的文件夹，而不是其上级的 Steam 文件夹，也不是其内部的 asset_archive 文件夹。

"双击打开的是记事本" 右键点击 dualsub_installer.py -> 打开方式 -> Python。

"无法写入 ..." 游戏仍在运行，或者游戏位于 Program Files 目录下。关闭游戏。如果它在 Program Files 下，请以管理员身份打开命令窗口，并从那里启动安装程序。

"游戏仍然只显示一种语言" 其文本语言未设置为你在第 4 步中选择的游玩语言，或者游戏已缓存了该语言。将语言切换到其他语言再切回来。

"安装后游戏无法启动" 卸载模组——运行安装程序并按 R 键。如果这不起作用，请通过 Steam 验证游戏文件，这会恢复原始文件列表，然后从游戏文件夹中删除 .spiderman_dualsub.json。

"某行只显示一种语言" 游戏中某些行从未被翻译，有些行在两种语言中完全相同。安装程序完成时会告诉你各有多少。

"某些文字出现 屏幕截断" 这是一个本模组尚未处理的界面组件。请在模组页面报告，附上截图并说明你选择的两种语言——这正是现有已处理组件被发现的方式。

其他任何问题：再次运行安装程序，如果崩溃，它会在自身旁边写入 dualsub-error.log。请将其发布在模组页面上。

---------------- DualSub 项目与支持 ----------------------------- DualSub 的最终目标是通过将双语字幕作为标准功能，打破游戏中的语言障碍。电子游戏是学习新语言最具吸引力、最有效的方式之一，本项目的存在就是为了让每个人的这段旅程顺畅、易得且充满乐趣。

由于每个游戏引擎处理文本的方式不同，每个游戏都需要专门的逆向工程。创建新的解析器意味着我需要实际接触游戏本身，以便在本地测试其文件结构。

如果你相信这个使命，并希望帮助将 DualSub 带到更多游戏：

• 在 "帖子" 标签页中留言请求，让我知道你想用哪些游戏来学习。
• 非常欢迎通过上方官方的 "捐赠" 按钮（PayPal）进行直接捐赠。

每一笔贡献都会直接用于购买新游戏和资助开发工具。虽然支持有助于决定接下来优先研究哪些游戏，但请记住，无法保证未来一定会有新移植；这完全取决于技术可行性和可用时间。请放心，每个 DualSub 模组将始终对所有人 100% 免费。

非常感谢每一位下载、分享和使用本模组学习的人。无论你是在精通第二语言还是在磨练第三语言，你的支持和反馈都让整个项目变得有价值！