From 03a10b80729068d5300d47a9b4cc46b55422541b Mon Sep 17 00:00:00 2001 From: Krzeszny Date: Sat, 4 Oct 2025 10:44:58 +0000 Subject: [PATCH 1/5] Added troubleshooting steps for crashing on launch --- content/docs/resonite/_index.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md index ae51718..dad7a28 100644 --- a/content/docs/resonite/_index.md +++ b/content/docs/resonite/_index.md @@ -98,6 +98,10 @@ See https://github.com/Yellow-Dog-Man/Resonite-Issues/issues/5152 for more infor 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. +### Crash on launch + +If Resonite crashes after 2 seconds in **both desktop mode and VR mode** and doesn't leave any log files (no main log, no Player.log, no crash log, no proton log with PROTON_LOG=1, only boostrapper log), navigate to `.local/share/Steam/steamapps/compatdata/` (one folder above Resonite) and delete the `2519830` folder. Then verify the integrity of Resonite files in Steam (right-click Resonite and go to Properties>Installed Files>Verify). + ## 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. -- 2.49.1 From 224817adde5e708afddbf9dc416ad3e0acb65985 Mon Sep 17 00:00:00 2001 From: Krzeszny Date: Sat, 4 Oct 2025 10:58:13 +0000 Subject: [PATCH 2/5] Improved formatting --- content/docs/resonite/_index.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md index dad7a28..febf3e6 100644 --- a/content/docs/resonite/_index.md +++ b/content/docs/resonite/_index.md @@ -100,7 +100,13 @@ On GE-Proton9-10 (for example), loading into a world with e.g. a YouTube video o ### Crash on launch -If Resonite crashes after 2 seconds in **both desktop mode and VR mode** and doesn't leave any log files (no main log, no Player.log, no crash log, no proton log with PROTON_LOG=1, only boostrapper log), navigate to `.local/share/Steam/steamapps/compatdata/` (one folder above Resonite) and delete the `2519830` folder. Then verify the integrity of Resonite files in Steam (right-click Resonite and go to Properties>Installed Files>Verify). +Proton data can get corrupted, which will result in crashes on launch. This only applies if you've already replaced OpenComposite with xrizer and such (see above). + +The symptoms are: +- Crashes 2 seconds from launch in **both desktop mode and VR mode** +- No log files (no main log, no Player.log, no crash log, no proton log with PROTON_LOG=1, only the boostrapper log) + +Navigate to compatdata in the folder above Resonite's folder (by default `.local/share/Steam/steamapps/compatdata/`) and delete the `2519830` folder. Then verify the integrity of Resonite files in Steam (right-click Resonite and go to Properties>Installed Files>Verify). ## Controls busted after switching to desktop -- 2.49.1 From 47b4d218ae2ce52eafb3be4c69977c6b37983c2f Mon Sep 17 00:00:00 2001 From: Krzeszny Date: Sat, 4 Oct 2025 11:02:50 +0000 Subject: [PATCH 3/5] slight changes --- content/docs/resonite/_index.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md index febf3e6..4e8c834 100644 --- a/content/docs/resonite/_index.md +++ b/content/docs/resonite/_index.md @@ -88,7 +88,7 @@ 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 +### OpenComposite crash on launching VR Currently, OpenComposite is known to crash Resonite when used in VR, so attempting to use OpenComposite for Resonite is not recommended. @@ -98,15 +98,15 @@ See https://github.com/Yellow-Dog-Man/Resonite-Issues/issues/5152 for more infor 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. -### Crash on launch +### Proton crash on launch -Proton data can get corrupted, which will result in crashes on launch. This only applies if you've already replaced OpenComposite with xrizer and such (see above). +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 **both desktop mode and VR mode** +- 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) -Navigate to compatdata in the folder above Resonite's folder (by default `.local/share/Steam/steamapps/compatdata/`) and delete the `2519830` folder. Then verify the integrity of Resonite files in Steam (right-click Resonite and go to Properties>Installed Files>Verify). +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). ## Controls busted after switching to desktop -- 2.49.1 From b21a4aa93a1a1fca52e4ce1e91a4184cfb5e4b05 Mon Sep 17 00:00:00 2001 From: Krzeszny Date: Sat, 4 Oct 2025 11:17:21 +0000 Subject: [PATCH 4/5] 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. -- 2.49.1 From 6b862182fc9ed598bc144ff915a4c67530f6769b Mon Sep 17 00:00:00 2001 From: Krzeszny Date: Sat, 4 Oct 2025 12:23:48 +0000 Subject: [PATCH 5/5] additional info --- content/docs/resonite/_index.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md index 3218067..cbcf7ac 100644 --- a/content/docs/resonite/_index.md +++ b/content/docs/resonite/_index.md @@ -105,9 +105,12 @@ Proton data can get corrupted, which will result in consistent crashes on launch 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. -- 2.49.1