Repository navigation
Releases
v0.1.2 — GTA V Mod Switcher
v0.1.2 — GTA V Mod Switcher
Download Windows ZIP / Скачать Windows ZIP
English
Quickly move GTA V mods out of the game directory before GTA Online, then restore your modded Story Mode setup with one button.
Changes
- Added a dedicated Simple Trainer group for
TrainerV.asiand root-leveltrainerv.ini. - Preserved the previous Other ASI selection when upgrading an existing profile. Later manual checkbox changes remain respected.
- Added English | Русский links to both READMEs and shortened the user instructions.
- Clarified detected mods, Online preparation, storage and startup troubleshooting. Developer details moved into separate documentation.
Install or update
Download GTA-V-Mod-Switcher-v0.1.2-Windows.zip from Assets, extract every file outside GTA, and open GTA V Mod Switcher.exe. For an existing installation, close the app and replace its application files. Settings and mod storage remain separate. Optionally run CREATE-SHORTCUT.cmd to create or update the desktop shortcut.
Requires Windows 10/11 with built-in Windows PowerShell 5.1 and .NET Framework. The interface is currently in Russian; English instructions explain the controls. English guide.
Groups describe files already found in GTA or storage. Simple Trainer configuration kept outside the game directory, such as AppData, stays in place. Check all selected mods, original game files, BattlEye and launcher settings before Online: the switcher does not certify an Online-compatible installation. Legacy was tested on the author's installation; Enhanced paths are recognized but a real Enhanced installation remains unvalidated.
Русский
Быстро переносите моды GTA V из папки игры перед GTA Online и возвращайте их для сюжетного режима одной кнопкой.
Что изменилось
- Отдельная группа Simple Trainer:
TrainerV.asiиtrainerv.iniв корне GTA. - При обновлении профиля сохраняется прежний выбор из группы «Другие ASI-моды». Последующие изменения галочек не переопределяются.
- Ссылки English | Русский в обоих README и более короткая инструкция.
- Понятное описание распознаваемых модов, подготовки к Online, хранилища и ошибок запуска. Сведения для разработчиков перенесены в документацию.
Установка или обновление
Скачайте GTA-V-Mod-Switcher-v0.1.2-Windows.zip из Assets, распакуйте все файлы вне GTA и запустите GTA V Mod Switcher.exe. При обновлении закройте программу и замените её файлы. Настройки и хранилище модов остаются отдельно. Для ярлыка при желании запустите CREATE-SHORTCUT.cmd. Русская инструкция.
Требуются Windows 10/11, встроенные Windows PowerShell 5.1 и .NET Framework. Группы показывают уже найденные файлы. Настройки Simple Trainer вне папки игры, включая AppData, остаются на месте. Перед Online проверьте выбор модов, оригинальные файлы GTA, BattlEye и параметры лаунчера: переключатель не подтверждает полную чистоту игры для Online. Legacy проверена на установке автора; реальная установка Enhanced ещё не проверена.
By / Автор: SPARKYASHH · MIT · Unofficial utility, not affiliated with Rockstar Games.
SHA256SUMS.txt contains the checksum of the Windows ZIP / содержит контрольную сумму Windows ZIP.
v0.1.1 — GTA V Mod Switcher
GTA V Mod Switcher by SPARKYASHH — v0.1.1
Первый публичный релиз / First public release.
Скачать и запустить / Download and run
Скачайте GTA-V-Mod-Switcher-v0.1.1-Windows.zip из Assets ниже. В нём уже есть готовый EXE. Автоматические архивы Source code предназначены для разработчиков.
Download GTA-V-Mod-Switcher-v0.1.1-Windows.zip from Assets below. It includes the ready-to-run EXE. GitHub's automatic Source code archives are for developers.
По-русски
Укажите папку GTA V один раз, выберите группы компонентов и отключайте или возвращайте выбранные моды одной кнопкой. Хранилище создаётся автоматически рядом с папкой игры, на том же диске. Файлы не удаляются и не перезаписываются.
Возможности
- Минималистичный светлый интерфейс и иконка с V и стрелками.
- Запуск через GTA V Mod Switcher.exe без CMD и консоли PowerShell.
- Сохранение пути, групп и отдельных профилей установок.
- Группы Menyoo, Script Hook V, ScriptHookVDotNet, scripts, mods и остальных ASI; графические компоненты предлагаются отдельно.
- Добавление собственных файлов и папок из корня игры.
- Проверка конфликтов, журнал, откат после ошибки и восстановление прерванного переключения.
- При ошибке запуска — отдельное сообщение и локальный журнал.
Установка
- Распакуйте ZIP целиком в постоянную папку вне GTA и хранилища модов.
- Откройте GTA V Mod Switcher.exe. Дополнительная установка Python или библиотек не требуется.
- Выберите папку игры с GTA5.exe или вставьте путь и нажмите Enter.
- Проверьте группы: справа показывается их точный состав. Закройте GTA и переключайте моды основной кнопкой.
- Для ярлыка с иконкой запустите CREATE-SHORTCUT.cmd один раз. Ранее созданный этой программой ярлык обновится.
Обновление и переход со старого скрипта
Закройте приложение и распакуйте новую сборку целиком. Настройки и хранилище оконной версии сохраняются отдельно от файлов программы. Если использовали старый консольный ModSwitch v2 с другим хранилищем, сначала верните моды старым скриптом. Не удаляйте хранилище с отключёнными модами.
Проверено
Автоматические тесты Windows PowerShell 5.1 и PowerShell 7, интерфейс, EXE без консоли, ярлык и ошибки запуска. Автор подтвердил отключение, возврат модов, сохранение настроек после перезапуска и запуск без консоли на своей GTA V Legacy. Это ранняя версия ветки 0.1; Enhanced распознаётся, но на реальной установке ещё не проверена.
Программа управляет выбранными компонентами. Она не восстанавливает изменённые оригинальные архивы, не управляет BattlEye и не гарантирует полную чистоту установки для GTA Online. Изменения параметров Steam/Rockstar Launcher остаются на стороне пользователя.
Подробности — в README_RU.md внутри ZIP и инструкции на GitHub.
English
Choose your GTA V directory, review component groups, then disable selected mods and restore them with one button. Storage is created automatically beside the game directory on the same drive. The tool does not delete mods or overwrite existing destination files.
Features
- Minimal light interface and V / switch-arrow icon.
- GTA V Mod Switcher.exe opens without CMD or PowerShell console windows.
- Saved game paths, selected groups and separate installation profiles.
- Menyoo, Script Hook V, ScriptHookVDotNet, scripts, mods and other ASI groups; optional graphics candidates.
- Custom root-level files/folders, conflict checks, journal, rollback and interrupted-operation recovery.
- Startup errors appear in a dialog with a local log path.
Installation
- Extract the complete ZIP to a permanent directory outside GTA and mod storage.
- Open GTA V Mod Switcher.exe. No Python or additional library installation is required.
- Select the game directory containing GTA5.exe, or paste its path and press Enter.
- Review component groups, close GTA, and use the primary button to switch mods.
- Run CREATE-SHORTCUT.cmd once for a desktop shortcut. It updates previous shortcuts created by this utility.
Requires Windows 10/11 and built-in Windows PowerShell 5.1 / .NET Framework. Close the application before updating and keep the package together. Settings and storage are separate from application files. Before migrating from the old console ModSwitch v2, restore its mods with the old script first. Never delete storage while it contains disabled mods.
Validation and scope
Windows PowerShell 5.1 and PowerShell 7 file-operation tests, WinForms UI, console-free EXE, shortcut and startup failure tests passed. The author confirmed disable/restore, saved settings after restart and console-free startup on their GTA V Legacy installation. Enhanced paths are recognized but real-installation compatibility has not been validated. This is an early 0.1 release; the tested scope remains GTA V Legacy.
The tool handles selected components; it does not restore modified original game archives, control BattlEye, change launcher options or certify an Online-compatible installation.
See README.md in the ZIP and the GitHub instructions.
By SPARKYASHH. Independent, unofficial utility; not affiliated with Rockstar Games. Code: MIT. GTA V marks belong to their respective owners.
SHA256SUMS.txt contains the checksum of the Windows ZIP.