FiveM YMAP Merge: Fix Map Conflicts

Two maps edit the same game .ymap and one loses its changes: merge the copies against the game's original into one that keeps both.

Loading Map Merge…

Merge two FiveM maps that edit the same ymap

Many MLOs and map mods ship an edited copy of a game .ymap: to take out the game's building where the interior goes, to move a fence, to add occluders or turn off car generators. FiveM loads only one copy of each file, the one of the resource that starts last, so when two maps edit the same .ymap one of them loses its changes: floating props, missing walls, holes, an interior that vanishes from some angles.

Map Merge compares each copy with the game's original and makes one copy with every map's changes: entities removed, added or moved, flags and LOD distances, car generators, box and model occluders, time cycle boxes, and the LOD links, with numChildren and the extents worked out again. Where both maps changed the same object differently you pick which one stays. You get a small compat resource that starts after the maps, and every merged file is read back and checked first.

How Map Merge works

  1. Drop the map resources that clash, as folders or .zip files.
  2. See what each map changed, and pick the winner where both changed one thing.
  3. Download the compat resource and start it after the maps.

You get: A small FiveM resource with the merged .ymap and .ytyp files, read back and checked, and a README on load order.

Every tool is free to try: 5 exports a day, files up to 25 MB. The paid plans raise the limits. See the plans.

Map Merge: Two maps edit the same game .ymap and one loses its changes: merge the copies against the game's original into one that keeps both.

Questions

How do I fix two FiveM maps that conflict?
When both stream the same game .ymap, drop both resources here and download the compat resource. Start it after the two maps in server.cfg. Map Conflict Check finds which maps clash.
Why merge against the game's original?
Only the original says what each map changed. An object missing from one copy was removed by that map, and an object in only one copy was added by it. Without the base, a merge can't tell a removal from an addition.
What if both maps changed the same object?
It is listed as a conflict with both versions. By default a removal wins over a change, because an object one map took out to make room for its building leaves walls inside the rooms when it comes back.
Does it keep the LOD models right?
Yes. LOD links are matched by which entity they point at, not by number, and written again for the merged file. Maps whose LOD parents moved are written again too.
Can it merge collisions (.ybn)?
Not yet: only .ymap and .ytyp files. Shared collision files are listed, and only one copy of each loads.

In GTA Explorer

Related tools

All 78 GTA V and FiveM tools · More maps & collisions tools