👁️ Occlusion Conflicts

Occluders are invisible culling volumes stored inside YMAPs. GTA V uses them to avoid rendering geometry that should not currently be visible.

When an occluder is wrong, entire buildings or interiors can disappear even though the actual model files are still present.

When is it a conflict?

An occlusion conflict exists when two or more resources override the same YMAP and disagree about a vanilla occluder.

Conflict Tool classifies these disagreements based on what each resource changed.

Common cases

Case	What happened	Auto-resolve?	Why
Removal propagate	One resource deleted the occluder while others still contain it	✅	The deletion is unambiguous and can be mirrored
Mesh merge	Resources changed different, non-overlapping parts of the occluder mesh	✅	The edits can be combined safely
Move mirror	One or more resources moved it and all agree on the same destination	✅	Everyone agrees on the target position
Deleted vs reshaped	One resource deleted it while another reshaped its mesh	❌	The intended result cannot be proven
Mesh edits clash	Multiple resources changed the same mesh area differently	❌	Merging could duplicate geometry and over-cull the world
Moved apart	Resources moved the occluder to different locations	❌	Conflict Tool cannot know which position is intended

Why removing an occluder can sometimes be safer

For ambiguous occlusion conflicts, the suggested safe fallback may be to remove every copy.

That prevents an incorrect occluder from hiding geometry, but it is still treated as a review decision when the tool cannot prove that removal matches the map author's intent.

Manual inspection

The panel explains who:

• deleted the occluder,

• reshaped it,

• moved it,

• or kept it unchanged.

You can then inspect the location in-game and choose the intended result.