From b21a4aa93a1a1fca52e4ce1e91a4184cfb5e4b05 Mon Sep 17 00:00:00 2001 From: Krzeszny Date: Sat, 4 Oct 2025 11:17:21 +0000 Subject: [PATCH] Improvements in diagnosing crashes --- content/docs/resonite/_index.md | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md index 4e8c834..3218067 100644 --- a/content/docs/resonite/_index.md +++ b/content/docs/resonite/_index.md @@ -88,17 +88,17 @@ 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 VR +### 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 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. - -### Proton crash on launch +### 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). @@ -108,6 +108,10 @@ The symptoms are: 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). +### 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. + ## Controls busted after switching to desktop Resonite allows a VR player to take a break and switch to desktop mode by pressing the F8 key.