HearTell-AmbientVoiceSubtitles

[center]This is my only official sponsorship channel： [url=https://ifdian.net/a/HearTell]约翰·威廉姆森正在创作HearTell-AmbientVoiceSubtitles-RDR2 | 爱发电[/url] 谢谢大家，你们的赞助是我前行的动力..... [/center]
[center]=== [img]https://staticdelivery.nexusmods.com/mods/3024/images/9961/9961-1786085172-175867055.jpg[/img]===

[i]"Empty mountains: no one to be seen.
Yet - hear - human sounds echo."[/i]
[color=#8B7A55]- Wang Wei, "Deer Park", 8th century[/color]


[b][color=#B09868]DESCRIPTION[/color][/b]

Stand on a street corner in Saint Denis for one minute and you will hear a dozen conversations. Newsboys shouting headlines. A drunk cursing at nothing. Two women deciding whose husband is more worthless. Somebody haggling over a horse half a block away.

All of that audio shipped with the game. Almost none of it has subtitles.

Eight years later it still doesn't. If English is not your first language, or you simply play with subtitles on, those streets have been half mute the entire time. You knew people were talking. You never got to know what they said.

[b]HEAR TELL fills in the missing subtitles.[/b] Not as an overlay - through the game's own subtitle system.

=== [img]https://staticdelivery.nexusmods.com/mods/3024/images/9961/9961-1786085216-602219820.jpg[/img] ===

[color=#8B7A55]Two men on a bridge, warning each other about something. Eight years without a subtitle.[/color]


[b][color=#B09868]WHY IT LOOKS NATIVE[/color][/b]

The mod calls the game's own subtitle functions directly. Same torn-edge banner, same position on screen, same fade in and out, same font, same speaker-name prefix. Nothing is painted over your screen.

If you didn't know a mod was running, you would assume Rockstar shipped it.

=== [img]https://staticdelivery.nexusmods.com/mods/3024/images/9961/9961-1786085248-796280731.jpg[/img] ===

[list]
[][b]English:[/b] 269,173 lines[/]
[][b]Chinese:[/b] 364,405 lines[/]
[][b]615 voice banks[/b] covered[/]
[][b]Existing subtitles overwritten: zero.[/b] Lines that already have an official subtitle are never touched. Only the blank ones get filled.[/]
[][b]Game files modified: zero.[/b] One .lua script plus plain-text data. Uninstalling is deleting the files.[/]
[/list]

[b][color=#B09868]MAIN FEATURES[/color][/b]

[list]
[]Ambient chatter, shopkeepers, lawmen, strangers, and a great many player lines that never had subtitles[/]
[]Displays through the native subtitle system - identical style, position and timing to the official subtitles[/]
[]Speaker names come from the game itself, so they follow whatever language your game is set to[/]
[]Animal noises, breathing, coughing and other non-verbal audio deliberately stay silent. Only actual speech gets a subtitle.[/]
[]Shows you only what that specific character says. It will never put another NPC's words in their mouth.[/]
[]All subtitle text is plain text. Notepad opens it. You can fix any line you don't like.[/]
[/list]
=== [img]https://staticdelivery.nexusmods.com/mods/3024/images/9961/9961-1786085282-694118315.jpg[/img] ===


[b][color=#B09868]REQUIREMENTS[/color][/b]

Two standard script-mod prerequisites, [b]not bundled in this archive[/b]:

[list=1]
[][url=https://www.nexusmods.com/reddeadredemption2/mods/1472]ScriptHookRDR2[/url] - lets the game load external scripts[/]
[][url=https://github.com/ThirteenAG/Ultimate-ASI-Loader]Ultimate ASI Loader[/url] - provides dinput8.dll, which hooks the above into the game[/]
[/list]
If you have ever installed a script mod for RDR2, you almost certainly already have both.

Why they are not bundled: most people already have them, often at a newer version than mine, and overwriting yours can break the other script mods you have installed.

Everything else you need (RedLua.asi, lua51.dll) is included.


[b][color=#B09868]INSTALLATION[/color][/b]

[list=1]
[]Install the two prerequisites above first. Without them this mod does nothing at all.[/]
[]Drag everything in the archive into your game root folder - the one containing RDR2.exe. Say yes when asked to overwrite.[/]
[]Launch the game. Subtitles start on their own. There is nothing to press.[/]
[/list]
[b]Watch one file when overwriting: RedLua/Settings.json[/b] holds RedLua's own settings (menu hotkey, autostart). If you have customised it, back it up first and restore it afterwards.

Two downloads are available - English and Chinese. Pick one.


[b][color=#B09868]HOW TO TELL IT IS WORKING[/color][/b]

Go to Valentine and either rob a shopkeeper, or aim at a wagon driver and press E to make them stop. Both are guaranteed to produce subtitles if the script loaded. If you see them, you're set.

If you get nothing, or you want manual control, press [b]F7[/b] for the RedLua menu:

[list]
[][b]Reload:[/b] F7 > core.main.scripts > AmbientSubs.lua > core.script.rel
Autostart fails occasionally. One manual reload fixes it.[/]
[][b]Unload:[/b] F7 > core.main.scripts > AmbientSubs.lua > core.script.unl
Subtitles stop immediately.[/]
[/list]
[b]After unloading you cannot load it again in the same session[/b] - you have to restart the game. That is not a bug: while running, the script hooks into low-level game internals, and unloading cleans all of that up completely. Once cleaned up it cannot be reattached. If you only want subtitles off for a while, use the game's own subtitle setting instead.

[b]Still nothing?[/b] Check in this order:

[list=1]
[]dinput8.dll in your game root[/]
[]ScriptHookRDR2.dll in your game root[/]
[]RedLua.asi and lua51.dll (both ship in this archive)[/]
[]RedLua/Scripts/AmbientSubs.lua[/]
[]RedLua/Scripts/AmbientSubs/trans.txt[/]
[]Subtitles enabled in the game's own settings[/]
[/list]
If F7 does nothing whatsoever, it is almost always #1 or #2.


[b][color=#B09868]EDIT IT, TRANSLATE IT, BUILD ON IT[/color][/b]

Every .txt in RedLua/Scripts/AmbientSubs/ is plain text, three tab-separated columns:

[code]context name    variation number    subtitle text[/code]
Found a line that reads wrong? Edit that line, save, restart the game. That's the whole process.

[b]Want a Spanish, Portuguese, German or any other version? You have my permission in advance - you do not need to ask.[/b] Replace trans.txt wholesale and release it. The data is plain text precisely so that this is possible. A credit is nice, not required.


[b][color=#B09868]KNOWN LIMITATIONS - PLEASE READ BEFORE DOWNLOADING[/color][/b]

[list]
[]The text was produced by speech recognition plus automated correction. [b]It is not Rockstar's script and it contains errors.[/b] Some lines will read slightly off.[/]
[]A small number of lines are spoken in another language, or are too garbled to make out. Those deliberately get no subtitle. That is expected behaviour, not a gap.[/]
[]Subtitles are ASCII only. The game font has no glyphs for accented characters - they would render as empty boxes.[/]
[/list]
If a line reads wrong, you can fix it yourself in seconds. See the section above.


[b][color=#B09868]SHOUT OUTS[/color][/b]

Not one line of game code was changed. Not one game file was touched. This works because other people laid the foundation first - four pieces, each handling one link in the chain:

[list]
[][b]Ultimate ASI Loader[/b] (ThirteenAG, open source) - [i]prerequisite[/i]
Provides dinput8.dll. Loads first when the game starts, then hooks .asi plugins in. Without it, nothing downstream ever starts.[/]
[][b]ScriptHookRDR2[/b] (Rage Modding Collective) - [i]prerequisite[/i]
Gives the game the ability to load external scripts. RedLua runs on top of it.[/]
[][b]RedLua[/b] - [i]included in this archive[/i]
Open-source Lua runtime for RDR2, and the platform this mod runs on. It scans RedLua/Scripts/, runs what it finds, and provides the F7 menu. This entire mod is one .lua file - without RedLua it is just text sitting on a disk.[/]
[][b]LuaJIT 2.1.0-beta3[/b] - [i]included in this archive[/i]
The Lua implementation RedLua uses. This mod relies on its FFI capability to call the game's own subtitle functions directly. That is the entire reason these subtitles look native instead of being text drawn on top of your screen.[/]
[/list]
Thank you to these authors. They built tools so other people could build things on them. I just added a brick.


[b][color=#B09868]FINALLY[/color][/b]

15 days. Roughly 360 hours.

If you catch what a passer-by says for the first time and it makes you laugh, or makes you stand there and listen to the end - then those hours were worth it.

Found a bad line, a missing subtitle, or made another language version? Tell me in the comments.

May you understand everyone you pass in the rain out there.

[color=#8B7A55]* * [/color]
[img]https://staticdelivery.nexusmods.com/mods/3024/images/9961/9961-1786085322-744169490.jpg[/img]

[b][color=#B09868]中文说明[/color][/b]

[b]这是什么[/b]

《荒野大镖客 2》里绝大多数环境语音——路人闲聊、店主搭话、警长、陌生人,还有大量亚瑟自己的台词——都只有配音,没有字幕。这个 mod 把这些空缺补上,而且是[b]通过游戏自己的字幕系统[/b]显示的:黑色撕边横幅、说话人名、出现位置、淡入淡出,全都和官方字幕一模一样,不是在屏幕上另画一层字。

=== PASTE IMAGE 5 HERE : gallery_07_butcher_cn.jpg ===

[list]
[]中文版 [b]364,405 条[/b] / 英文版 [b]269,173 条[/b],覆盖 [b]615 个语音库[/b][/]
[][b]原版已有的字幕一条都不覆盖[/b],只填空白的那些[/]
[][b]不修改任何游戏文件[/b],一个 .lua 脚本加纯文本数据,卸载就是删文件[/]
[]说话人名是游戏自带机制,跟随你的游戏语言[/]
[]动物叫、呼吸、咳嗽这类非语言音效故意不给字幕[/]
[]只显示这个角色自己说的话,不会把别人的台词安到他嘴上[/]
[/list]
[b]安装[/b]

先装两个前置(压缩包里没有):ScriptHookRDR2 和 Ultimate ASI Loader。装过任何脚本 mod 的话你基本已经有了。然后把压缩包内容全部拖进游戏根目录(RDR2.exe 所在的那个文件夹),提示覆盖选是,进游戏就自动生效,不用按任何键。

覆盖时注意 [b]RedLua/Settings.json[/b] —— 那是 RedLua 自己的设置(菜单热键、自启动)。改过的话先备份,装完再还原。

[b]怎么确认生效[/b]

去瓦伦丁,抢一次店铺,或者瞄准马车夫按 E 让他停下 —— 只要脚本加载了,这两种情况必定出字幕。

没出的话按 [b]F7[/b] 开 RedLua 菜单手动重载:core.main.scripts → AmbientSubs.lua → core.script.rel。自启动偶尔会失败,手动重载一次就好。卸载是同一路径下的 core.script.unl,但[b]卸载之后本次游戏内无法再次加载[/b],要重启游戏 —— 脚本运行时挂在引擎底层,卸载会把这些全部清理干净,清理完就接不回去了。只是想临时关字幕,请用游戏自带的字幕开关。

按 F7 完全没反应,九成九是两个前置没装对。

[b]字幕文本你可以自己改[/b]

RedLua/Scripts/AmbientSubs/ 下面每个 .txt 都是纯文本,记事本能开,三列用 Tab 分隔:上下文名、变体号、字幕文本。哪句翻得不对,改那一行,存盘,重进游戏。

[b]想做西班牙语、葡萄牙语、德语版?默认授权,不用问我[/b],整个 trans.txt 换掉就行。数据做成纯文本就是为了这个。

[b]要先说清楚的[/b]

字幕文本是语音识别加自动校正做出来的,[b]不是官方剧本,里面有错[/b]。少量台词本身是外语或者含混听不清,那些是故意不给字幕的。看到读起来别扭的句子,按上一段自己改,几秒钟的事。

[color=#8B7A55] * *[/color]

[i]空山不见人,但闻人语响。[/i]
[color=#8B7A55]—— 王维《鹿柴》[/color][/center]
[center]
Exclusive Sponsorship Channel:[/center]
[center]这是我的唯一官方赞助渠道： [url=https://ifdian.net/a/HearTell]约翰·威廉姆森正在创作HearTell-AmbientVoiceSubtitles-RDR2 | 爱发电[/url] 谢谢大家，你们的赞助是我前行的动力.....[/center]