From 4ba79b1f585c36f436320dc292a2655ff011bee7 Mon Sep 17 00:00:00 2001 From: Marcus Howser Date: Wed, 14 May 2025 03:00:54 -0700 Subject: [PATCH 1/2] restructure, add modding info (cherry picked from commit ac3b5ca3f85572045656d3670d879a2f3f7723d2) Co-authored-by: Marcus Howser --- content/docs/resonite/_index.md | 28 +++++++++++++++++++++++----- 1 file changed, 23 insertions(+), 5 deletions(-) diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md index e49601c..8a87f61 100644 --- a/content/docs/resonite/_index.md +++ b/content/docs/resonite/_index.md @@ -25,18 +25,36 @@ When playing Resonite under [Monado](https://lvra.gitlab.io/docs/fossvr/monado/) To solve this, prepend `OXR_PARALLEL_VIEWS=1` to Resonite's launch options. +## Performance + +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. + +## Mods + +Much unlike [VRChat](/docs/vrchat/), Resonite has a thriving modding community with an abundance of [mods](https://wiki.resonite.com/Mods) that offer greater user experience, optimizatons and new features. + +Currently there are 2 mod loaders: + +- [ResoniteModLoader (RML)](https://github.com/resonite-modding-group/ResoniteModLoader) + +- [MonkeyLoader](https://github.com/ResoniteModdingGroup/MonkeyLoader.GamePacks.Resonite) + +You can load RML mods with MonkeyLoader but not the other way around. + + +### Resonite randomly gets stuck on initial loading screen when using RML + +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. + ## 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. The cause of these issues and whether they are Proton-specific isn't currently known. -## Performance -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. - -## Crash on loading into a world with video players +### 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. From 0fda74acd0f51acee92d72469f33698cf71370aa Mon Sep 17 00:00:00 2001 From: Marcus Howser Date: Wed, 14 May 2025 03:03:26 -0700 Subject: [PATCH 2/2] remove newlines --- content/docs/resonite/_index.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/content/docs/resonite/_index.md b/content/docs/resonite/_index.md index 8a87f61..b360157 100644 --- a/content/docs/resonite/_index.md +++ b/content/docs/resonite/_index.md @@ -42,7 +42,6 @@ Currently there are 2 mod loaders: You can load RML mods with MonkeyLoader but not the other way around. - ### Resonite randomly gets stuck on initial loading screen when using RML 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. @@ -53,7 +52,6 @@ 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. - ### 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.