Skip to content

Add-on vehicles

Use a dlc resource for an add-on vehicle. VIMP accepts loose streaming files; do not wrap them in dlc.rpf.

toml
type = "dlc"
main = "stream.toml"
toml
files = ["stream"]

[meta]
"stream/handling.meta" = "HANDLING_FILE"
"stream/vehicles.meta" = "VEHICLE_METADATA_FILE"
"stream/carcols.meta" = "CARCOLS_FILE"
"stream/carvariations.meta" = "VEHICLE_VARIATION_FILE"

The referenced stream/ directory typically contains:

text
stream/
├─ meteor.yft
├─ meteor_hi.yft
├─ meteor.ytd
├─ handling.meta
├─ vehicles.meta
├─ carcols.meta
└─ carvariations.meta

For dlc, streamed file extensions are limited to yft, ytd, and ydr. Declare metadata explicitly using the supported data-file type. Keep model and metadata identifiers consistent with the asset's original add-on package.

After connecting with the resource mounted, create the model through its GTA name hash:

ts
const vehicle = vimp.vehicles.create(
  vimp.hash('meteor'),
  94.5,
  -1940.2,
  20.7,
  307,
)

If you change the active mounted package during the same GTA process, restart GTA before reconnecting. This prevents stale model and metadata registrations.

VIMP developer documentation