How to Fix 'Invalid Model' or 'Spawn Name Not Found' in FiveM

Tried to spawn your car and got 'Invalid Model'? A six-point checklist: spawn name, server.cfg, manifest, vehicles.meta, file names and add-on data.

Updated 4 min read9 sections

Have the error in front of you? Paste the F8 console output into the Error Analyzer for the likely cause and fix. Open the Error Analyzer

The Frustration

You installed the mod. You typed /car mycar.

Error: Invalid Model.

The game is telling you it has never heard of a model by that name. It is almost always a naming problem or a resource that is not loaded, and there are only a handful of places to look. (If the car does spawn but you cannot see it, that is a different fault: go to FiveM car invisible.)

Tip

The Resource Inspector checks points 1, 3, 4 and 5 below in one pass. Drop the resource zip or folder in and it names the file that is wrong.

Checklist 1: The Spawn Name

The spawn name is not the name of the resource folder. It is the <modelName> in vehicles.meta, and that has to equal the name of the model file inside the stream folder.

  • Check resources/my-resource/stream/.
  • Do you see police.yft? Then the spawn name is police.
  • Do you see 2024mustang.yft? Then the spawn name is 2024mustang.
  • Open vehicles.meta (in common/ in a converted resource, usually data/ in a hand-built one) and confirm <modelName> says exactly the same thing.

Fix: If the two differ, change one so they match. When you rename model files, rename all of them (name.yft, name_hi.yft, name.ytd) and update <txdName> as well.

Looking for a vanilla car's name rather than an add-on's? Use the vehicle spawn code list.

Checklist 2: The Server Config

Did you actually start the resource?

  1. Open server.cfg.
  2. Look for ensure resource-name.
  3. The name must match the folder name exactly.
  4. In the server console, run refresh and then ensure resource-name and read what it prints.

New resource and not sure where it goes? How to install FiveM car mods has the folder layout.

Checklist 3: The Manifest

Does your fxmanifest.lua exist, directly inside the resource folder?

  • Open it. Does it have fx_version and game 'gta5'?
  • If the file is missing or empty, FiveM ignores the folder entirely.
  • A zip that extracts to mycar/mycar/fxmanifest.lua is a common trap: the manifest must be one level below resources/ (or below a [category] folder), not two.

Checklist 4: The vehicles.meta Is Not Loaded

The model files can be streaming perfectly and the game will still say "Invalid Model" if vehicles.meta was never mounted. The manifest needs both the file listed under files and a matching data_file line:

lua
files {
    'data/vehicles.meta',
}

data_file 'VEHICLE_METADATA_FILE' 'data/vehicles.meta'

Check the path character by character; data/Vehicles.meta and data/vehicles.meta are different files on a Linux host. If the mod came without meta files, generate a set with the free Vehicles.meta Generator (tutorial).

Checklist 5: Awkward File Names

Keep model names short, lowercase and free of spaces. Long names with version suffixes are where mismatches between the model file, the texture dictionary and <modelName> creep in.

  • Bad: 2024_Ford_Mustang_GT_Custom_Edition_v2.yft
  • Good: mustang24.yft

Checklist 6: Manually Extracted Add-Ons

If you pulled the files out of a dlc.rpf yourself, it is easy to take the models and leave the data behind. The metas live in a different part of the archive than the models; converting add-on cars shows where. If you used GTA5 Mods Convertor, the metas and manifest are already in place. If the mod has a gta5-mods.com page, running it through the addon to FiveM converter is usually quicker than hunting for the missing files.

In a merged car pack, one unclosed XML tag in vehicles.meta takes every car in the file down with it: see the common mistakes in creating a car pack by hand.

Still Stuck?

Paste the lines from your F8 or server console into the Error Analyzer. The wiki entry on the invalid model error has the short version of this page.

Summary

  1. <modelName> equals the model file name.
  2. The resource is ensured and the folder name matches.
  3. fxmanifest.lua exists and declares vehicles.meta with a data_file line.
  4. Restart and spawn again.

Have a gta5-mods.com link ready?

Paste it into the converter and download a FiveM resource with the stream folder, meta files and fxmanifest.lua in place.

  • 3 conversions free, no account needed
  • 2 more free if you leave an email
  • After that: $15 once for unlimited conversions and the Pro tools. No subscription, 14-day refund policy