Add an entry for shader issues caused by noexec for unity

This commit is contained in:
Myra
2025-09-09 21:56:07 +00:00
committed by hypevhs
parent 30a878a018
commit 03b66e3291

View File

@@ -142,6 +142,18 @@ A dialog may appear upon trying to build an avatar, where none of the buttons ar
This seems to happen consistently if the projects are stored on an EXFAT partition. Consider using another filesystem, such as NTFS if you still need projects accessible under both Windows and Linux.
### Built avatar appears non-stereoscopic to me and everyone else
Ensure the filesystem your project is on has not been mounted with `noexec`.
With `noexec`, the shader compilation plugin from VRCSDK will fail with a warning:
> Plugins: Couldn't open /run/media/blahblahblah/MyProject/Packages/com.vrchat.base/Editor/VRCSDK/ShaderCompilerPlugin/Plugins/Linux/x86_64/libvrc_shader_compiler_plugin.so, error: [...]: failed to map segment from shared object
Even though the plugin fails to load, the avatar will upload anyway, without including the Double Wide Rendering shader variants necessary for VR.
The `noexec` mount option may also contribute to other issues such as being unable to run any binaries from inside the project, such as avatar patchers.
### Crashing frequently with Nvidia
On some systems running Nvidia graphics, the Unity Editor may crash frequently from common actions like importing a unitypackage or dragging a file.