Metro Mod Loader for Road to Vostok

Metro Mod Loader — Road to Vostok

A community-built mod loader for Road to Vostok (Godot 4.6) featuring a pre-game launcher with mod profiles, ModWorkshop update checks, a malware scanner, and automatic crash recovery. Simply drop .zip or .vmz files into the mods folder to get started.
Source: github.com/ametrocavich/vostok-mod-loader

Overview

Metro Mod Loader adds a launcher window that appears before the main menu, allowing users to enable or disable mods, set load order priorities, and check for ModWorkshop updates — all without restarting the game or manually editing configuration files.

The loader registers as a Godot autoload via override.cfg, scans the mods folder, mounts archives through ProjectSettings.load_resource_pack(), reads each mod’s mod.txt, and initializes declared autoloads in priority order. It is also drop-in compatible with tetrahydroc’s RTVModLib Hook API, meaning existing hook-based mods run without modification.

Always back up your save files before installing any mods.

 

 

Installation

1. Download the latest release from the Files tab and extract it — you should have override.cfg and modloader.gd

2. In Steam, right-click Road to Vostok → Manage → Browse local files to open the game directory (e.g. C:\...\steamapps\common\Road to Vostok\)

3. Copy both override.cfg and modloader.gd into the game folder (the same directory containing RoadToVostok.exe)

4. Create a mods folder in that same location if one does not already exist

5. Place your .vmz mod files inside the mods/ folder

6. Launch the game normally — no Steam launch options required; the mod loader UI will appear before the main menu

To uninstall: Delete override.cfg and modloader.gd from the game folder. The mods folder can be removed separately. Settings stored at %APPDATA%\Road to Vostok\mod_config.cfg and the hook pack cache at %APPDATA%\Road to Vostok\modloader_hooks\ are both safe to delete.

Key Features

• Pre-game launcher UI — Opens before the main menu with dedicated Mods and Updates tabs

• Per-mod toggle — Enable or disable individual mods via checkbox without removing files

• Priority-based load order — Higher priority mods load last and win file conflicts; live preview updates in real time

• ModWorkshop update checker — Mods with a ModWorkshop ID in their mod.txt can be checked and updated directly from the launcher

• Format support — Compatible with .vmz, .pck, and unpacked folders (unpacked folders require Developer Mode)

• mod.txt schema — Supports autoloads, script extensions, hook declarations, registry helpers, and dependency hints

• RTVModLib compatibility — Hook API is fully drop-in compatible; existing mods run unchanged

• Security scanner — Performs static scans flagging mods that match known malicious patterns (e.g. obfuscated string decoding paired with process spawning, anti-debug crashes, ransomware setup calls); flags mods with a red tag and displays a confirmation dialog before launch — never silently blocks

• Crash recovery — Automatically resets to a clean state after two consecutive failed launches; modloader_disabled fully bypasses the loader, while modloader_safe_mode resets override.cfg

• Reset to Vanilla — One-click option to restore a clean game state without uninstalling the loader

• No launch options required — Fully compatible with the standard Steam launch button

Requirements

• Road to Vostok (PC, Steam) — current Godot 4.6 demo build

• Mods packaged as .vmz or .pck; unpacked folders supported in Developer Mode

• Migrating from VostokMods or any --main-pack-based loader: Remove the old Steam launch option before installing, as it will conflict

• Migrating from v2.1.0 or v3.0.0: Upgrade directly to the latest version; v3.0.1+ uses an opt-in declaration model — mod authors should review the README migration sections for details

Credits

• Ryhon0 — Original VostokMods loader system, which defined the architecture this project is built upon

• tetrahydroc — RTVModLib, whose Hook API and framework wrappers this loader is fully compatible with

• Road to Vostok modding community — ModWorkshop and Discord contributors for testing, bug reports, and feedback throughout development