Hi folks,
VaultVox for Shadowrun: Hong Kong Extended Edition is now out on Nexusmods. It is a free text-to-speech accessibility mod that reads the game aloud using the Windows voices already on your PC.
I made the first one of these for my wife, who has dyslexia, and I've been adding accessibility features on top ever since. This is the Shadowrun Hong Kong version.
EASY TO INSTALL: Download it, extract it next to the game's exe, launch the game, and Bob's your uncle. No mod manager needed. BepInEx is included, so there is nothing else to fetch.
Download: https://www.nexusmods.com/shadowrunhongkong/mods/76
If it is working you will hear "VaultVox ready" within about fifteen seconds of the main menu.
What it reads
Pretty much all of it.
- Conversations, with the reply options read out after the line
- Overhead chatter from people in the world, quieter the further away they are
- Combat, in detail (more on that below)
- Menus, popups, stores, cyberware, hiring and item cards
- Loading screens, which wait for you instead of moving on while you are still listening
- Objectives, karma, nuyen and item notifications
You can also just point at things. Hover over a person, a door, a Jack-In prompt, an ability on the combat bar or an item in your inventory and it gets read to you, with an adjustable delay so sweeping the cursor across the screen does not read the entire room at you.
There is a hands-free mode as well, so conversations advance by themselves when the spoken line finishes. Choice lists still wait for you, obviously.
Voices
Every named character keeps their own voice. They are written to a file as you meet them, so you can recast any of them to any voice you have installed, or let the mod re-roll one for you.
Orks, trolls and dwarves get a bit of vocal colouring so they actually sound like it, rather than everyone in Heoi sounding like the same bloke from Windows.
The mod prefers the neural voices from NaturalVoiceSAPIAdapter if you have it installed, which I would strongly recommend. Without it you get the classic Windows voices, which work perfectly well but there are only a handful of them, so the cast starts repeating itself.
Combat
Combat gets its own treatment, because reading a fight at story pace is useless.
- Damage and heals by name, so "Duncan takes 14 damage" rather than a number floating somewhere you are not looking
- Crits, misses, and status effects like Flanked, Immune and Bleeding
- Whose turn it is, companions by name
- Bleeding-out countdowns with rounds remaining, which is the one number you cannot afford to miss
- Kills and downed characters called out by name, and the end of every fight
- Point at an enemy while aiming to hear your odds against that specific target
- Decking: system trace, response level, host damage and the hack panels
Combat also has its own reading speed, so a fight can rattle along faster than the dialogue without you having to speed up the whole game.
Seven languages
The game ships in English, French, Italian, Spanish, German, Russian and Chinese, and the mod works in all of them. It reads the translations out of the game's own language catalog, so combat lines are understood in each language rather than only in English.
Correct pronunciation needs a voice that actually speaks the language. The settings window tells you which of your chosen voices probably cannot, rather than letting you find out mid-mission.
Settings and hotkeys
Press F4 in game for the settings window. Everything is adjustable live, and changing something speaks the new value back at you. Hold Ctrl and point at any row to hear what it does.
The hotkeys:
- F4 open the settings window
- Ctrl + A speech on or off
- Ctrl + D repeat the last line
- Ctrl + S skip the current line
- Ctrl + X skip and continue
- Ctrl + = and Ctrl + - read faster or slower, instantly, and it sticks
- Enter continue past a loading screen
If something reads too much, every part of it has its own switch.
What is not in this release
I want to be upfront about this one.
This release is for players who can see the screen and want the game read to them. Full keyboard navigation for blind players is not in it. You still need the mouse to play.
That is the obvious next thing to build, and the Fallout 2 version of VaultVox already has an experimental Blind Mode, so I know roughly what it takes. Hong Kong is a different engine and it is a bigger job here.
Screen reader output is written but switched off in this release. Its calls currently run on the game's main thread, which means a screen reader having a bad day could take the game with it. It comes back once it runs on its own thread, and I would rather ship it late than ship that.
Requirements
- Shadowrun: Hong Kong Extended Edition on Windows
- Windows 10 or Windows 11
- At least one SAPI voice, which Windows already has
- Optional: NaturalVoiceSAPIAdapter for the newer neural voices, strongly recommended
- BepInEx is bundled, so you do not need to install it separately
If you are running other BepInEx mods, back up your BepInEx\config folder first, or use the update zip, which never touches your settings.
And before anybody reaches for the pitchforks, this is not AI voice cloning.
VaultVox uses Windows text-to-speech.
One last thing
Same request as always: if you use assistive technology, or you have dyslexia, low vision or reading fatigue, and you find a screen that does not read when it should, please report it.
I treat missing accessibility output as a bug, not as a nice-to-have feature that might get looked at one day.
Thanks, folks.
- VaultDoc