VTOL VR Workshop Profile Switcher

Switch VTOL VR Steam Workshop mod setups in seconds using reusable profiles.

If you like this project, please consider giving it a star on GitHub. ⭐

TL;DR

VTOL VR Workshop Profile Switcher scans your VTOL VR Workshop folder, lets you save named mod profiles, and applies them while keeping workshop folders in canonical <WorkshopId> naming. It also supports live refresh, logs, and snapshot backups before changes.

Requirements

This tool only helps you manage and switch between already downloaded mods. It requires the official VTOL VR Mod Loader and existing Workshop mods to function.

• Install the official VTOL VR Mod Loader from Steam first.
• Download your mods through the Mod Loader before using this app.
• This tool does not install, update, or download mods.
• This app is a helper/profile manager for mods you already have.
• It does not replace the official Mod Loader.

Screenshots

Feature Overview

Feature	Included
Auto-detect VTOL VR Workshop path from Steam libraries	✓
Manual Workshop path override	✓
Detect enabled/disabled mods from folder naming	✓
Save and load named profiles	✓
One-click apply profile (folder rename engine)	✓
Snapshot backup before apply	✓
Restore latest snapshot	✓
Live folder refresh / watcher	✓
Search/filter and bulk toggle mods	✓
Logging (operations and crash logs)	✓
Built-in Steam Workshop page opening after delete	✓
Profile package import/export (JSON)	✓
Missing mod assistant (manual workshop opening)	✓
CLI mode	✗
Drag-and-drop mod package import	✗

How to Use

1. Scan and review mods. Open the app, confirm the Workshop folder path (steamapps/workshop/content/3018410), and let it scan your mods.

2. Create a profile. Enable/disable mods in the UI, then save that selection as a named profile (for example, PvE Coop or Vanilla+).

3. Apply when needed. Select a saved profile and click apply. The app renames folders to match your profile and creates a snapshot backup first.

4. Share profiles with package import/export. Use EXPORT SELECTED or EXPORT ALL to create a portable JSON profile package. Use IMPORT PACKAGE to import packages from other users, with conflict handling (Rename, Overwrite, or Skip).

5. Resolve missing mods manually (no SteamCMD). If a profile references workshop IDs you do not have locally, the Missing Mods panel appears. Use:

• OPEN NEXT MISSING MOD to open each required Workshop page (steam:// first, then browser fallback).
• COPY ALL MISSING IDS to copy all IDs.
• RESCAN after subscribing/downloading.
• APPLY AGAIN once missing mods are installed. The app logs opened IDs, import/apply outcomes, and remaining missing IDs after rescans.

Profile Package Format

Exported packages use JSON schema version 1:

{
  "schemaVersion": 1,
  "packageName": "All Profiles",
  "createdAtUtc": "2026-02-16T10:15:30.0000000Z",
  "profiles": [
    {
      "name": "PvE Coop",
      "notes": "Carrier ops setup",
      "enabledWorkshopIds": ["1234567890", "9876543210"]
    }
  ]
}

Notes:

• enabledWorkshopIds are numeric Steam Workshop IDs (non-numeric values are dropped on import).
• Duplicate workshop IDs in a profile are removed automatically.
• Name conflicts during import follow your selected policy.

Installation

Option 1: Use a Release Build (Recommended)

1. Open the repo's Releases page.
2. Download the latest installer or packaged build for Windows.
3. Install and launch VTOLVRWorkshopProfileSwitcher.

Option 2: Build from Source (.NET 8)

Requirements:

• Windows
• .NET 8 SDK
• Steam with VTOL VR Workshop content installed

dotnet restore .\VTOLVRWorkshopProfileSwitcher.sln
dotnet build .\VTOLVRWorkshopProfileSwitcher.sln -c Release
dotnet run --project .\src\VTOLVRWorkshopProfileSwitcher\VTOLVRWorkshopProfileSwitcher.csproj

Optional installer build (requires Inno Setup 6):

.\scripts\build-installer.ps1 -Configuration Release -Runtime win-x64 -Version 1.0.0

Safe Usage, Backups, and Warnings

• Close VTOL VR before applying profile changes.
• The app changes mod state by renaming Workshop folders.
• A snapshot backup is created before profile apply.
• Keep your Steam Workshop content fully synced before switching profiles.
• If anything looks wrong, use restore snapshot before making more changes.

Data locations:

• %LOCALAPPDATA%\VTOLVR-WorkshopProfiles\profiles - saved profiles
• %LOCALAPPDATA%\VTOLVR-WorkshopProfiles\backups - apply snapshots
• %LOCALAPPDATA%\VTOLVR-WorkshopProfiles\logs\app.log - app logs
• %USERPROFILE%\Documents\VTOLVR-WorkshopProfiles\logs\crash.log - crash logs
• %LOCALAPPDATA%\VTOLVRWorkshopProfileSwitcher\thumbnail-cache - image cache

Troubleshooting / FAQ

The app cannot find my Workshop folder

Use manual path override and point to: <SteamLibrary>\steamapps\workshop\content\3018410

My mods did not switch as expected

Close VTOL VR and Steam, reopen the app, rescan, then apply again. If needed, restore the latest snapshot backup.

Imported/applied profile shows missing mods

Use the Missing Mods panel to open required workshop pages one by one, wait for Steam to download them, then click RESCAN and APPLY AGAIN.

A mod is missing metadata or thumbnail

This can happen when Steam metadata is unavailable. The mod can still be managed by Workshop ID.

I applied a profile and now want to go back

Use the restore snapshot action to revert to the last pre-apply state.

Where are logs?

See the paths in the Safe Usage section above.

Community Requests / Questions

We want your feedback and ideas:

• What features should we add next?
• What integrations would help your workflow most?
• What workflow improvements would make profile switching faster?
• What UX changes would make the app easier to use?
• Do you have mockups or concept ideas we should explore?

Please open a GitHub issue for feature suggestions, workflow ideas, UX suggestions, and concept/mockup proposals.

Contributing

Issues and pull requests are welcome. Small fixes, UX improvements, bug reports, and feature requests all help.