SDK Bug & Feature Requests

The Harmony package, used by Udon Sharp, and a handful of third-party community plugins for runtime patching in the editor, has been updated to officially support ARM64 on all platforms (Windows, Linux, and yes, Mac). This will correct any in-editor issues when running the Unity Editor on these platforms. Whilst VRChat itself may only support PC & Android, the Unity Editor is a cross-platform utility, and there are a variety of folks with ARM-equipped machines who use such hardware for primary development, and therefor experience issues with the editor without patching. With the advent of full iOS support on the horizon, this may further increase the # of Mac-based content creators. Please update the provided package. Release notes for version where ARM64 support was added Addendum An experimental VPM package can be found at MisutaaAsriel/VRCHarmony which installs a packaged release of Harmony 2.4.1. Unity appears to, in all testing, prefer the package's copy of Harmony over the version included by the VRC Base SDK. This package may also be installed using the following VPM repository: Dreemurrs-Repository VRChat may use the DLL provided from this repository if need be, or take over the package if they so wish. — It is currently built off of the Release target of Harmony, at the solution level, with .NET Framework 4.5.2 using GitHub Actions Note Building Lib.Harmony against the DebugFat target at the project level, or building it for Release against net452 at the solution level creates a successful drop in replacement. The release builds when built at the .NET project level or downloaded from the main Harmony repository currently output a mangled DLL that Unity Burst is incompatible with. A bug report is open on this here: pardeike/Harmony/issues/728 For further reference, the original copy of Harmony is built against .NET 4.5.0, which is no longer a valid target. 4.5.2 was chosen as its nearest replacement. Edited @ EPOCH 1757603286

The last SDK version I was able to successfully test was 3.8.1. This one allows for lighting to bake successfully On latest SDK 3.8.2 (And 3.8.2-beta.1): 'Generate Lighting' with unity built in lighting menu -> Background task stuck "Waiting for shaders to compile" - The time to completion continuously rises and never moves past 5% I am using an AMD rx 5700xt, screenshot attached is from another user who has the same issue and is using NVidia.

Issue: The SDK incorrectly throws an error for Mobile incompatible shaders on EditorOnly objects despite those objects being removed on upload due to the EditorOnly tag. These objects being removed on upload still allows the avatar to be uploaded even with the error which may confuse some users. Reproduction Steps: Set up an avatar for uploading to Android with compatible materials Add a mesh to the avatar w/ a PC only shader, such as unity standard Observe that the ""Error"" message in the SDK warning about incorrect shader usage Attempt to upload the avatar, it will fail with the cause being listed as the incorrect shader Change the tag of the new mesh object to EditorOnly Observe that the ""Error"" message is still there despite the mesh no longer contributing to any other performance stats Attempt to upload the avatar, it should succeed as the EditorOnly object is stripped from the avatar before upload Expected Behavior: The expected behavior is that the SDK shouldn't throw an error about materials on EditorOnly objects in the same way as it already correctly removes said objects from the performance stat listings.

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.

Problem Opening VRCSDK Builder page or changing the selected avatar will revert pose (transform) to rest pose defined in the 'Avatar' asset of the root Animator component. Cause of the problem In the OnGUIAvatarCheck method of the VRCSdkControlPanelAvatarBuilder class, it will call Animator.Rebind method to check the situations you call "nested armature". However, Animator.Rebind function will write the default pose defined in the 'Avatar' asset so it will revert any pose changes made in the editor. This is annoying since this will disturb creating animation clips and testing them in the editor. Solution One solution is to use Animator.Rebind(bool writeDefaultPose) private method and pass false to writeDefaultPose parameter, instead of passing true to it, which is the default value. This method is not available as public API but it will keep available until Unity 6000.2.0b4 (the latest available C# reference version . Another solution is to collect the current pose before calling Animator.Rebind and restore it after the call but this takes more code.

In an avatars scene if you enable & use a camera to upload a new avatar thumbnail, select a different GameObject, then disable the camera, and save the scene, Unity will crash. Likely related canny Scene setup: Add a camera to your scene to use for the camera Disable the camera by default (Unsure if required?) Save scene. Repro: Enable the camera Gameobject Upload a new thumbnail for an avatar in this scene using it Select GameObject other than the camera (??) Disable camera GameObject Save scene Video: https://www.youtube.com/watch?v=v-_O6c-W28E

This new version seems really emjoy hanging in Scheduler.Tick. Maybe I got too many avatars?

Hello, I encountered an issue while uploading a furry avatar with four different fur color variants. Three of the variants uploaded without any problems, but the white-fur variant consistently failed. The build stage was completed successfully, yet during the upload the console only displayed: "Failed to upload file" and "clearing ID that we do not own", without providing any further details. After some troubleshooting, I replaced the white-fur image with the normal-fur one, and the upload worked correctly. This suggests that the white-fur variant's picture may have been flagged as NSFW by VRChat's servers, preventing the upload. However, since no explicit error message (e.g., "Invalid Picture") was returned, it was unclear what the actual cause of the failure was. It would be very helpful if the SDK and/or API could return more descriptive error messages in such cases, for example indicating that the upload was blocked due to NSFW content detection. This would save users significant time when diagnosing upload issues. I believe this behavior also applies to the upload of emojis and stickers. Regards

UdonSharp reports Utilities.ShuffleArray (the T type) as not exposed to Udon, despite it working just fine in an UdonGraph program. The int[] version of this function does compile in UdonSharp.

For some reason, RuntimeLogWatcher from UdonSharp loads entire log files of VRChat in memory and scans it, every editor tick. If for some reason, there is a large log file of VRChat (for example because some world spams with messages), then right after Unity starts, RuntimeLogWatcher can't handle it gracefully and just explodes in UI hangs and RAM usage. Before Unity loads in usable state, it is already have less than 1fps and uses dozens gigs of ram. For some reason is also cannot be turned off: even if Output watch mode is set to Disabled, it is still there.