Crashing & Not Loading#

Resonite’s renderer is known to randomly crash suddenly - this is currently tracked at Issue #5325.

There is also a known memory leak when running the renderer on Linux - however, it is uncertain currently whether this is an issue with Proton or there is something else at play - see Issue #5246.

During VR gameplay, the renderer may cause a full GPU Reset if you have an AMD graphics card that is heavily loaded. Check dmesg if this occurs.

Occasional crashing can happen for many reasons, including mods, but Resonite (or .NET) is particularly sensitive to unstable RAM and CPU overclocks, which may occasionally crash .NET where other processes wouldn’t crash. Use memtest86 to test your RAM, and try lowering your CPU and GPU overclocks.

Crashing on launch only in VR#

Resonite crashes when OpenComposite is used in VR.

Symptoms:

  • A black window appears and closes briefly only after launching in VR mode, then Resonite stops within approximately 30 seconds.
  • The normal log file shows a renderer crash: RendererProcess has exited. Shutting down. There’s a Player.log file.

Solution:

Use xrizer, as OpenComposite is unsupported and considered legacy. Make sure your launch arguments don’t point to OpenComposite.

See issue #5152 on Resonite for more information.

Crashing on launch in desktop mode (and VR)#

Symptoms:

  • Resonite stops within 2 seconds from launch, OR
  • Steam shows Resonite is running while it isn’t starting.
  • No log files (no main log, no Player.log, no crash log, no proton log with PROTON_LOG=1, only the bootstrapper log).
  • Error windows show up if you’re using certain mod loaders.

Possible causes and solutions:

  • Not having a default audio device selected
    • Make sure an audio device is selected in your volume panel.
  • Stuck background process, most likely dotnet
    • From easier to more extreme solutions, but you may just reboot:
      • Press STOP in the Steam library and try again.
      • Close/terminate the process that caused it, such as Steam.
      • Relog your user.
      • Reboot your system.
  • Borked Proton version
    • Switch Proton to another variant, such as stable, Proton-CachyOS or Proton-GE.
  • Corrupt Proton data
    • It may be enough to just verify file integrity (right-click Resonite and go to Properties -> Installed Files -> Verify) in some cases.
    • If that didn’t fix it, navigate to compatdata in the directory above Resonite’s folder (by default .local/share/Steam/steamapps/compatdata/) and delete the 2519830 folder; it will regenerate on the next launch.
    • Then verify integrity again.
  • Improperly configured mod loaders and plugins
    • Try starting without any Steam launch options, then re-add them one by one. This is commonly caused by misconfigured MonkeyLoader.

Crash after loading#

On some systems, X11, Proton or wine updates can cause race conditions, crashing Resonite shortly after launch.

Symptoms:

  • Freezes immediately upon loading Local Home or any other world on each startup.
  • Crashes approximately 1 to 2 minutes after successfully loading.
  • Everything freezes in both desktop mode and VR, but you can still hear sounds, including the voices of other users.
  • Regular logs cut off (this symptom is not specific to this issue).

Solutions:

  • Switch Proton to another variant, such as Proton-GE or Proton-CachyOS.
  • Switch from X11 (if you’re using it) to Wayland. Follow your distro’s instructions.
  • Revert package updates (using snapshots is highly recommended) or wait for a hotfix.

Resonite starts, but gets stuck at an empty black screen before the loading screen#

This can have many different reasons, but so far there is only one confirmed reason.

If you encounter this issue and have Resonite installed on a different drive than your OS, moving the game to your OS drive can fix this. This can happen with any drive, not just NTFS drives.

For more info you can read this GitHub issue for Resonite. It seems to be a very rare issue, the exact cause for this behaviour is currently unknown.

Stuck on the loading screen#

When Resonite gets stuck on the gray loading bar, possible causes include:

  • A mod loader is incompatible with a new Resonite update.
  • A driver crashed and didn’t recover.

Make sure your mod loaders are updated and properly installed. If that didn’t help, restart your system.

Crash while playing#

Refer to the first section.