Skip to content

Backup and Restore

SpaceSquare edited this page Aug 29, 2026 · 2 revisions

Backup and Restore

There are two independent safety nets — a per-mod one that runs automatically, and a whole-folder one you trigger manually.

Per-mod backups (automatic)

Every install that would overwrite an existing file backs that file up first, by default. When you uninstall a mod, a snapshot of what was removed goes to the recycle bin rather than being deleted outright.

Recycle bin

gtavmm recycle-bin list
gtavmm recycle-bin restore <id>

Uninstalled mods sit here with an expiry date before they're actually cleaned up — enough time to change your mind. list shows what's there and how long until each entry expires; restore puts a specific entry back.

Full backups (manual)

gtavmm full-backup create
gtavmm full-backup list
gtavmm full-backup restore <path>

A coarser, whole-mods\-folder snapshot, distinct from the automatic per-mod backups above — useful before a big batch of installs, or before experimenting with something you're not sure about. create snapshots the current state; list shows what backups exist and when they were taken; restore rolls the entire folder back to a specific snapshot.

Note: a full backup can be large (tens of GB isn't unusual for a heavily modded install) — point it at a drive with room.

What's NOT automatic

This tool does not delete anything without a trace, but it also doesn't second-guess an explicit uninstall or full-backup restore beyond what's described above. If you want extra insurance before a risky change, take a full backup first.

Clone this wiki locally