diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md index ae51718..cbcf7ac 100644 --- a/content/docs/resonite/_index.md +++ b/content/docs/resonite/_index.md @@ -88,12 +88,29 @@ Resonite's renderer is known to randomly crash suddenly - this is currently trac 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 https://github.com/Yellow-Dog-Man/Resonite-Issues/issues/5246. -### OpenComposite +### Crash on launching in VR mode Currently, OpenComposite is known to crash Resonite when used in VR, so attempting to use OpenComposite for Resonite is not recommended. +Symptoms: +- Crashes only in VR mode, where after several seconds a black window appears and closes briefly, 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. + See https://github.com/Yellow-Dog-Man/Resonite-Issues/issues/5152 for more information. +### Crash on launching in desktop & VR mode + +Proton data can get corrupted, which will result in consistent crashes on launch. This only applies if you've already replaced OpenComposite (see above). + +The symptoms are: +- Crashes 2 seconds from launch in desktop mode (and in VR) +- No log files (no main log, no Player.log, no crash log, no proton log with PROTON_LOG=1, only the boostrapper log) +- It may be accompanied by error windows if you're using a mod loader. + +Navigate to compatdata in the folder 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 the integrity of Resonite files in Steam (right-click Resonite and go to Properties>Installed Files>Verify). + +It may be enough to just verify file integrity in some cases. + ### Crash on loading into a world with video players On GE-Proton9-10 (for example), loading into a world with e.g. a YouTube video or live stream can crash the game. Try using the latest GE-Proton-RTSP release.