DualSub 双语字幕助力语言学习

================================================================
侠盗猎车手 IV - 双语字幕（DualSub） v1.0
屏幕上同时显示两种语言的字幕
================================================================

每句对话台词都会在下方多出一行第二种语言的翻译。专为在游戏中学习语言的人设计。

两种语言都由你选择：

第一行 游戏本身设定的语言
第二行 你正在学习的语言

支持七种语言、42种组合，并且涵盖全部三个故事：
自由城之章、失落与诅咒、夜生活之曲。

所有语言均已随游戏自带。本下载中不包含任何捆绑内容，也不含任何游戏文本。


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

你需要安装Python。它是免费的，可从python.org获取，只需安装一次：

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

LINUX 你几乎肯定已经安装了Python。如果没有：
Ubuntu / Debian / Mint sudo apt install python3
Fedora / Nobara sudo dnf install python3
Arch / CachyOS sudo pacman -S python
Steam Deck 已自带Python - 请使用桌面模式。

此模组仅为一个Python文件。它不会下载或安装任何内容到你的电脑上。它所做的只是修改游戏自身的文件，并且可以将其完全恢复到原始状态。

仅此而已。无需OpenIV、无需脚本钩子、无需模组管理器或任何其他工具。GTA IV将文本存储在纯文本文件中，此模组直接编辑这些文件，编辑前会先为每个文件保留一份副本。


---------------- 安装步骤 ----------------------------------------

1. 关闭游戏及其启动器。

2. 将此下载文件解压到一个你能再次找到的位置。请将所有文件放在一起。

3. 在该文件夹内打开一个命令窗口：

WINDOWS 点击文件夹窗口顶部的白色地址栏，输入 cmd 并按回车键。
LINUX 在文件夹内右键点击 -> "Open Terminal Here" (在此处打开终端)。

4. 输入以下命令并按回车键：

WINDOWS python dualsub_installer.py
LINUX python3 dualsub_installer.py

5. 仅第一次运行时，它会询问游戏的位置。粘贴包含GTAIV.exe的文件夹路径 - 或者将该文件夹拖拽到命令窗口中。通常它能自行找到游戏。

6. 回答三个问题：你玩哪个语言版本，你想学习哪种语言，以及第二语言应显示在哪里。按回车键即可使用默认设置。

7. 启动游戏。在游戏选项中，将语言设置为你在第一行选择的那个语言。这样才能加载此模组的文本。

如果WINDOWS提示无法写入游戏文件，说明游戏位于Program Files目录下，需要管理员权限：

* 点击开始菜单，输入 cmd
* 右键点击“命令提示符” -> “以管理员身份运行”
* 输入 cd /d 加一个空格，然后将解压后的文件夹拖拽到窗口中，按回车键
* 然后执行： python dualsub_installer.py

游戏安装在非系统盘通常不需要这些步骤。


---------------- 卸载步骤 ----------------------------------------

以同样的方式再次运行安装程序，然后按 R 键。

它会将所有文件完全恢复原状，并删除自身的记录。如果安装后其他程序修改了其中某个文件，它会保留该文件不动，并告知你具体是哪一个。


---------------- 第二语言显示设置 ---------------------------------

步骤3列出了游戏的各个部分。每个部分都可以设置为以下三种状态之一：

both 你玩的游戏语言，并显示第二语言在下方
only 仅显示第二语言，替换第一语言
off 保持游戏原始设定

输入数字键循环切换该行状态：both -> only -> off -> both。

默认有两项设置为“both”：

* 人物对话字幕 - 对话下的字幕
* 任务文本 - 简报、回复、电话

默认有一项设置为“off”：

* 菜单和名称 - 车辆名称、武器、电台、菜单

此项默认关闭是有原因的。这些文件中的键是数字标识符，并非名称，因此文件内部无法区分哪些条目是车辆名称，哪些是文本描述。如果开启，两者都会加倍显示，而HUD上出现重复的车辆名称可不是大家想要的。


---------------- 单语言而不是双语言 ---------------------------------

有时你不需要两行字幕，而是希望游戏以英语运行——语音、菜单、物品名称——但字幕仅以德语显示，用于那些你无法听清的少数台词。

将对话部分设置为“only”，其余部分保持“both”。这样你就能在英文对话下看到德语单行字幕，没有重复内容，而任务日志和信件仍然显示双语，只要空间允许。

此设置是逐部分决定的，且默认不采用。游戏中本来就未翻译的台词，会保留为你游戏的语言而非留空。


---------------- 游戏未自带的语言 ---------------------------------

GTA IV的翻译模组是一个.gxt文件，你将其放入 common\text 文件夹。任何已存在的.gxt文件都会与游戏自带的七种语言一起出现在菜单中：

土耳其语 - 来自 turkish.gxt

将其选为你正在学习的语言，或你游戏的语言。两种方向均可，也支持“only”模式。

这些文本完全按照其作者编写的内容使用，并且只有你游戏语言对应的文件会被写入。请务必感谢你阅读的翻译作者——第二行内容是他们的作品。

许多GTA IV翻译模组会覆盖游戏自带的七种语言之一（通常是american.gxt），而不是新增第八种语言。如果你的翻译模组如此操作，请在游戏中将语言选项设置为被它替换的那个语言。


---------------- 温馨提示 ----------------------------------

* 一次只能启用一种语言组合，选择新的组合将替换旧的。
* 三个故事同时支持，只要游戏中两个语言都存在。日语仅存在于主线游戏中，因此选择日语时，两个资料片将保持原始状态。
* 只有你游戏语言对应的文件会被写入，其他所有语言文件都保持原样。
* 菜单、选项和HUD会刻意保持单语，以确保可读性。只有对话和故事文本会双语显示。
* 某些台词并未被翻译成某些语言——游戏中根本没有对应条目。这些内容将保持原样而不是重复显示。
* 没有Python？安装程序会提示并引导你访问python.org。此下载中的任何内容都不会从互联网获取任何数据。


---------------- 问题排查 ---------------------------

"python is not recognized" (Windows系统)
Python未安装，或未勾选“Add python.exe to PATH”选项。请重新安装并勾选该选项，然后关闭并重新打开命令窗口。

Windows阻止写入游戏文件
游戏或其启动器仍在运行 - 请先关闭 - 或者命令窗口未以管理员身份启动。请参阅安装部分的结尾说明。

双击文件时打开了编辑器
Python未关联.py文件。请在文件夹中打开命令窗口并输入步骤4中的命令。

"That folder does not hold GTAIV.exe"
请提供游戏自身的安装文件夹，而不是其父文件夹或启动器的文件夹。打开该文件夹，点击地址栏，复制路径并粘贴进去。

游戏启动但没有双语字幕
游戏的语言设置与你选择的第一行语言不一致。请在游戏选项中更改。如果你将某部分设置为“only”，则该部分不会有双语显示。

第二语言显示为方块
该语言需要游戏中没有的字体。这种情况只可能发生在其他模组添加的语言中。请查看该模组页面，安装所需的配套字体。

游戏更新后文本显示异常
验证游戏文件完整性，然后重新运行安装程序。

字幕底部显示不全
两种语言占用两倍空间。将对话部分设置为“only”而非“both” - 这样你将以单行形式显示第二语言，替换第一语言。

其他问题
安装程序旁边会出现一个名为 dualsub-error.log 的文件。请将其附加到模组页面的帖子中。


---------------- DUALSUB 项目与支持 -----------------

DualSub的目标是通过将双语字幕设为标准功能，打破游戏中的语言障碍。游戏是学习语言最有效的方式之一，本项目的存在就是为了让这一过程顺畅、便捷且充满乐趣。

每个游戏引擎处理文本的方式都不同，因此每个游戏都需要单独的逆向工程——这意味着需要亲自动手访问游戏，在本地测试其文件结构。

如果你想帮助DualSub支持更多游戏：
- 在“帖子”标签页中留下请求，让我知道你想通过哪些游戏学习语言。
- 也可以点击上方的“捐赠”按钮给予支持，不胜感激。

每一份贡献都将用于购买新游戏和开发工具。您的支持将帮助决定下一个研究的游戏优先级，但无法保证一定能推出未来的移植版本——这取决于技术可行性和时间。所有DualSub模组都将永远保持100%免费。

感谢所有下载、分享并使用此模组学习语言的人。无论你是在掌握第二语言还是润色第三语言，您的支持都让整个项目变得有意义。