From 52b93d4dc1812e058e1e17affef2d8145405d194 Mon Sep 17 00:00:00 2001 From: bredo Date: Thu, 21 Aug 2025 22:08:55 +1200 Subject: [PATCH 1/9] Resonite: remove mention of ResonitePlatformSpoof Now that The Splittening has released and FrooxEngine runs on Linux natively, ResonitePlatformSpoof is no longer needed for the tux badge. --- content/docs/resonite/_index.md | 14 -------------- 1 file changed, 14 deletions(-) diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md index c935245..8835691 100644 --- a/content/docs/resonite/_index.md +++ b/content/docs/resonite/_index.md @@ -59,20 +59,6 @@ You can load RML mods with MonkeyLoader but not the other way around. The exact cause of this is currently unknown. Consider using MonkeyLoader if you encounter such issues starting the game as it seems to not cause the same problem. -### ResonitePlatformSpoof - -- [Mod Repo](https://github.com/isovel/ResonitePlatformSpoof) -- [Link to working version](https://github.com/isovel/ResonitePlatformSpoof/issues/2#issuecomment-2439588723) - - -{{% hint info %}} - -See [issue #2745](https://github.com/Yellow-Dog-Man/Resonite-Issues/issues/2745#issuecomment-2573574108) for more context as to why the Linux badge isn't available for Proton users. - -{{% /hint %}} - -When the native Linux build of Resonite was still available, players are given a Linux badge to show others that they are running the native build of the client. When Proton is used to play the windows build of the game, you will not get the Linux badge. However, ResonitePlatformSpoof lets you 'spoof' your platform to the Linux native build and allows proton users to get the Linux badge. - ## Crashes Resonite has been seen causing random SteamVR crashes on Linux before. In some situations the engine also tends to freeze. On OpenComposite, the game will rarely close out on its own without leaving any obvious trace of things going wrong — this is being investigated. -- 2.49.1 From 16301492780d2f492c2056de1a9a35e0d1cc397d Mon Sep 17 00:00:00 2001 From: bredo Date: Thu, 21 Aug 2025 22:19:22 +1200 Subject: [PATCH 2/9] Resonite: the splittening is released Resonite technically runs natively on Linux now, but Proton is still required for the renderer. --- content/docs/resonite/_index.md | 29 +---------------------------- 1 file changed, 1 insertion(+), 28 deletions(-) diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md index 8835691..2ad6e13 100644 --- a/content/docs/resonite/_index.md +++ b/content/docs/resonite/_index.md @@ -5,12 +5,6 @@ weight: 50 # Resonite -{{% hint info %}} - -**Note**: The Linux-native version of Resonite, amid deprioritization of developer time to fix its numerous issues, was put on indefinite hold in August 2024 and later removed in March 2025. This document only covers running under Proton. - -{{% /hint %}} - {{% hint warning %}} Steam will sometimes try and run Resonite without using Proton. This may be due to the removal of the Linux native build. @@ -36,9 +30,7 @@ To solve this, prepend `OXR_PARALLEL_VIEWS=1` to Resonite's launch options. ## Performance -Resonite currently runs under an extremely old version of Mono runtime required by Unity, which has very poor Garbage Collection causing frequent lag spikes and frame hitching during asset loading and unloading. Very soon, Resonite will be updated to use .NET 9, a far more modern and bespoke runtime, with Unity running on a separate thread only for rendering the game. Eventually Unity will be replaced by a custom rendering engine as well. - -The main developer and owner of Resonite goes into more detail [here](https://youtu.be/9cx2-VtL_LM&t=16). +In August 2025, Resonite updated to run FrooxEngine as a native Linux process, with the renderer being run through Proton. In larger sessions Resonite is typically CPU-bound, there isn't much that can be done besides upgrading your CPU. In situations where the GPU is a bottleneck, lowering the resolution (either in the OpenXR runtime or through OpenComposite) may help dramatically. This can be easily done by prepending `OXR_VIEWPORT_SCALE_PERCENTAGE=75` to Resonite's launch options. Experiment with different values to find your preferred balance between performance and quality. @@ -76,22 +68,3 @@ Resonite allows a VR player to take a break and switch to desktop mode by pressi Because controller hot-swapping is not yet implemented in Monado & OpenComposite, turning off a controller will freeze its state, including buttons pressed and analog stick input. Resonite will continue processing VR inputs even after switching to desktop. The end result is that desktop controls can act strangely. For example, if you were holding the grab sensor as you turned off the VR controller, picking up items or inspector windows stops working with the mouse. - -## Splittening - -{{% hint info %}} - -The Splittening is currently in pre-release. Linux should work OOTB, albeit a few issues. - -{{% /hint %}} - -{{% hint warning %}} - -The Splittening being in pre-release may have visual glitches. As such it is not recommended if you have any form of epilepsies. Please be warry of that. - -{{% /hint %}} - -The Splittening is still in active development, as such the linux support still varies a lot. -please use [this repository](https://github.com/baplar/resonitelinuxsplitteningpatches?tab=readme-ov-file) for any up to date information - -for VR support: OpenComposite appear to crash. Please use xrizer instead. -- 2.49.1 From df154f83649265adab1f4cf035846c83df1ffe5f Mon Sep 17 00:00:00 2001 From: bredo Date: Thu, 21 Aug 2025 22:21:34 +1200 Subject: [PATCH 3/9] Resonite: change wording of Proton warning --- content/docs/resonite/_index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md index 2ad6e13..81cadc5 100644 --- a/content/docs/resonite/_index.md +++ b/content/docs/resonite/_index.md @@ -7,7 +7,7 @@ weight: 50 {{% hint warning %}} -Steam will sometimes try and run Resonite without using Proton. This may be due to the removal of the Linux native build. +Steam will sometimes try and run Resonite without using Proton. Despite the main process running natively, Proton is still required for the renderer. If Resonite fails to start, you may need to force Proton to be used. -- 2.49.1 From a77aa3f14fa8de0ea92ad8e05fae04113b66c232 Mon Sep 17 00:00:00 2001 From: bredo Date: Fri, 22 Aug 2025 07:03:06 +1200 Subject: [PATCH 4/9] Resonite: remove mention about needing to force Proton This has apparently been fixed: https://github.com/Yellow-Dog-Man/Resonite-Issues/issues/5303 https://gitlab.com/lvra/lvra.gitlab.io/-/merge_requests/132#note_2700847834 --- content/docs/resonite/_index.md | 8 -------- 1 file changed, 8 deletions(-) diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md index 81cadc5..78d5aab 100644 --- a/content/docs/resonite/_index.md +++ b/content/docs/resonite/_index.md @@ -5,14 +5,6 @@ weight: 50 # Resonite -{{% hint warning %}} - -Steam will sometimes try and run Resonite without using Proton. Despite the main process running natively, Proton is still required for the renderer. - -If Resonite fails to start, you may need to force Proton to be used. - -{{% /hint %}} - The current recommended Proton variant is [**Proton GE**](https://github.com/GloriousEggroll/proton-ge-custom/releases/latest). [XRizer](/docs/fossvr/xrizer/) should now provide a close-to-flawless experience on most controllers and when using hand tracking. If you encounter any major issues you can fallback to [OpenComposite](/docs/fossvr/opencomposite/). -- 2.49.1 From 9474ce775926b9244f912fd7400589a9713ac1e6 Mon Sep 17 00:00:00 2001 From: bredo Date: Fri, 22 Aug 2025 07:07:28 +1200 Subject: [PATCH 5/9] Resonite: Mention OpenComposite crashing https://github.com/Yellow-Dog-Man/Resonite-Issues/issues/5152 --- 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 78d5aab..3120a68 100644 --- a/content/docs/resonite/_index.md +++ b/content/docs/resonite/_index.md @@ -7,7 +7,7 @@ weight: 50 The current recommended Proton variant is [**Proton GE**](https://github.com/GloriousEggroll/proton-ge-custom/releases/latest). -[XRizer](/docs/fossvr/xrizer/) should now provide a close-to-flawless experience on most controllers and when using hand tracking. If you encounter any major issues you can fallback to [OpenComposite](/docs/fossvr/opencomposite/). +[XRizer](/docs/fossvr/xrizer/) should now provide a close-to-flawless experience on most controllers and when using hand tracking. ## Visual bugs @@ -49,6 +49,12 @@ Resonite has been seen causing random SteamVR crashes on Linux before. In some s The cause of these issues and whether they are Proton-specific isn't currently known. +### OpenComposite + +Currently, OpenComposite is known to crash Resonite when used in VR, so attempting to use OpenComposite for Resonite is not recommended. + +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. -- 2.49.1 From 8cde6c33c1f13b673a5c9a39360ba67334d7fadb Mon Sep 17 00:00:00 2001 From: bredo Date: Fri, 22 Aug 2025 07:12:55 +1200 Subject: [PATCH 6/9] Resonite: Add section about viseme analysis on Linux --- content/docs/resonite/_index.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md index 3120a68..f4d34eb 100644 --- a/content/docs/resonite/_index.md +++ b/content/docs/resonite/_index.md @@ -27,6 +27,12 @@ In August 2025, Resonite updated to run FrooxEngine as a native Linux process, w In larger sessions Resonite is typically CPU-bound, there isn't much that can be done besides upgrading your CPU. In situations where the GPU is a bottleneck, lowering the resolution (either in the OpenXR runtime or through OpenComposite) may help dramatically. This can be easily done by prepending `OXR_VIEWPORT_SCALE_PERCENTAGE=75` to Resonite's launch options. Experiment with different values to find your preferred balance between performance and quality. +## Visemes + +Currently, viseme analysis does not work on Linux due to Meta not providing a Linux native build of OVRLipSync (https://github.com/Yellow-Dog-Man/Resonite-Issues/issues/5151#issuecomment-3170453491) + +There is an experimental mod developed by the community that allows for viseme analysis under Linux - https://github.com/KyuubiYoru/VisemesAtHome. + ## Mods Resonite has a thriving modding community with an abundance of [mods](https://wiki.resonite.com/Mods) that offer greater user experience, optimizations and new features. -- 2.49.1 From 7f24920de4aad066782ab82f0e711e685f88a7c5 Mon Sep 17 00:00:00 2001 From: bredo Date: Fri, 22 Aug 2025 08:18:02 +1200 Subject: [PATCH 7/9] Resonite: remove mention of texture bugs https://gitlab.com/lvra/lvra.gitlab.io/-/merge_requests/132#note_2701862285 --- content/docs/resonite/_index.md | 4 ---- 1 file changed, 4 deletions(-) diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md index f4d34eb..c97d996 100644 --- a/content/docs/resonite/_index.md +++ b/content/docs/resonite/_index.md @@ -10,10 +10,6 @@ The current recommended Proton variant is [**Proton GE**](https://github.com/Glo [XRizer](/docs/fossvr/xrizer/) should now provide a close-to-flawless experience on most controllers and when using hand tracking. -## Visual bugs - -There are some minor visual bugs specific to running Resonite on Proton, such as textures taking longer to load and appearing black for a few seconds when close to the player. - ## Mirrors look cross-eyed When playing Resonite under [Monado](https://lvra.gitlab.io/docs/fossvr/monado/) or [WiVRn](https://lvra.gitlab.io/docs/fossvr/wivrn/), the 3D effect of mirrors may appear way off, as if looking through them feels like your eyes are crossed. This only affects headsets with canted displays (e.g. Valve Index, Pimax). -- 2.49.1 From dd5a19ac80a71e7bb6a15dece055ed96f4f68e9c Mon Sep 17 00:00:00 2001 From: bredo Date: Fri, 22 Aug 2025 08:19:05 +1200 Subject: [PATCH 8/9] Apply 1 suggestion(s) to 1 file(s) Co-authored-by: hypevhs <4498312-hypevhs@users.noreply.gitlab.com> --- content/docs/resonite/_index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md index c97d996..0443f42 100644 --- a/content/docs/resonite/_index.md +++ b/content/docs/resonite/_index.md @@ -20,7 +20,7 @@ To solve this, prepend `OXR_PARALLEL_VIEWS=1` to Resonite's launch options. In August 2025, Resonite updated to run FrooxEngine as a native Linux process, with the renderer being run through Proton. -In larger sessions Resonite is typically CPU-bound, there isn't much that can be done besides upgrading your CPU. In situations where the GPU is a bottleneck, lowering the resolution (either in the OpenXR runtime or through OpenComposite) may help dramatically. +Resonite is typically GPU-bottlenecked. Lowering the resolution may help. This can be easily done by prepending `OXR_VIEWPORT_SCALE_PERCENTAGE=75` to Resonite's launch options. Experiment with different values to find your preferred balance between performance and quality. ## Visemes -- 2.49.1 From 0badd456b422b2d9eea859e6b20ffb353d17be55 Mon Sep 17 00:00:00 2001 From: bredo Date: Fri, 22 Aug 2025 08:31:14 +1200 Subject: [PATCH 9/9] Resonite: Mention issues with renderer on Linux --- content/docs/resonite/_index.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md index 0443f42..8803fa0 100644 --- a/content/docs/resonite/_index.md +++ b/content/docs/resonite/_index.md @@ -47,9 +47,11 @@ The exact cause of this is currently unknown. Consider using MonkeyLoader if you ## Crashes -Resonite has been seen causing random SteamVR crashes on Linux before. In some situations the engine also tends to freeze. On OpenComposite, the game will rarely close out on its own without leaving any obvious trace of things going wrong — this is being investigated. +### Renderer issues -The cause of these issues and whether they are Proton-specific isn't currently known. +Resonite's renderer is known to randomly crash suddenly - this is currently tracked at https://github.com/Yellow-Dog-Man/Resonite-Issues/issues/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 https://github.com/Yellow-Dog-Man/Resonite-Issues/issues/5246. ### OpenComposite -- 2.49.1