Home

GTAV Mods Manager Wiki

A cross-platform (Windows + Linux) mod manager for Grand Theft Auto V — Legacy and Enhanced single-player mods, LSPDFR, and FiveM.

Current status (read this first)

• Core engine (gtavmm-core) and CLI (gtavmm-cli): functional, tested against real mod files, and the most complete way to use every feature today.
• Desktop app (gtavmm-app): under active development, not feature-complete. It has a working navigation shell with English/Traditional Chinese support, and a few pages wired to real backend commands (Legacy SP mod listing, the FiveM server load-order tool, the SP→FiveM converter). The install wizard and most other pages are placeholders or not built yet.

If a page below describes something the desktop app can't do yet, it's describing the CLI — each page says which.

Pages

• Getting Started — install prerequisites, first run, detecting your game
• Game Setup and Launch — how detection works, --game-path, --mode (SP/LSPDFR/FiveM client)
• Installing Mods — supported formats, install/inspect/scan
• Managing Installed Mods — list, enable/disable, uninstall, reinstall, search, history
• Backup and Restore — per-mod backups, the recycle bin, full backups
• SP to FiveM Converter — turning an SP add-on vehicle pack into a FiveM resource
• Advanced Tools — profiles, the AI assistant, the prompt library, FiveM resource load ordering, exporting your library, component checks
• Safety Model — what the tool refuses to do, protected files, conflict detection, and why
• Data Locations and Logs — where the database, settings, and logs live
• Building and Releasing — building from source, running tests, CI
• User Manual — the long-form reference covering everything above in one place
• FAQ
• Changelog

Reporting a problem

Run gtavmm report-crash to generate a de-identified, pre-filled GitHub Issue draft — this only prints a URL and text for you to review; nothing is sent until you submit it yourself. Or open an issue directly: https://github.com/SpaceSquare640/GTAV_Mods_Manager/issues

Contributing

See CONTRIBUTING.md in the repository.