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.
Read the current location
Section titled “Read the current location”Run this when opening the launcher and before enabling Play:
.\client-helper.exe gameThis 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.
Choose another folder
Section titled “Choose another folder”Open a directory picker and pass its absolute path to:
.\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.rpfvalid: 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.
Restore automatic detection
Section titled “Restore automatic detection”For Detect automatically, run:
.\client-helper.exe game --path autoThis 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.