Skip to content

GTA folder selection

Add a GTA folder setting with Choose folder and Detect automatically actions. The helper uses registry detection until the player saves a custom path.

Run this when opening the launcher and before enabling Play:

Terminal window
.\client-helper.exe game

This command works offline without a selected server or configured resource storage. A successful result looks like this:

{
"protocolVersion": 1,
"event": "game",
"path": "D:/Games/Grand Theft Auto V",
"source": "custom",
"valid": true
}

Display path and use source to label how it was selected:

source Launcher label
registry Detected automatically
custom Selected folder
none GTA installation not found

path is null when no location is available. A non-null path can still have valid: false. Show that path so the player can correct it, and keep Play disabled until a valid folder is selected.

A saved custom path takes priority even when it becomes unavailable. For example, if the player moves GTA or disconnects its drive, the helper returns that saved path with source: "custom" and valid: false. Ask them to choose the new folder, reconnect the drive or restore automatic detection.

Open a directory picker and pass its absolute path to:

Terminal window
.\client-helper.exe game --path "D:\Games\Grand Theft Auto V"

Select the GTA V Legacy installation root. Validation checks that these files exist and are nonempty:

Grand Theft Auto V/
├── GTA5.exe
├── GTAVLauncher.exe
├── common.rpf
└── update/
└── update.rpf

valid: true confirms this layout. For suspected file corruption, use the storefront’s game-file verification.

On success, update the displayed path from the returned game event. The helper saves the resolved path, so it may differ from the path submitted by the picker. If validation fails, it returns invalid_game_path and preserves the previous selection. Closing the picker without choosing a folder should leave the setting unchanged.

The Electron example already opens the picker in the main process, validates the choice through the helper and checks the installation again. Keep path changes disabled while a helper operation is running.

The selection is saved as gamePath in %LOCALAPPDATA%\revo\installation.json and takes effect on the next GTA launch. Use the helper to update it. Choosing a GTA folder preserves the resource storage setting.

For Detect automatically, run:

Terminal window
.\client-helper.exe game --path auto

This removes the saved custom path and returns the current registry detection result. It preserves the resource storage setting and leaves GTA files and registry values unchanged.

Check valid in the response. Resetting can succeed while detection returns valid: false, so keep the folder picker available. If detection finds no location, the result has source: "none" and path: null.

If reading or resetting the location returns an error event, display its message. invalid_game_path can also report a damaged or unwritable installation settings file. Retrying a different GTA folder will not resolve that cause.