GTA 5 YMAP files, explained

Updated 2026-07-23

YMAP files are placement lists: they tell GTA 5 what to put where in the world. Every custom map mod, every added building, every parked-car layout on a FiveM server ultimately ships as YMAPs. Reading one used to require desktop tools; the YMAP preview decodes any .ymap to readable XML in your browser.

What a YMAP holds

  • Entities: placed objects, each referencing an archetype by name with a position, rotation, and draw distance.
  • Car generators: the spawn points that produce parked cars, with model and orientation.
  • References to the physics dictionaries and other map data the placements need.

The archetypes themselves live in YTYP files: the YMAP says "put prop_bench_01a here", the YTYP defines what prop_bench_01a is. The YTYP preview decodes those, and for custom props the YTYP generator creates them.

Read a YMAP in the browser

  1. 1Drop the .ymap into the YMAP preview.
  2. 2The decoded XML lists every entity with its archetype name, position, and rotation, plus the car generators.
  3. 3Use it to audit a map mod before installing it, find which YMAP places a particular object, or check coordinates.
  4. 4Download the XML if you want to search or diff it elsewhere. Decoding runs on your device.

YMAPs on a FiveM server

A YMAP streams like any other asset: put it in a resource stream/ folder, ensure the resource, and the placements load. Two practical notes:

  • Entities referencing custom props need the matching YTYP streamed as well, declared with a data_file DLC_ITYP_REQUEST line in the manifest.
  • Removing a map mod means removing its YMAP; leftover placements come from a resource still streaming it.

What about editing?

The browser preview is read only: it decodes and displays. Authoring or editing YMAPs in a visual world context is what desktop CodeWalker excels at; the honest comparison is on the CodeWalker alternative page. A common workflow is: inspect and verify here, edit there when placement work is needed.

Frequently asked questions

Can I open a YMAP without CodeWalker?
Yes, for reading: the YMAP preview decodes any .ymap to XML in your browser. Editing and re-saving is desktop-tool territory.
Why do objects from my map mod not appear?
Usually the YTYP with the custom archetypes is missing or not declared in the manifest. The YMAP alone only places names; the YTYP defines them.
What is a car generator?
A spawn point baked into map data that produces a parked vehicle: model, position, and heading. The preview lists every one in the file.

Tools used in this guide

More guides