SDK Bug & Feature Requests

Please check out the following rules and use the provided template when posting a bug report! Off-topic posts will be deleted.http://bit.ly/vrchat-bug-reports

Quest Particle Shader!!

Since 3.10 came out the option for "mobile multiply/additive" are broken!! across all SDK versions!! They work in unity and the sdk allows us to select them, but they break in game! I AM aware "vrc does not support transparency on quest" yet myself and MANY other creators have been using these shaders for at least over a year and have had NO issues until now!! I ask that you please look into this as MANY of us cannot create for quest until you fix it! : /

I am unable to upload my avatar using the latest VRCSDK3

[3.7.5+] Parallel Import encounters null exception following migration from VRCSettings to VRCPackageSettings

With SDK version 3.7.5 several settings were migrated from the static class VRCSettings , existing within the VRCSDKBase-Editor.dll library provided alongside the SDK to VRCPackageSettings , the change also included a refactor of the class, introducing a static property Instance , used to get or create an instance of the class, an instance is attempted to be created by the PerceptualPostProcessor as DPID settings were part of the migration, however this fails because of a null exception: VRCPackageSettings.Instance.dpidMipmaps within PerceptualPostProcessor executes VRCPackageSettings.Instance_get VRCPackageSettings._instance is null so Create() is called, which calls Load() Load() and calls within it, including EnsurePathExists() expect GetPath() to not be null, causing a null exception when it is because GetPath() calls GetPathFromType(GetType()) which calls UnityEditor.PackageManager.PackageInfo.FindForAssembly(t.Assembly) and returns null when executed by a worker process, GetPathFromType then returns null (a comment assumes this would only occur when the SDK is not located within the Packages folder) but this execution path was seemingly never tested and so methods that expect valid strings such as Directory.CreateDirectory within EnsurePathExists() throw null exceptions. Simply resolving the null exceptions is not enough as the current implementation would cause Load() to not load any data when it's meant to, leading to VRCPackageSettings.Instance to contain default values when executed by worker processes ( AssetDatabase.IsAssetImportWorkerProcess() ), you cannot simply abort execution because that invalidates the use of Parallel Import and would cause textures marked as "dirty" to not actually be updated to have mipmaps re-generated, a proper solution leading to the same settings file must be implemented, the whole dependency on the assembly's package info seems extreme. This can be easily reproduced on any 3.7.5+ project with Parallel Import enabled (Project Settings -> Editor, mine is configured with 8 desired workers and 2 on standby) by enabling/disabling "Override Kaiser mipmapping" in the SDK settings.

tracked

World SDK always tries to clone sample scripts

The world SDK always tries to clone whole contents in UdonSharp/UtilityScripts folder into Asset folder and forcibility overrides them even if exists. It's really annoying because it makes unnecessary changes for git commit and unable to remove sample scripts. Please remove auto sample cloning after first project creation. Steps to reproduction: Create a World SDK project. Open the project with Unity. After script compile, try to remove Assets/UdonSharp/UtilityScripts Expected results: You can remove its folder and should not be cloned again. Actual results: Its folder is cloned after removal and reload the project.

tracked

[3.6.x] Interact Passthrough broken?

My seat trigger colliders are inside of a physical hull collider. The hull is on a custom layer called PhysicCollider and I use the "Interact Passthrough" setting to make it transparent to interaction. Live I can interact with the seats. That was uploaded with SDK 3.5.0. But when I upload my world with SDK 3.6.0, the interaction isn't possible anymore. I have to crawl to reach the seat collider inside. I guess, that feature broke with the layer changes in SDK 3.6.0. The first two images shows live SDK 3.5.0 vs my testworld SDK 3.6.0.

tracked

[3.8.2] VRChat SDK Causing False Prefab Overrides on Upload and Interaction

Summary: The VRChat SDK is causing Unity to falsely detect prefab overrides when no actual changes have been made. This issue occurs both during general SDK activity (not just when opening the SDK tab) and specifically when uploading or updating avatars. It often flags the Avatar Descriptor component as "changed," even when untouched. Steps to Reproduce: Open a Unity project with VRChat SDK (SDK3 - Avatars). Create or load a prefab-based avatar. Upload or re-upload the avatar via the SDK. After upload completes, observe that the avatar prefab now shows "Unapplied Overrides" in the inspector. Open the prefab and inspect the VRC_AvatarDescriptor — Unity claims it's been modified, even though no changes were made. Expected Behavior: Uploading or interacting with the SDK should not trigger false prefab overrides when no values were changed. Avatar Descriptor and other components should remain untouched unless explicitly edited. Actual Behavior: Prefab instances are flagged with "Unapplied Overrides" after uploading or interacting with the SDK. The VRC_AvatarDescriptor component is frequently shown as modified, despite no visible differences. These overrides appear without user input, leading to confusion and unnecessary prefab management. Known Triggers: Uploading or re-uploading avatars. SDK interactions during project use (not limited to opening the SDK tab). SDK updates that introduce new systems like (often re-introduce the bug): PhysBones, Constraints, Per-platform Avatar Overrides Impact: Disrupts normal Unity workflow and prefab integrity. Forces creators to manually check or apply overrides to maintain consistency. (Sometimes not even working and getting stuck in an override change loop) Risk of unintentionally applying unwanted changes or overwriting important prefab data. Time-consuming and frustrating for creators managing large or complex prefabs. Additional Notes: This issue has persisted across multiple SDK updates and is easily reproducible. It appears tied to how the SDK modifies or refreshes component data internally. Given how fundamental prefabs are to Unity projects, this issue should be considered a high-priority bug — especially for avatar creators relying on clean and reliable prefab behavior.

tracked

Additional MaterialSlots in MeshRender are not counted tris on AvatarPerformanceRank

Reproduce 1.Create new GameObject and attach VRCAvatarDescriptor 2.Create new Cube as child of that GameObject 3.See inspector of that cube. Open materials in MeshRenderer of Cube 4.BuilderPanel shows 12 triangles.(Cube has 12 triangles,right) 5.Edit materials any large number.(in screenshot, 1024) 6.BuilderPanel shows 12 triangles. Expected BuilderPanel shows 12x1024 = 12288 triangles https://docs.unity3d.com/ja/2021.2/Manual/class-MeshRenderer.html >If a Mesh contains more Materials than sub-Meshes, Unity renders the last sub-Mesh with each of the remaining Materials In this case, Cube mesh(sub-mesh) will be rendered 1024 times. so I think AvatarPerformanceRank should count this. SDK Avatar 3.9.0

Only one client joins the world in Build&Test (Found how to reproduce!)

UPDATE: I fixed it! This turns out to be a bug with the "Logging" setting inside VRC (as shown inside the second screenshot) Turning this setting "off" results in the described bug! SDK 3.8.1 (also 3.8.2, I tried upgrading). Release 2025.2.3, build 1664 (going off the steam update notes). Description: Upon using Build&Test with two clients, only the first client will successfully load in. The second one will just hang on a black screen, with no loading whatsoever. The only way to close that inactive window is to use task manager. The same seems to happen with three clients, only the first one will successfully load in. I believe it worked fine until yesterday How to reproduce: Attempt to Build&Test, for windows, with two+ clients. Tried with VRC quick launcher as well, using Build&Reload with 0 clients and letting the quick launcher open them. This makes testing for networking issues quite a bit harder Logs and more information can be provided if needed

SDK occasionally breaks due to constraints

Rather occasionally, the SDK will "brick" itself, spitting out the attached error. Reloading the SDK immediately remedies this problem. I am unsure on what is required to reproduce it, but it is common enough to be problematic on multiple avatar projects with varying configurations.

tracked

Animation that changes an object's transform does not work in SDK3.9.0

I am the creator of gimmicks etc. for VR Chat When operated from the expression menu in SDK 3.9.0, the animation that changes the object's Transform does not work (such as changing Scale from 0 to 1). If it's SDK 3.8.2, it works fine, but if you update to 3.9.0, it won't work. These events occur even after uploading to VR Chat on Unity. Changes such as material changes and shape key operations move. Also, when each animation is played back in the Animation window in the editor, it is displayed without problems. The data is managed using VRChat Creator Companion. Also, when I had someone else test it, the animation worked without problems even in the SKD 3.9.0 environment. Even when they both created new projects and installed packages had exactly the same configuration, I was the only one who encountered the bug, and the other person had no problems. It seems that the probability of occurrence is rare even when searching the internet, but I'm in trouble because I don't know what kind of difference it occurs.

tracked

→

Boards