Configuring Nanite Proxy Mesh Generation

Generate and manage proxy meshes to maintain visual consistency when Nanite data is unavailable or not fully loaded.

In this lesson, you will learn how to configure Nanite Proxy Meshes to ensure your world remains visually consistent during streaming transitions or when Nanite data is not yet fully resident in memory.

The Role of Proxy Meshes

Even with Nanite’s advanced virtualization, there are moments—such as initial level load, rapid camera movement, or memory pressure—where high-detail Nanite geometry cannot be fully streamed into the GPU. Without a fallback, you might see "popping" or invisible objects. A Proxy Mesh acts as a lightweight, low-poly surrogate that takes the place of your complex Nanite geometry until the high-fidelity data is ready.

Configuring the Proxy

To set this up, you navigate to the Static Mesh Editor for your Nanite-enabled asset. In the Nanite Settings panel, you will find the Proxy Triangle Percent and Proxy Method configurations.

Proxy Triangle Percent: This determines the complexity of your fallback mesh. A lower value reduces memory footprint, while a higher value keeps the proxy closer to the silhouette of your original high-poly asset.
Proxy Method: You can choose between Default, which relies on the automatic reduction algorithms, or Custom, which allows you to plug in a specific low-poly static mesh as the fallback.

For most cases, using the automated proxy generation is sufficient. Once configured, Unreal Engine automatically swaps between the proxy and the Nanite representation based on the r.Nanite.ProxyRenderMode console variable.

Integration Workflow

When you import or enable Nanite, Unreal performs a cluster-based mesh decomposition. If you find your proxies are causing visual artifacts at a distance, you can adjust the mesh settings:

// Example: Adjusting proxy settings via Python or Blueprint 
// is usually handled in the Static Mesh Settings asset properties.
// In-engine, you focus on the "Fallback Triangle Percent" 
// located within the Nanite Settings of the mesh editor.

By balancing your proxy triangle budget against your target frame rate, you eliminate the visual "void" that occurs while Nanite's virtualized data streams in. This provides a seamless, stable transition for players navigating dense environments.

Key Takeaway: Nanite Proxy Meshes serve as critical visual placeholders that maintain the object's silhouette and world presence during streaming latency, preventing rendering gaps in complex scenes.