Getting Started

Getting Started

System requirements

• Windows 10 or 11 (64-bit)
• A legitimate installation of Grand Theft Auto V
• Administrator rights are requested only on demand (when writing into the game folder)
• Internet access is optional — used only for the update check and the Script Hook V .NET nightly download
• For building from source only: the .NET 8 SDK. The packaged download is self-contained.

Installing the app

Option A — the installer (recommended)

1. Get GTAV_Mods_Manager_V<version>_setup.exe from the latest release.
2. Run it and follow the wizard (license → install location → optional desktop icon → install). It installs per-user under %LOCALAPPDATA%, so no administrator rights are needed to install it, adds a Start Menu shortcut, and registers a normal uninstall entry under Add/Remove Programs.
3. Launch it from the Start Menu (or let the installer launch it for you at the end).

Option B — the portable, no-installer build

1. Get GTAV_Mods_Manager_framework-dependent.zip from the same release page and unzip it anywhere — nothing is installed; delete the folder to remove it.
2. Keep GTAV_Mods_Manager.exe in the same folder as the Localization folder it ships with (the app reads language packs from Localization next to the executable).
3. Double-click GTAV_Mods_Manager.exe. This build requires the .NET 8 Desktop Runtime to already be installed (the installer build in Option A does not need it).

Option C — build from source: see Building and Releasing.

First launch

The app (and the installer itself) open without administrator rights, so there is no UAC prompt. If Windows SmartScreen warns that the app is unsigned, click More info → Run anyway — this is expected for any unsigned app downloaded from the internet.

To verify your download is genuine, check that its SHA-256 hash matches the value printed in the release notes.

The interface starts in English.

The interface

The window uses a minimalist dark theme on golden-ratio proportions, organized into pages:

• Sidebar (left): the logo and a navigation menu that switches pages — Game, Install Mods, Components, Installed Mods, and Backup. The footer holds Settings, the current install mode, Check for updates, the language buttons, and the app version.
• Content (right): the selected page. The Install Mods page has three sub-tabs — General, Menyoo XML, and Add-on. A status bar at the bottom is shared by every page and shows the latest result.

Switching language

Click EN, 繁, or 简 in the sidebar to switch instantly between English, Traditional Chinese, and Simplified Chinese. This is purely a display change — nothing on disk is modified. Language packs are embedded in the executable, and can be overridden by editing the JSON files in the Localization folder next to it. The default at startup is always English.

If a label ever shows a raw key instead of text, that string is missing from the active language pack — it falls back to English, or to the key name as a last resort.