What is a .yft file?
A .yft file (fragment) is the GTA V model format for objects made of several physical parts, which includes every vehicle. It stores the 3D mesh at several levels of detail, the materials that reference textures, the skeleton of bones for wheels, doors and seats, and the collision shapes and physics data that let parts open, deform or break off. A FiveM vehicle resource streams one .yft, and usually a second high-detail _hi.yft, per car.
What a .yft contains
- Drawable: the visible mesh, stored at up to four levels of detail (see LOD).
- Shaders: one material per surface type, each naming a shader such as vehicle paint or glass and the textures it samples from the .ytd.
- Skeleton: named bones the game drives directly, for example
chassis, the wheels, doors, bonnet, boot, seats, lights andextra_1onwards. - Bounds: simplified collision shapes used for physics instead of the visible mesh.
- Fragment data: how the model splits into physical children, which is what lets doors swing, glass shatter and bumpers fall off.
The fragment part is what separates a .yft from a .ydr, the plain drawable format used for static props that never come apart.
A .yft made for GTAV Legacy is one of the file types Cfx.re's Alchemist tool converts for FiveM on GTAV Enhanced. That is a separate step from turning a single-player mod into a resource: see Alchemist vs mod converters.
File names for a vehicle
| File | Purpose |
|---|---|
mycar.yft | Standard model, with collision and the lower levels of detail |
mycar_hi.yft | High-detail model shown when the vehicle is close to the camera |
mycar_spoiler1.yft and similar | Tuning parts, referenced by model name from a mod kit in carcols.meta |
The base name is the vehicle's spawn name: it must equal <modelName> in vehicles.meta. Renaming only the file, or only the meta entry, produces a car that cannot be spawned.
Have the resource on disk already? The Resource Inspector checks its manifest, stream files, textures and metas in your browser. Open the Resource Inspector
Where it goes in a FiveM resource
All .yft files go in the stream folder, next to their texture dictionaries. They are registered by file name and need no line in fxmanifest.lua.
mycar/
fxmanifest.lua
data/
vehicles.meta
handling.meta
carvariations.meta
stream/
mycar.yft
mycar_hi.yft
mycar.ytdCommon problems and fixes
- Car is invisible or will not spawn: the .yft did not load. Check the name against
<modelName>, check that the resource is started, and check the file size. The invisible car guide lists every cause. - Sharp up close but a blob at distance, or the reverse: only one of
mycar.yftandmycar_hi.yftis loading. - Oversized asset warning: models with very dense meshes or textures embedded in the model can pass the 16 MiB mark. Moving embedded textures to the .ytd and removing unused tuning parts are the least destructive fixes.
- Tuning parts missing in the mod shop: the part .yft files are present, but the mod kit in carcols.meta is not linked or its ID clashes with another car.
The Resource Inspector checks a resource for name mismatches between models, textures and metas and lists the largest files.
Frequently asked questions
What is the difference between mycar.yft and mycar_hi.yft?
The _hi.yft file holds the most detailed version of the model and is used when the vehicle is near the camera. The plain .yft holds the lower levels of detail and the collision data and is used at distance.
How do I open or edit a .yft file?
OpenIV can preview a .yft and show its textures and bones. Changing the mesh itself requires a 3D tool with GTA V support, such as ZModeler or Blender with the Sollumz plugin.
Do I need to list .yft files in fxmanifest.lua?
No. Files in a folder named stream are registered automatically. Only meta files and scripts are listed in the manifest.
Tools for this
Related guides
Related terms
More in Game Files & Archives: dlc.rpf
Skip the manual work
Paste a gta5-mods.com vehicle link and get a FiveM-ready resource with the manifest and metas in place. 3 free conversions, no signup.
- 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