-
Notifications
You must be signed in to change notification settings - Fork 0
Changelog
All notable changes to GTAV Mods Manager, newest first. This page is generated from the GitHub Releases — starting with v0.16.0, release notes (and this section of history) are produced automatically by .github/workflows/release.yml; see Building and Releasing.
v0.16.2 — 2026-08-25
- Stop shipping the raw portable GTAV_Mods_Manager.exe as a release asset (f397b05)
-
GTAV_Mods_Manager_V0.16.2_setup.exe— recommended. Installer: Start Menu shortcut, optional desktop icon, clean uninstall via Add/Remove Programs. No administrator rights needed to install. -
GTAV_Mods_Manager_framework-dependent.zip— portable, no installer, requires the .NET 8 Desktop Runtime.
-
GTAV_Mods_Manager_V0.16.2_setup.exe:477273903F4DBCA57E189D90587D39548D3A22425684D817577CB89BF0082D17 -
GTAV_Mods_Manager_framework-dependent.zip:0D67268B4A37E40D4EFAEEDEDE615C108270E3FB44E8965C877DE87F289DE92D
v0.16.1 — 2026-08-25
- Add a proper Windows installer (GTAV_Mods_Manager_Vx.x.x_setup.exe) (c81d194)
- Fix release notes: git log output was collapsed onto one line (45fb5e5)
-
GTAV_Mods_Manager_V0.16.1_setup.exe— recommended. Installer: Start Menu shortcut, optional desktop icon, clean uninstall via Add/Remove Programs. No administrator rights needed to install. -
GTAV_Mods_Manager.exe— portable, no installer, self-contained, no prerequisites. -
GTAV_Mods_Manager_framework-dependent.zip— portable, smaller, requires the .NET 8 Desktop Runtime.
-
GTAV_Mods_Manager_V0.16.1_setup.exe:FE250F641DB9C84F3634FC64D534BDC1EF93F3DAB64034BA042CE3E819B1B7A3 -
GTAV_Mods_Manager.exe:8418A43F753E3B7A6E24430ADA71CA22EF3ACBA50D2C65F5333B1191BB99AF41 -
GTAV_Mods_Manager_framework-dependent.zip:D90B6658B8E9AC372EC78B2B9B5DBD75470BC210C7A43EFD310BDA96854832B3
v0.16.0 — 2026-08-25
- Move build/test/packaging/release fully to GitHub Actions (07465a8) - v0.16.0: Launch Game/Clean, game-running guard, confident outcome messages (ffaf3ed)
-
GTAV_Mods_Manager.exe— recommended, self-contained, no prerequisites. -
GTAV_Mods_Manager_framework-dependent.zip— smaller, requires the .NET 8 Desktop Runtime.
-
GTAV_Mods_Manager.exe:829D6C8E0A26C9A8077CDB694DDE76846828A013659D88B8A24C1C750AB2AB11 -
GTAV_Mods_Manager_framework-dependent.zip:03377D04A3C196F4533750D43AA2785BBB51C06DFAB4EADF2FF7EAC9B87054FA
v0.15.0 — 2026-08-23
- The mod installer now auto-extracts .zip archives. Selecting a .zip unpacks it into a private temp folder and analyzes its contents exactly like a folder - no more manually extracting before installing. .rar/.7z are still not extracted (no built-in .NET support, and this tool deliberately avoids a third-party dependency just for that); those now get a clear message pointing you to extract manually. A corrupt or password-protected .zip is detected and reported the same way, rather than silently producing zero deployable files.
SHA-256 (GTAV_Mods_Manager.exe): 5C977524C8C382387D3F321DB93A27DEF853C573A4B3EE7DC8BA606FEEB6D14F
v0.14.0 — 2026-06-08
-
One-click OpenIV for encrypted archives. When a mod contains an AES/NG-encrypted
.rpf(which this tool deliberately cannot decrypt - it does not ship GTA V's keys), an Open OpenIV button appears. If OpenIV is installed it launches directly; otherwise the button opens the OpenIV website so you can install it, extract the archive, and convert again.
SHA-256 (GTAV_Mods_Manager.exe): A784B9D22A09D1A61B22C0BD9D5B03D40E83360D134B4767934E2A3414C03F74
v0.13.0 — 2026-06-08
- Conflict detection across installed mods. The Installed Mods page now warns when two or more enabled mods overlap - either deploying to the same file (one overwrote the other) or registering the same dlcpack name. Each conflict and the mods involved are listed. Advisory only; nothing is changed automatically.
SHA-256 (GTAV_Mods_Manager.exe): 31E44F187A19119E4B0F057CE8B4F5D9C4D54F8E11264B7EF02E12108FBFC7F8
v0.12.1 — 2026-06-08
- Optional framework-dependent build (~5 MB zipped) for machines that already have the .NET 8 Desktop Runtime.
-
GTAV_Mods_Manager.exe- recommended, self-contained, no prerequisites (~73 MB). -
GTAV_Mods_Manager_framework-dependent.zip- smaller, requires the .NET 8 Desktop Runtime (will not start without it).
SHA-256
- exe:
5D0C63BD2E7432B6ED3564C9AEF760AA934E9E5D698F27447FE80E240D936E99 - zip:
F0C6CEA5F271604A427B3738B966D130A62FA80F9AF35DDEEE61DEB40FE31652
v0.12.0 — 2026-06-08
-
Analysis and conversion now run in the background, with progress and cancel. Unpacking a large
.rpfno longer freezes the window - a progress bar shows the item currently being processed, and a Cancel button stops the run cleanly. The Convert button is disabled while a run is in progress.
Under the hood, CancellationToken + IProgress<string> are threaded through the converter service and the RPF reader; cancellation is surfaced to the caller rather than reported as a failure.
SHA-256 (GTAV_Mods_Manager.exe): 2599678CB8745B97CE36DEFCF865FF86CD7A4DC5D0EFE82C3AC3FA49EC9A9B7D
v0.11.0 — 2026-06-08
-
Audio assets are preserved, not dropped.
.awc/.rel/.dat/.nametableare copied to anaudio/folder, with commenteddata_filetemplate lines (best-effortAUDIO_*type) infxmanifest.luafor you to finish - FiveM can't wire audio automatically, but nothing is lost. -
Vehicle spawn names read from
vehicles.metaare shown in the manifest header and the report (the name you type with/car). -
The conversion report traces every file to its source, including the path inside an unpacked
.rpf(e.g.stream/polrevent.yft <- rpf:/./vehicles.rpf/polrevent.yft).
-
.rpfreading is now fully streaming with bounded memory - nested archives are read in place (windowed over the same file) and assets are streamed straight to disk, so memory no longer scales with archive/asset size. Large add-on packs unpack without big allocations.
-
Large compressed binary entries (24-bit size
0xFFFFFF) are inflated by streaming to the deflate end instead of being mis-read (previously only resource entries handled this).
SHA-256 (GTAV_Mods_Manager.exe): 6B3FD4248AB092AD47D725978B777FFDE5D481CAE80E3F7B3F855E65391D6FAD
v0.10.2 — 2026-06-08
-
The SP -> FiveM Converter now writes metadata into a
common/folder (instead ofdata/).
The generated fxmanifest.lua references it accordingly:
files {
'common/vehicles.meta',
...
}
data_file 'VEHICLE_METADATA_FILE' 'common/vehicles.meta'Meta files go directly under common/ (no extra sub-folder). The stream/ folder for models (.yft/.ytd) is unchanged. This matches the folder layout expected for FiveM vehicle resources.
SHA-256 (GTAV_Mods_Manager.exe): D0D908513742B00B7300906902019CF1A4B220D3586AE32EB78F2566550630DB
v0.10.1 — 2026-06-07
-
.rpfreading now extracts large resource models (.yft/.ytd) correctly.
Vehicle and texture resources are large enough that their on-disk size field saturates (0xFFFFFF). The previous build treated that as a "skip" case and silently dropped every model, producing a resource with only .meta data files and no stream/ folder - which FiveM rejects as an invalid format (e.g. "FiveM Resources (format error)").
The reader now recovers the real size from the resource's on-disk header, strips the 16-byte container header, and emits a proper loose RSC7 resource (header + still-compressed body, as the game expects). Add-on cars packed as a single dlc.rpf (models inside a nested vehicles.rpf) now convert with their models intact. Verified end-to-end against a real 60 MB add-on archive.
SHA-256 (GTAV_Mods_Manager.exe): F74FED89072F22BC8C857E2C472CED152C87CED0593BD70912F821178B527146
v0.10.0 — 2026-06-07
-
Direct
.rpfreading. Unencrypted RPF7 archives (the OpenIV/CodeWalker "open" format) are unpacked automatically: the converter walks the archive directory tree, inflates deflate-compressed entries, and rebuilds the on-diskRSC7header for resource assets (.yft/.ytd/.ydr ...) so the extracted files are usable. Nested.rpfarchives (e.g. avehicles.rpfinsidedlc.rpf) are unpacked too. The unpacked contents - including anycontent.xml- flow through normal analysis, so add-on vehicles shipped as a singledlc.rpfconvert without manually extracting them first.
-
.rpffiles are no longer skipped with a generic warning. Encrypted (AES/NG) archives are detected and reported separately with guidance to extract them in OpenIV; only genuinely unreadable/corrupt archives produce the generic warning.
- RPF reading is read-only - archives are unpacked into a private temp staging folder, never the source or game directory.
- GTA V's proprietary AES/NG decryption keys are deliberately NOT shipped. Encrypted archives are reported, not decrypted - keeping the tool legally clean.
Download: GTAV_Mods_Manager.exe (self-contained, win-x64, no .NET install needed).
SHA-256: 22C01D8A98C74EB078704FD21369176DAA0C039D4BC1EE3AFD81461C97D4C43C
Tests: 91 passing (incl. a new RPF7 reader suite). Build: 0 warnings / 0 errors.
v0.9.0 — 2026-06-07
A new conversion engine that turns GTA V single-player asset mods into FiveM server resources.
-
SP -> FiveM Converter (new sidebar page):
- Detects and converts add-on vehicles, peds/clothing, weapons, and maps.
- Repackages stream assets (
.yft/.ytd/.ydd/.ymap/.ytyp ...) intostream/and.metaintodata/, and generates a correct fxmanifest.lua withdata_filelines. - Reads
content.xmlfor authoritativedata_filetypes; otherwise infers from well-known names..ytypgetsDLC_ITYP_REQUESTautomatically. -
Honest about scripts: ScriptHookV
.asi, ScriptHookVDotNet.dll/.cs, Lua, and Menyoo XML can't run on FiveM - they are detected, listed, and excluded (never silently dropped). Packed.rpfis flagged to extract with OpenIV first. - Read-only analysis with a live preview before converting. Output is a new folder you choose, plus a
CONVERSION_REPORT.txt.
- The converter only reads the source mod and writes a brand-new resource folder. It never touches the game directory and never deletes anything.
- 16 new tests; 84 total, all passing.
Asset: GTAV_Mods_Manager.exe (self-contained, win-x64, ~72.9 MB)
SHA256: 9E412C92B458B53DCA60162A5282BB158F6B24CA173143E2B1721E673D631AD9
v0.8.1 — 2026-06-07
Fixes a crash introduced in 0.7.0 where the app could crash on startup or whenever you right-clicked any text (Circular reference . ThemeStyle property on TextBlock).
- The "right-click to copy any text" feature declared its copy menu inside the implicit
TextBlockstyle. The menu's own label is itself aTextBlock, so it re-inherited the style and re-attached the same menu - WPF's resource walker then hit a circular reference whenever any context menu opened. The copy menu is now attached in code, eliminating the cycle and also fixing the editor's native right-click menu.
- The "right-click copy on all text" feature is unchanged - same behavior, no longer crashes.
- Added a WPF smoke test that actually opens a context menu to prevent regression. 68 tests pass.
Asset: GTAV_Mods_Manager.exe (self-contained, win-x64, ~72.9 MB)
SHA256: DC14E05DEB4491BCD9992A4753C4404318FED2478DE67729D8BB5EFA447AA575
v0.8.0 — 2026-06-07
GUI polish following five principles: simple, plain, practical, good-looking, usable.
- Clearer active page - a left accent bar marks the selected page; each nav item has a simple monochrome icon.
- Focus feedback - text boxes and the Install Mode dropdown highlight in the accent color when focused.
- Page headers - every page has a short description under its title.
- Empty states - friendly hints when Components / Installed Mods / Install Helper have nothing to show yet.
- Buttons - added a pressed state and clearer disabled styling.
- Status bar - a small dot turns green on success and red on failure.
- Spacing and contrast tidy-up, keeping the minimalist dark style.
- Pure presentation changes; install and safety logic are unchanged. 67 tests still pass.
Asset SHA-256 (GTAV_Mods_Manager.exe):
5056237564ACDF8E09755936A999D005F4CB9E26B620A4AF120981126F089FF8
v0.7.1 — 2026-06-07
- Settings -> Install Mode dropdown text is now readable on the dark theme (the ComboBox and its dropdown are fully dark-styled).
- Sidebar navigation no longer gets clipped - the page list scrolls and the default window is a little taller, so Backup / Editor / Install Helper are always reachable.
Asset SHA-256 (GTAV_Mods_Manager.exe):
58A8BA96EB8BC0746F47639F613FD3AF43264C665B2CA86F88A3EF661FDBB793
v0.7.0 — 2026-06-07
- Right-click copy everywhere - any displayed text has a right-click Copy; editor/document areas are fully selectable.
-
Editor page - manually edit any game file as text in-app (e.g.
dlclist.xml,content.xml,vehicles.meta). Executables (.exe) can never be edited. Saving backs up the original first and requires double-consent; binary files are warned. One-click Open dlclist.xml from Settings. -
Install Helper page - read-only assistant: pick a mod folder and it lists file types, shows README/changelog text, and explains how to install (add-on/dlcpack,
.asi,.dll,.lua,.oiv,.meta). It never changes anything.
- The Editor is fully manual; the only hard block is
.exe. Every save goes through backup + double-consent, so originals can be restored. - 67 unit tests passing. Self-contained Windows build - keep
GTAV_Mods_Manager.exeand theLocalizationfolder together.
Asset SHA-256 (GTAV_Mods_Manager.exe):
B09DA1CA35C806301D9BF8151A63DF9618EC8ABAF2842297FD6C0CAEB6271BD9
v0.6.0 — 2026-06-07
The sidebar is now a navigation menu that switches between dedicated pages, so the main screen is no longer crowded:
- Game - game-path detection and manual override
-
Install Mods - with sub-tabs: General (files/folders), Menyoo XML (the four
menyooStufffolder buttons), and Add-on (dlcpack folders) - Components - component check, Install Nightly, downloads
- Installed Mods - enable/disable, edit, uninstall, Excel export
- Backup - one-click full backup / restore
Settings, install mode, update check, language, and version stay in the sidebar footer; the status bar is shared across all pages.
- Pure UI restructure - install and safety logic are unchanged (core binaries never modified; double-consent for destructive operations).
- 54 unit tests passing. Self-contained Windows build - keep
GTAV_Mods_Manager.exeand theLocalizationfolder together.
Asset SHA-256 (GTAV_Mods_Manager.exe):
0C61514BBC61BE8AF144437193003E4B6CBFBA2FA00EFB803DE9558B25750F99
v0.5.1 — 2026-06-06
-
Auto-detect: selecting a Menyoo save (
.xml) reads its XML root element and deploys it to the correctmenyooStuffsubfolder. -
Manual placement: a Menyoo XML toggle reveals four buttons that force the file into a chosen subfolder:
menyooStuff\OutfitmenyooStuff\SpoonermenyooStuff\VehiclemenyooStuff\WeaponsLoadout
- Folder names are fixed to match Menyoo's on-disk layout exactly.
Menyoo XML installs through the same pipeline as every other mod (safety gate, conflict detection, double-consent on overwrite, backup, verify, rollback) and supports enable/disable and uninstall.
- New "Menyoo XML Files" chapter in the tri-language user manual; README and Change Log updated.
- 54 unit tests passing; safety rules unchanged (core binaries never modified).
- Self-contained Windows build - keep
GTAV_Mods_Manager.exeand theLocalizationfolder together.
Asset SHA-256 (GTAV_Mods_Manager.exe):
B533F62C171024B425336B462C3EAA0FB13392E432F71D1CFC512E90621A225B
v0.5.0 — 2026-06-06
- Script Hook V .NET nightly: one-click download & install of the latest nightly loader files.
- Enable / Disable mods without uninstalling (files moved to a staging area).
- Automatic update check on startup (toggleable) and on demand.
- Mod conflict detection before installing (warns about overlapping files).
-
One-click full backup / restore of the entire
mods\folder.
- Rewrote the tri-language user manual with a detailed per-feature chapter for every feature.
- 41 unit tests passing; safety rules unchanged (core binaries never modified; double-consent for destructive operations).
- Self-contained Windows build - no .NET install required. Keep
GTAV_Mods_Manager.exeand theLocalizationfolder together.
Asset SHA-256 (GTAV_Mods_Manager.exe):
C12E0ABF99B7714565BC7FD3D4DF50B93838B8A387B0467A88E168C11D2A3CD9
v0.4.0 — 2026-06-06
GTAV Mods Manager v0.4.0 - Install modes, risk gating, add-on vehicles
New:
- Settings with selectable Install Modes: Safe / Assisted (OpenIV) / Advanced (Auto-RPF, EXPERIMENTAL).
- Every settings change requires an 'I know what I'm doing' confirmation.
- Advanced is gated behind a mandatory risk waiver (extreme risk; may corrupt game files; you assume all risk; developers and owner not liable).
- Add-on dlcpack handling: detects folders containing dlc.rpf and deploys to mods\update\x64\dlcpacks.
- Assisted: copies the dlclist.xml line and opens the mods folder for OpenIV.
- Advanced: auto-edits a writable dlclist.xml you configure; uninstall removes the entry and the files.
Note: Advanced does NOT write inside encrypted .rpf archives. It only edits a writable dlclist.xml you provide.
Includes source code (below) and the self-contained Windows x64 build. First run: if SmartScreen warns (unsigned app), click More info -> Run anyway.
SHA-256 (GTAV_Mods_Manager.exe): 737A9025F49A3A58F8907B3407E058CDD933A1638ADFA64001523D6B8BBF3B4D
v0.3.0 — 2026-06-06
GTAV Mods Manager v0.3.0 - Install, track, and export
The mod installation engine is now usable from the UI, with installed-mods tracking and Excel export.
New:
- Install mods from the UI (Select File/Folder -> Install) with the full safety pipeline: safety gate, double-consent dialog, on-demand admin elevation, backup, deploy, verify, rollback.
- Manual game-path browse; component Download buttons.
- Installed Mods list with Edit (curated details) and Uninstall (restores backups).
- Export to Excel (.xlsx): two sheets (Install Mods / Uninstall Mods), nine columns, styled frozen header, hyperlinked Link column, sorted by Name.
Includes source code (below) and the self-contained Windows x64 build. First run: if SmartScreen warns (unsigned app), click More info -> Run anyway.
SHA-256 (GTAV_Mods_Manager.exe): 8201426F8AFC46D26D673CA8539113FA0C35CCDAE8B4E0D33C9AA35F29B83C9B
v0.2.0 — 2026-06-06
GTAV Mods Manager v0.2.0 - Opens without admin
The app now launches WITHOUT administrator rights, so it opens immediately with no UAC prompt. Administrator rights are requested on demand only when installing mods into a folder that needs them.
Changed:
- Launch as asInvoker (no UAC at startup).
Added:
- Elevate-on-demand (ElevationHelper): UAC only when actually writing to a protected folder.
- Logs/backups fall back to %LOCALAPPDATA%\GTAV_Mods_Manager when the .exe folder is read-only.
- "First Run on Windows" docs (SmartScreen / UAC) in all READMEs and the User Manual.
First run note:
- If Windows SmartScreen warns (the app is not code-signed), click "More info" then "Run anyway".
This release includes:
- Source code (auto-attached zip/tar.gz below).
- GTAV_Mods_Manager.exe - self-contained Windows x64 build (no .NET install required).
SHA-256 (GTAV_Mods_Manager.exe): 73555D66175FFA994CA6A23E35FAB4E55255D6FA926A787FA25EDB3E0F3AAD44
v0.1.4 — 2026-06-06
GTAV Mods Manager v0.1.4 - Critical startup fix
Fixes the bug where the app would not open (no GUI). Please use this build.
Fixed:
- Startup crash from a XAML type mismatch (ColumnDefinition.Width bound to a Double instead of GridLength).
- Startup crash from a read-only property bound TwoWay on a TextBox.
Improved:
- The .exe now runs correctly even when copied alone (language packs are embedded).
- Added a global error handler: on failure it writes crash.log next to the .exe and shows an error dialog instead of closing silently.
This release includes:
- Source code (auto-attached zip/tar.gz below).
- GTAV_Mods_Manager.exe - self-contained Windows x64 build (no .NET install required).
Run GTAV_Mods_Manager.exe and approve the administrator prompt.
v0.1.3 — 2026-06-06
GTAV Mods Manager v0.1.3
Adds the project LICENSE (GTAV Mods Manager License).
License summary:
- Free to download and use.
- Modification, re-upload, or derivative works MUST conspicuously credit "Creators: SpaceSquare & Claude Code | Owner: SpaceSquare".
- Ownership stays with SpaceSquare. Provided as-is, no warranty.
- Contact: chin52696411@gmail.com
This release includes:
- Source code (auto-attached zip/tar.gz below).
- GTAV_Mods_Manager.exe - self-contained Windows x64 build (unchanged from v0.1.2; this release contains documentation/license changes only).
v0.1.2 — 2026-06-06
GTAV Mods Manager v0.1.2
A minimalist, safety-first GTA V mod manager (WPF, .NET 8).
This release includes:
- Source code (auto-attached zip/tar.gz below).
- GTAV_Mods_Manager.exe - self-contained Windows x64 build (no .NET install required).
Highlights:
- Game-path detection (Registry/Steam/Epic/Rockstar) with manual override.
- Mod auto-installation engine for .oiv/.asi/.dll/.lua and folders.
- Safety guard: core binaries are never modified; double-consent for overwrites/deletions.
- Automatic backup and rollback.
- Component checker (Script Hook V, Script Hook V .NET, OpenIV, .NET runtime).
- Tri-language UI (English default / Traditional Chinese / Simplified Chinese).
- Tri-language README, Change Log, and User Manual.
Run GTAV_Mods_Manager.exe (it requests administrator rights to write into the game folder). Keep the Localization folder next to the exe if you copy it elsewhere.