Skip to content

Repository files navigation

VEIN Mod Loader

A mod manager for the VEIN game. Handles enabling and disabling .pak mods, Steam auto-detection, multiple profiles, and game launching - all in one place.

Created by Tsardev


Download

Get the latest release from the Releases page.

v2.0.0 SHA256 Checksum:

a93ac7c900ecbb6cc30694865cb4dab22846ca86cd2f3c362e7bab28efae8075

Verify your download in PowerShell:

Get-FileHash "Vein_Mod_Loader_v2.0.0.zip" -Algorithm SHA256

Or run verify_checksum.bat included in the release. This will show the actual has of the .exe versus what it should be as stated above.


Features

  • Steam auto-detection across all library folders
  • Enable / disable .pak mods individually or all at once
  • Multiple profiles — up to 10, each with its own paths and config
  • Profile switching saves your current state before swapping
  • Search / filter mod list
  • Custom game launch arguments
  • Splash screen on startup
  • Update checker — notifies you in the status bar when a new release is available
  • Portable config — change where settings are stored from inside the app

Installation

Standalone EXE (recommended)

  1. Download Vein_Mod_Loader_v2.0.0.zip from the releases page
  2. Extract the zip
  3. Run Vein_Mod_Loader.exe
  4. No Python required

Run from source

Requirements: Python 3.8+, Windows 10/11

git clone https://github.com/mikeybowman/vein_mod_loader.git
cd vein_mod_loader
pip install -r requirements.txt
python vein_app.py

Build your own EXE

build.bat

Output will be at dist\Vein_Mod_Loader.exe.


First Time Setup

  1. Launch the app
  2. Click Auto-Detect — finds your VEIN install via Steam automatically
  3. If auto-detect misses it, use Browse to set paths manually:
    • Game Executable — path to VEIN.exe
    • Mod Folder — where your modded .pak files are stored
    • Game Data — where mods get installed (usually VEIN\Content\Paks)
  4. Click Save Configuration

Managing Mods

Action How
Enable / disable a mod Double-click it
Enable / disable selected Use the buttons below the list
Enable all Enable All button - confirms before running
Disable all Disable All button - only removes mods it installed, never touches vanilla files
Search Type in the search box above the list

Status indicators: ✅ Enabled / ❌ Disabled

Right-click a mod for quick enable/disable from the context menu.


Profiles

  • Create up to 10 profiles with separate path configs
  • Switch via the dropdown in the Mod Manager tab or double-click in the Profiles tab
  • Switching profiles saves your current state automatically before swapping
  • Default profile cannot be deleted

Settings

  • Launch Arguments — extra flags passed to VEIN on launch (e.g. -windowed -nointro)
  • Configuration Location — move your config folder to a custom path
  • GitHub - opens this repository

Config is stored by default at:

%APPDATA%\VeinModLoader\config.json

File Structure

Vein_Mod_Loader/
├── img/
│   ├── VEIN.ico
│   ├── VEIN.png
│   ├── vein_splash.png
│   └── github_icon.png
├── vein_app.py
├── vein_core.py
├── vein_config.py
├── vein_theme.py
├── vein_app.spec
├── version_info.py
├── requirements.txt
├── build.bat
└── README.md

Troubleshooting

Game not found

  • Click Auto-Detect
  • Manually browse to VEIN.exe

Mods not enabling

  • Check that the Game Data path ends in \Content\Paks
  • Make sure you have write permission to that folder
  • Confirm your mods are .pak files

Mods not showing in the list

  • Check the Mod Folder path is set correctly
  • Click Refresh List
  • Make sure the folder contains .pak files

Steam not detected

  • Steam detection is optional — paths can be set manually
  • Make sure Steam is installed in a standard location

Settings reverting on launch

  • Delete %APPDATA%\VeinModLoader\config.json and reconfigure fresh

Security

This app is open source — the full source is in this repo. Always verify downloads using the SHA256 checksum provided on each release.

Permissions the app needs:

  • Read/write access to your mod folder and game data folder
  • Read access to Steam registry keys (for auto-detect)
  • Write access to %APPDATA%\VeinModLoader for config storage

Contributing

  1. Fork the repo
  2. Create a branch
  3. Make your changes
  4. Test on a real VEIN install
  5. Open a pull request

Bug reports and feature requests go in Issues.


License

Open source. Not affiliated with the VEIN game developers.

About

A lightweight, user-friendly mod loader for VEIN (Steam) built in python. This tool lets players easily organize, enable, disable, and launch VEIN with custom .pak mods without manually copying files into the game directory.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages