Renderer decoupling

Renderer decoupling (often shortened to just decoupling) is a state of Resonite that enables when FrooxEngine is unable to perform enough updates to meet a certain threshold. In this state, the renderer continues rendering frames irrespective of FrooxEngine until a second threshold is met, in which case decoupling will disable again. Renderer decoupling is intended to smooth out hitches caused by the engine for VR users.

Renderer decoupling was added in Beta 2025.9.1.748.

Settings

The settings available for renderer decoupling.

Settings for renderer decoupling are located in Graphics at the very bottom. The available settings are:

• Activation Framerate: The framerate at which renderer decoupling will enable.
• Deactivation frame count: The amount of frames above the activation framerate before decoupling will disable again. Used to prevent rapid flickering of decoupling enabling/disabling.
• Force Decouple: Forces the decoupling mechanism on. Should only be used for diagnostic purposes.
• Max decoupled asset processing: Maximum amount of time (in milliseconds) that the renderer will spend uploading assets to the GPU when decoupling is active. May increase maximum framerate, but can lower loading performance and might make UI slow to update at low values.

Use as diagnostics

Forcibly decoupling the renderer can provide a simple check to see what side of the game—FrooxEngine or the renderer—is limiting your framerate. This will usually correlate to being "CPU bound" or "GPU bound", respectively. To perform this simple check:

1. Find a stable world or environment to perform the check where your frames per second (FPS) isn't too chaotic.
2. Take note of the approximate range of your FPS.
3. Turn on the Force Decouple option.
4. Note any substantial change to your FPS.

If your FPS increases significantly, you are CPU bound and your normal FPS is the limit of your CPU. Consider trying to optimize some of the environment or upgrading your CPU if it's old. If your FPS remains the same, then your hardware is either roughly equivalent or you are GPU bound. Consider turning down your rendering resolution or other graphics settings.

Remember to disable the force decouple option when you're done diagnosing, as it is not recommended for normal use.