SP to FiveM Converter

SP to FiveM Converter

Converts a single-player add-on vehicle pack directly into a ready-to-use FiveM resource — no OpenIV/CodeWalker manual extraction step required.

Scope: vehicle/add-on packs only. Script mod conversion is a possible future extension, not scheduled.

How it works

The converter reads the SP add-on pack's dlc.rpf directly (including any vehicles.rpf nested inside it) and writes out data/, stream/, and a glob-based fxmanifest.lua that follows the community-standard "Add-on Car Globbing Template" convention.

gtavmm convert-vehicle path/to/dlc.rpf path/to/output-folder

The output folder is created if it doesn't exist. Point FiveM's resources\ folder at it (or copy it there) and add it to your load order — see Advanced Tools § FiveM resource load order for the tool that writes the ensure line into server.cfg for you.

What's been verified

Tested end-to-end against four real SP add-on vehicle mods, not just synthetic fixtures:

1. A single vehicle with no carcols.meta.
2. A ~390MB tuning pack with carcols.meta, including 12 nested per-language dlc.rpf archives — their .gxt2 localization files are correctly skipped, not misparsed.
3. A mod at a non-ASCII (Chinese) source path, which also introduced a previously-unseen caraddoncontentunlocks.meta file type — handled correctly by the converter's "don't guess, collect every .meta file" design rather than a hardcoded allowlist.
4. A single DLC declaring 16 vehicles (48 streamed files, no filename collisions).

Known unknown: a vehicles.rpf nesting a third level of archive hasn't been seen in any sample yet, so it's untested.

After converting

The converted resource still needs to be added to server.cfg — it isn't done automatically by convert-vehicle itself. See Advanced Tools.