> For the complete documentation index, see [llms.txt](https://docs.17movement.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.17movement.net/conflict-tool/understanding-conflicts/occlusion-conflicts.md).

# 👁️ 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.