Docs

Fix map flickering

Flickering — where buildings, interiors or props rapidly appear and disappear, or two surfaces fight over the same space (z-fighting) — is one of the most common symptoms of a map conflict on a FiveM / GTA V server. It almost always comes from an occlusion conflict.

Why it happens

Occlusion data inside .ymap files tells the engine what can be hidden behind what. When two map mods both edit the same area, only one resource's occlusion loads — the other map's geometry no longer matches it, so the engine flickers between what it thinks is visible. Loading one resource over another doesn't fix it because the conflict is in the data itself, not the load order.

The fix: merge, don't override

Luman Hub merges the conflicting .ymap data so both maps' placement and occlusion coexist in one resource. Point it at your resources, let it detect the occlusion conflict, merge, and load the single output resource last in server.cfg. The flickering stops because there's no longer a contradiction for the engine to resolve.