Removing OcclusionNodes
Finding and Removing Occlusion
Author: spirit
Last update: September 24th 2024
Introduction
If you ever tried to build a structure outside of the usual game bounds and encountered textures popping in and out seemingly at random you have encountered occlusion mesh nodes. This article will explain how to find and remove them, touch on their purpose and provide starting points for optimization.
Occlusion Mesh Example:
Required Tools
Instructions
In the Game
Navigate to the location where you want to remove the occlusion mesh nodes
Open the CET Menu and find World Inspector
Switch to the Scan Tab
Click on Scan world nodes
Make sure the Group is set to All, Distance to 50m or more depending on your area, and Filter to "Occl"
Expand each item in the list to reveal the detailed information
[!NOTE] World Inspector cannot find all occlusion mesh nodes, so trying to remove them using Removal Editor will not remove all actual occlusion mesh nodes from the area.
In Wolvenkit
Create and open a new project in Wolvenkit
Search and
Right Click > Add selected items to project
for each world sector you found in the World Inspector to your project in WolvenkitClick on
Tools > Script Manager
at the topFind the "RemoveOcclusionFromSectors" script and run it
An .xl file that removes the occlusion mesh nodes has now been created in your "resources" folder in Wolvenkit
Open the resources directory in file explorer
Move the file to
{GameDirectory}\archive\pc\mod
Back in the Game
In the "Hot Reload" tool go to the Archives tab and click on reload extensions, now you need load a game save and the occlusion mesh nodes should be removed.
Troubleshooting
If you followed the steps but not all of the occlusion has been removed you can try:
restarting your game fully
increasing the "Distance" in "World Inspector" and redo the steps from that point on
adding world sectors that World Inspector doesn't find occlusion mesh nodes in
Lastly if none of these worked you can join the Discord where we can troubleshoot the issue together.
The Purpose of Occlusion Mesh Nodes
[!NOTE] This section, but especially the optimization part needs further testing and documentation.
They are a performance optimization method that selectively blocks textures that are behind it from being rendered therefore improving fps. But since most other objects also do that the performance loss from removing them in a select few world sectors is almost negligible (assuming there are no holes in the world or they are filled with other props).
Optimization
The simple approach to optimize performance is to add each world sector separately and test which ones remove only the occlusion that is in your way. Another more advanced option is to add new occlusion mesh nodes that consider your structure.
Last updated