Skip to content

Game Setup and Launch

SpaceSquare edited this page Aug 29, 2026 · 2 revisions

Game Setup and Launch

Auto-detection

gtavmm detect-game

Tries, in order: Windows Registry → Steam libraryfolders.vdf → Epic manifest scan → the Rockstar launcher key (Windows), or a Proton compatdata scan (Linux). Both Legacy and Enhanced editions are detected and classified separately.

This deliberately doesn't try to cover every distro/launcher/library-location combination — it handles the common cases, and a manual override is always available and equally supported for anything auto-detection misses:

gtavmm --game-path "D:\Games\Grand Theft Auto V" <any command>

--mode: which directory conventions to use

Detection tells the tool which edition you have. --mode tells it which conventions to apply for install/inspect — these are independent (edition × mode), not the same setting:

Mode What it's for
sp (default) Plain single-player mods — ScriptHookV/SHVDN's scripts\, Menyoo, OpenIV's mods\ loose-file convention
lspdfr RAGE Plugin Hook plugin/callout conventions — managed .dlls go to Plugins\, not SHVDN's scripts\. Known limitation: real callout packages often actually live in Plugins\LSPDFR\, a subfolder the tool can't currently distinguish from a generic RPH plugin by inspection alone — everything lands in Plugins\ directly for now
fivem-client FiveM client-side asset mods. --game-path is required for this mode — there's no auto-detection, since a FiveM client install isn't a GTA V install at all

Example: installing an LSPDFR callout —

gtavmm --mode lspdfr install path/to/callout.zip

LSPDFR-specific setup

You'll need RAGE Plugin Hook and LSPDFR installed and working independently of this tool — gtavmm manages mod files, not the RPH/LSPDFR runtime itself.

FiveM server setup

The server-side tools (Advanced Tools § FiveM resource load order) operate on a resources\ folder and server.cfg you already have running — this tool doesn't set up or host a FiveM server for you.

Enhanced edition notes

Enhanced installs are detected via GTA5_Enhanced.exe (checked before generic Legacy signals, since some real installs also carry PlayGTAV.exe for compatibility — an actual false-positive found and fixed during testing, not a hypothetical). Enhanced-specific protections (GTA5_Enhanced_BE.exe, BEService_x64.exe) are included in the protected files list.

Clone this wiki locally