What is a .ytd file?
A .ytd file (texture dictionary) is the GTA V container format that bundles a set of textures, stored as compressed images with their mipmaps, under one name. Every vehicle has at least one: mycar.ytd holds the paint, interior, light and badge textures used by the model in mycar.yft. On a FiveM server, .ytd files sit in the stream folder of a resource, and they are the most common reason a car resource is too heavy to stream reliably.
What a .ytd contains
A texture dictionary is a list of named textures. Each texture has a width and height, a pixel format (see DXT and BC compression) and a chain of mipmaps. The materials inside a model do not embed images; they refer to textures by name, and the game looks those names up in the dictionary that belongs to the model.
For a vehicle, that dictionary is the one named by the <txdName> tag in vehicles.meta. If a texture is not found there, the game continues in the parent dictionaries listed under <txdRelationships>, which is how many cars share common textures from vehshare.ytd.
To fix this in an existing resource, the Texture Optimizer shrinks oversized .ytd files in your browser. Open the Texture Optimizer
File names for a vehicle
| File | Purpose |
|---|---|
mycar.ytd | Main dictionary: body, interior, lights, badges |
mycar+hi.ytd | Optional higher-resolution versions of the same textures, used at close range |
vehshare.ytd | Base game dictionary of textures shared by many vehicles |
The base name must match the model: mycar.yft goes with mycar.ytd. In a FiveM resource both files go in the stream folder. They are picked up by file name, so nothing has to be added to the manifest.
Size and the 16 MiB warning
Texture memory grows with the square of the resolution, which is why a handful of 4K textures outweighs everything else in a car. The numbers below are for one texture without mipmaps; a full mip chain adds about a third.
| Resolution | DXT1 | DXT5 | Uncompressed 32-bit |
|---|---|---|---|
| 1024 x 1024 | 0.5 MiB | 1 MiB | 4 MiB |
| 2048 x 2048 | 2 MiB | 4 MiB | 16 MiB |
| 4096 x 4096 | 8 MiB | 16 MiB | 64 MiB |
FiveM warns about any streamed asset that needs more than 16 MiB of memory once loaded. The warning gets stronger at 32, 48 and 64 MiB, and the larger the asset the more likely it is to fail to load on clients. A single 4096 px DXT5 texture reaches 16 MiB on its own. The warning is not a block, and it counts memory, not the compressed file size on disk. The "16 MB limit" guide covers it in detail.
Common problems and fixes
- Car is untextured (plain white, grey or oddly shiny): the dictionary did not load. Check that the .ytd name matches
<txdName>and the .yft name, and that the file is not oversized. - Textures stay blurry up close: the client is short on texture memory. See texture loss and the texture budget.
- Oversized asset warning in the server console: reduce the resolution of the largest textures and convert uncompressed ones to DXT.
The Texture Optimizer shrinks a .ytd in the browser by dropping the largest mip level, which needs no recompression. For a whole server folder at once, Glory Optimizer is the desktop batch tool. To edit individual textures by hand, open the file in OpenIV.
Frequently asked questions
How do I open a .ytd file?
On Windows, OpenIV opens .ytd files and lets you view, export and replace each texture. To only reduce the size of a .ytd for FiveM, the browser-based Texture Optimizer on this site works without installing anything.
What is the maximum .ytd size for FiveM?
There is no hard maximum. FiveM warns about any streamed asset that needs more than 16 MiB of memory once loaded, and the further above that it is, the more likely it fails to load for players. Memory is larger than the file size on disk, so read the server console to see the real figure.
What is the difference between .ytd and .yft?
A .yft is the 3D model of the vehicle and a .ytd is the set of textures applied to it. Both share the same base name and both are needed for the car to appear correctly.
Tools for this
Related guides
Related terms
Still need the car as a FiveM resource?
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