SDK Version 3.10.3 brings Toon Standard improvements, the VRCRaycast component, and exposes VRC+ subscription status to Udon!

Features​

• Added the VRCRaycast component.
  • It allow avatars to fire rays through the scene that hit against colliders in the world or on players. A transform is positioned at the point the raycast hits.
  • This provides similar functionality to FinalIK, but is much more optimized and easier to use.
• The Toon Standard shader now supports a "Color Mask" property.
  • This allows you to apply different Tint values based on an RGB(A) mask texture.
  • Every channel can additionally be configured with Emission.
  • The additional Tint can be applied in Multiply and Additive modes.
  • Color masks without an alpha channel will automatically disable the 4th Tint option to avoid confusion.
• Added an isVRCPlus property to VRCPlayerApi to allow Udon to query if a user has an active VRC+ subscription.

Fixes & Changes​

• Fix String and Image URL loading features not working in ClientSim since 3.10.2.
• Mirrors now render in Camera.onPreCull instead of OnWillRenderObject to match the 2026.1.3 client.

Fixes & Changes from 3.10.3-beta.1 to 3.10.3-beta.2​

• Improvements to VRCRaycast:
  • Changed the editor gizmo to be orange instead of blue.
  • Added avatar animator parameters set by VRCRaycast:
    • {Name}_Hit is a boolean parameter set to true while the ray is hitting a collider and false while it isn't.
    • {Name}_Ratio is a float ranging from zero to one that gives the ratio of the full distance covered by the raycast. For example, if the hit is 50% of the way along the ray's maximum distance, this value will be set to 0.5.
    • {Name}_Distance is a float giving the actual distance traveled by the ray in world units before it hit something.
  • Fixed the result transform facing the wrong way when the ray misses when configured to snap on miss.
  • Renamed Positioning On Miss to Behavior On Miss to better reflect that this option also affects rotation while Apply Rotation is turned on.
  • VRCRaycast now behaves correctly in SDK projects where domain reloading is disabled.
  • Added an option to allow raycast distance to change with the Z scale of the transform the component is attached to.
    • It's still limited to a maximum distance of 1000 units.
  • Added public C# properties to the raycast component for user-made SDK tooling.

Fixes & Changes from 3.10.3-beta.2 to live​

• Removed Disable On Miss from VRCRaycast, since it's redundant now that avatar animator parameters are available instead.

Known Issues​

• In rare cases, you may see an "All pipe instances are busy" error while building. This is a Unity issue - restarting your editor and trying again should fix it.

SDK Version 3.10.2 brings a large number of fixes and UX improvements, alongside several new Udon APIs.

Features​

• Added EventTiming.PostLateUpdate and EventTiming.FixedUpdate as available timing options for delayed custom events in Udon.
• Added the option to read and filter client log files within the SDK.
  • You can find this utility under VRChat SDK/Udon Sharp/Parse Logs from File.
  • Special thanks to "BobyStar" for this canny!
• UX improvements for the Avatar Expressions Menu editor:
  • Since controls always set their associated parameters to zero when they deactivate, the SDK now warns you when you try to set the activation value to zero, too, because this would mean the parameter's value would never move off zero - which is probably not what you want.
  • When targeting a Boolean parameter, the Value attribute is now hidden and is always treated as enabled, since that's the only option that works for a Boolean (true when activated, false when deactivated).
• Added a parameterless version of VRCPlayerApi.GetPlayers() that returns an array of the players currently in your world.
  • The version accepting an array of players to populate also remains available, and is still preferred when getting the current list of players very regularly (for example, every frame) due to memory allocations.
• Added matchingTags to ContactExitInfo. This means you can now check what tags a VRChat Contact Sender and Receiver have in common as they stop contacting each other.
  • Previously, this was only available when the contacts started contacting each other.
  • Check the Udon API documentation for details.
• Avatar Parameter Drivers now support preventing repeats when selecting random values, meaning the parameter will never be set to the same value twice in a row.
• The properties enabled and isActiveAndEnabled have been allowlisted for use in UdonGraph and UdonSharp. This applies to everything that derives from UnityEngine.Behaviour, which includes the majority of custom and built-in components.
  • Known limitation: Accessing enabled or isActiveAndEnabled on a field serialized as a Behaviour will not work if the component being targeted is derived from UdonSharpBehaviour. You should instead declare the field with your own custom U# type.

Fixes & Changes​

• In the "Authentication" tab, pressing the "Enter"/"Return" key after entering your username and password now logs you in.
  • We also shifted things around slightly to make it less likely that you accidentally hit "Logout" while trying to verify your 2FA code.
• Removed redundant spaces that were included when serializing a data list or data dictionary to JSON with the Minify export type using VRCJSON.
• VRCJson.TryDeserializeFromJson() now always returns false instead of potentially throwing an exception if the input cannot be deserialized.
• Fixed DataDictionary sometimes failing to get a value if the key is a data structure like Vector3Int.
• The VRCMirrorReflection component now instantiates non-editable materials instead of changing the original material directly. This means the component no longer modifies the default material built into Unity when it is added to a Unity primitive.
• Passing VRChat Contact Sender or Receiver proxy objects to Utilities.IsValid() now gives accurate results based on whether or not the proxy is still valid.
• Fixed VRChat Constraints sometimes failing to appear properly in the inspector when viewed as prefab overrides.
• Added a validation hint to disable the "Auto Roll" option for particle systems in worlds, since this can be immersion-breaking for users in VR.
• Fixed VRCPickup's "Use Text" inspector field not appearing consistently.
• Fixed an issue that could result in the VRCFallback tag being set incorrectly on materials after using certain community packages, which could then result in the materials not appearing correctly inside VRChat.
• The SDK no longer reverts changes made to the default world scene and UdonSharp utility scripts when you delete your world project's Library folder.
  • Additionally, UdonSharp utility scripts that come with new world projects will no longer be recreated if you delete them, provided you don't also delete the data locator next to them.
• Removed some empty entries in the default expression parameters set included in the SDK's samples.
• Fixed validation messages being generated against the wrong platform in avatar and world projects if any assets have platform-specific overrides.
• Fixed PhysBones regression which caused bones resting on PhysBone colliders to jitter.
• PhysBone roots can now be multi-edited.

Fixes & Changes from 3.10.2-beta.1 to live​

• Added 4 new shader globals containing information about time.
• The Toon Standard shader and its Outline variant now set "RenderType" = "Opaque".
• Fixed internal exceptions caused by destroying a PhysBone that is the parent of one or more VRChat Constraints.

Known Issues​

• In rare cases, you may see an "All pipe instances are busy" error while building. This is a Unity issue - restarting your editor and trying again should fix it.

SDK Version 3.10.1 fixes two critical bugs in the avatars SDK. Check out the 3.10.0 changelog for the latest features.

Fixes & Changes​

• Fixed a performance regression caused by nesting avatars under a shared root game object. This caused delays as you opened or refreshed the Builder tab in the VRChat SDK control panel.
• Choosing a high resolution image for an avatar thumbnail no longer breaks first time avatar creation.

Known Issues​

• In rare cases, you may see an "All pipe instances are busy" error while building. This is a Unity issue - restarting your editor and trying again should fix it.

SDK Version 3.10.0 brings VRChat Dynamics to Worlds! This includes PhysBones, Contacts, VRC Constraints, and Udon integration for all of them. Additionally, world persistence now exposes data usage information and limits.

New Features​

• VRChat Dynamics are now supported in Worlds!
  • PhysBones, Contacts and VRC Constraints are now available in worlds projects.
  • All of these components have new Udon APIs and events that allow your scripts to work with them!
  • This is one of the most requested features for our Worlds SDK - we can't wait to see what you will create with it!
• World persistence now has an API to retrieve Storage Information.
  • This includes 3 new functions, GetPlayerDataStorageUsage, GetPlayerDataStorageLimit, and RequestStorageUsageUpdate.
  • The Request function pairs with the new OnPersistenceUsageUpdated event.
  • There are also 2 new events for PlayerData usage: OnPlayerDataStorageWarning and OnPlayerDataStorageExceeded.

Fixes & Changes​

• A validation warning is now shown in world projects where any spawn point is below the respawn height for the world.
• Improved handling of missing spawn points in world projects.
• Reduced internal log output when a project loads and when assemblies are reloaded.
• Avatar and world IDs now have leading and trailing whitespace removed.
• Fixed an SDK crash triggered by deleting any source transform for a VRChat constraint while that constraint component was still visible in the inspector.
• Fixed the validations window inadvertently resetting custom poses or animations applied to the avatar in the scene every time it was refreshed.

Fixes & Changes from 3.9.1-beta.1 to 3.9.1-beta.2​

• Changed VRCContactReceiver.UpdateContentTypes() to take an array of strings instead of an IEnumerable of strings. This should fix Udon graphs containing this method not compiling correctly.
  • If you were previously using this method in U# and passing anything other than a string[] to it, you'll now need to update your scripts to pass a string array.
• Resolved an unintended compatibility breaking change with some community made tools.
  • Specifically, the class PhysBoneGrabHelper has been moved back to its original assembly location.
• Removed name from the list of symbols exposed to Udon for PhysBones, Contacts and VRC Constraints in worlds.
  • This was causing confusion and can be accessed via the .gameObject property anyway.
• On contact receivers, the "Allow Self" and "Allow Others" options now only apply when the incoming sender is part of an avatar, meaning these settings are unused when dealing with a contact sender in a world.
  • Remember, you can disable "World" in "Content Types" if you don't want a receiver on your avatar to detect world contact senders.
• PhysBones, Contacts and VRC Constraints now behave properly when used on a VRCPlayerObject.
• PhysBones instantiated in a world using Object.Instantiate() now simulate properly instead of staying rigid.
  • Grabs and poses will not synchronize between clients on PhysBones that are instantiated in this way, similarly to how Udon behaviors on instantiated objects are also unsynced.
• Fixed some entries in the Udon Class Exposure Tree showing as "not exposed" when they actually are. This mostly affected the recently added dynamics components.
• Fixed avatar uploads failing with an incorrect "missing thumbnail" error if the upload process was interrupted part way through.

Fixes & Changes from 3.9.1-beta.2 to 3.10.0-beta.1 and 3.10.0​

• Compatibility changes related to the PermissionFilter struct used by PhysBones.
  • New constructors have been added, including a default constructor that takes no parameters. These constructors set the contentTypes property to Everything, which resolves an incompatibility with some existing community packages.
  • The planned SDK release version has been moved from 3.9.1 to 3.10.0 due to remaining incompatibilities that we were unable to resolve sufficiently.
• Fixed OnPhysBoneGrabbed() not receiving the player that initiated the grab when using ClientSim in a world project.
• Resolved a case that would allow uploading an avatar with no thumbnail attached to it.

Known Issues​

• In rare cases, you may see an "All pipe instances are busy" error while building. This is a Unity issue - restarting your editor and trying again should fix it.

SDK Version 3.9.0 brings an Udon API for the camera dolly, a new Auto Hold mode for pickups, improvements to the Network ID Utility, new VRCCameraSettings APIs, and some changes to how Avatar IDs are assigned.

New Features​

• Worlds can now define Camera Dolly paths and activate them via Udon!
  • Check out the dolly documentation on how to use the new VRCCameraDollyAnimation, VRCCameraDollyPath, and VRCCameraDollyPoint components together with the VRCCameraDollyAnimation.Import() Udon function.
• "AutoHold" for VRCPickup objects is now supported across all input devices!
  • You can choose to upgrade any pickup in your world to the new AutoHold system for improved handling (and a simpler yes/no checkbox instead of a 3-choice dropdown), then reupload your world to use the new system.
  • If you don't upgrade your pickups, your existing worlds are unaffected.
• Additions to the VRCCameraSettings and VRCQualitySettings APIs:
  • Exposed CullingMask property via VRCCameraSettings to allow modifying active render layers at runtime. Some internal layers are excluded from this.
  • Added a VRCCameraSettings.GetCurrentCamera function as a proxy for Unity's Camera.current.
  • Added VRCQualitySettings.ShadowCascade2Split and ShadowCascade2Split properties. These are writeable.
  • Enabled setting depthTextureMode on VRCCameraSettings.PhotoCamera. Note that you cannot disable basic Depth mode on PhotoCamera, but you can additively add other flags.

Fixes & Changes​

• Removed the trust rank requirement for building & testing worlds and avatars.
  • This means that Visitor accounts can now use the SDK to locally build and test their own avatars and worlds.
  • However, Visitors still need to increase their trust rank before uploading content.
• Fixes and improvements to the Network ID Utility:
  • Improved UI responsiveness in very large projects containing a lot of networked objects.
  • Fixed a case where importing IDs would fail due to an exception being thrown.
  • The tool now warns against GameObjects with forward slashes (/) in their names while exporting, since this can cause problems when importing again later.
• Fixed the _Angle parameter on PhysBones not working if the PhysBone chain started with a scale of zero.
• Minor performance improvement to the PhysBone inspector panel.
• VRCShader.SetGlobalInteger now uses the correct integer variant of the backing UnityEngine.Shader function, preserving bit patterns.
• Improved handling of UdonBehaviour components with an invalid script assigned to them.
• UdonSharp scripts are now recompiled when you switch platforms.
• Fixed world uploads sometimes failing due to the SDK trying to assign an avatar ID instead of a world ID.
• Transform animations inside the Gesture layer should no longer break if no custom FX Layer is provided.
• The vrc_AvatarV3FaceLayer sample controller now follows our animator best practices.

About Avatar ID Assignments​

This SDK update changes how content IDs (those avtr_* strings) are assigned in our backend.

• For tools that use the VRChat SDK's native BuildAndUpload method:

• For tools that manually call the Build and Upload methods:

As this is considered a breaking change, the version number of this update has been bumped to 3.9.0 according to our versioning scheme.

Fixes between 3.9.0-beta.1 and 3.9.0​

• Setters on VRCCameraSettings can now be used from Start in ClientSim without throwing exceptions.
• Using Standard Lite shaders in worlds no longer breaks lightmapping.
  • This used to result in an infinite "compiling shaders…" during bakes.

Known Issues​

• In rare cases, you may see an "All pipe instances are busy" error while building. This is a Unity issue - restarting your editor and trying again should fix it.
• The "Upgrade" button may not appear on VRCPickup components if multiple are selected at once.

SDK version 3.8.2 brings a spawn radius setting to worlds, matches the new Item Unity layer to the VRChat client, and fixes several issues.

Fixes & Changes​

For World Creators​

• The reserved3 Unity layer has been renamed to Item, and is now set up in the physics collision matrix to match the VRChat client (items only collide with other items).
• Worlds now support a spawn radius for players!
  • The SDK now lets you define a circular Spawn Radius in the scene descriptor component. The radius applies to all spawn points, and the editor visualizes the radius when you select a spawn point in the scene view.
  • The spawn radius defaults to 0.2m for new worlds (as defined in the default VRC world scene template).
  • Players spawn randomly within this radius. New and existing worlds where the radius is set to 0 continue to work as before, with players spawning at the exact spawn point.
• Fixed the DownloadImage() method in VRCImageDownloader throwing an exception when called from Udon Sharp with no event receiver.
• Fixed VRCObjectPool's StartPositions and StartRotations showing as exposed in the Udon class exposure tree window.
• Fixed ClientSim not letting you enter Play Mode without a Scene Descriptor.

For Avatar Creators​

• You can now edit avatar tags in the SDK.
• Added a validation error that prevents a humanoid avatar from being uploaded if it has a nested armature.
  • "Nested armature" means the root of the armature is not a direct child of the GameObject containing the avatar's animator. Avatars set up this way have previously not had animations play for other users when seen in VRChat.
  • Specifically, this means the avatarRoot on the root Animator is not the same transform as the VRC_AvatarDescriptor.
  • This is not a supported configuration.
• Opening the VRChat SDK Build Panel no longer creates an empty "VRC Per-Platform Overrides" component.
• When all per-platform overrides are removed from an avatar, the "VRC Per-Platform Overrides" component will now be removed as well.

Fixes & Changes between 3.8.2-beta.1 and live​

• Toon Standard shader updates:
  • Fixed "Outline from Albedo" not taking Tint and Vertex Color (if enabled) into account.
  • Fixed normal maps being inverted on backfaces and outlines sometimes glitching through on "Cull Off" (double-sided) materials.
• Updated the performance rank message in the SDK Build Panel to mention that it is only an estimate.
• Adjusted the messaging on avatar pedestals with private avatar IDs to be more accurate.
• All custom events are visible in the Udon Graph editor's sidebar again.
• Added a warning when any of the Spawns in the VRC Scene Descriptor are too far from origin (more than 1000 units on any axis).
  • Moving the player this far out can cause issues with rendering or UI interaction and is not recommended.

Known Issues​

• In rare cases, you may see an "All pipe instances are busy" error while building. This is a Unity issue - restarting your editor and trying again should fix it.

Version 3.8.1 adds the mobile-compatible Toon Standard shader, Udon network events with parameters, exposes several new VRChat-specific classes to Udon (including Camera access and Network Debug Stats), and adds Build & Test for iOS.

This update also allows specifying per-platform overrides for Multi-Platform Build & Publish, and fixes several UI issues in the SDK Control Panel.

Udon Network Events with Parameters​

Please read the extensive network events documentation for details! It includes several examples, network specifications for events, explanations around rate limiting, detailed notes on backward compatibility and security notes.

TL;DR: You can now specify up to 8 parameters on custom network events sent via SendCustomNetworkEvent. All types supported by Udon Sync work. In UdonSharp, you need to use the new [NetworkCallable] attribute. Your existing Udon scripts will continue to work without any changes.

• Added [NetworkCallable] attribute to UdonSharp, and extended the Udon Graph UI for the Custom Event node to allow parameters to be added.
  • Optionally takes a rate limit parameter, defaulting to 5 per second, per event (max 100 per second). Check out the docs on rate-limiting.
• Added NetworkEventTarget.Others, which acts similarly to All but excludes the sender from receiving their own event.
• Added NetworkEventTarget.Self, which bypasses rate limits and can be used to send local events with parameters.
• Added functions NetworkCalling.GetQueuedEvents and NetworkCalling.GetAllQueuedEvents to monitor outgoing event queues (useful when working with rate-limiting).
  • See docs on congestion monitoring.
• Added VRCPlayerApi NetworkCalling.CallingPlayer { get; } to get the sender of any event (including legacy ones!) while inside a function triggered remotely.
  • Includes bool NetworkCalling.InNetworkCall { get; } as a shortcut for Utilities.IsValid(NetworkCalling.CallingPlayer).

Toon Standard Shader​

• Added the Toon Standard shader, available as VRChat/Mobile/Toon Standard!
• This is a full-featured toon shader that is compatible with mobile versions of VRChat. It can be used on PC, Android and iOS.
• It comes with many highly requested features that you may know from community-made PC shaders. For example:
  • Custom shadow ramps with configurable toon-style shading
  • Detail maps with selectable UV channel and render mode
  • Packable Metallic, Gloss and Occlusion maps, with configurable color channels
  • Configurable backface culling
  • Matcap support, additive and multiplicative
  • Toggleable vertex color support
  • Hue shift effect
  • Rim lighting
• The focus of this shader is on performance, which means the feature set is limited. Transparency is not supported.
• There is also a Toon Standard (Outline) variant that is PC-only. Uploading an avatar with the outline variant to a non-PC platform will automatically fall back to the non-outline variant.
• You can select Toon Standard as a PC fallback shader by specifying toonstandard or toonstandardoutline as the VRCFallback tag, making it opt-in.

Even More New Features​

• Added Build & Test support for iOS.
  • This works a bit different than other platforms, so check out the documentation!
• You can now specify per-platform versions of the avatar to be used during multi-platform build & publish
  • Full documentation for this feature, including public API, is available here.
• Exposed Screen & Photo Camera as well as certain Quality Settings to Udon via appropriate wrapper classes.
  • Also exposes certain quality settings, including shadow distance, to Udon.
  • Includes 2 new events, OnVRCCameraSettingsChanged and OnVRCQualitySettingsChanged, for when the local user changes camera or quality settings, documented here.
• Added several Udon interfaces to access network debug information.
  • These are meant for advanced Udon networking creators. Check the full documentation here.

Fixes & Changes​

• Fixed the "Alerts" section not updating after docking the SDK Build panel and switching tabs.
• Fixed an issue where failing to build a world bundle could result in uploading a previous bundle (e.g. a bundle for a different platform).
• Slightly changed how default scale factors are assigned when adding new targets to a VRCHeadChop component.
  • The component will now copy the weight from the previous target in the list. This change has been made to improve support for user made tools that assign scale factors from code.
• Fixed VRChat aim and look-at constraints calculating incorrect offsets in some specific situations with the component active and the offset unlocked.
• The Avatar SDK no longer blocks the build button due to validation errors.
  • The builds will still fail if validations do not pass after all the avatar processing callbacks finish.
• SDK no longer becomes unresponsive when encountering API issues during thumbnail and content info updates.
• SDK no longer gets stuck in a disabled state when attempting to save changes when the content name is empty.
• Includes PhysBone fixes and changes up to VRChat client 2025.2.1, build 1622.

Fixes & Changes in 3.8.1-beta.2​

• The copyright ownership confirmation modal has been moved to appear right after clicking "Build & Publish" instead of before upload.
• Clicking "Build & Publish" on an avatar that has per-platform overrides set up will now use the override even without multiple platforms being selected.
• Avatars with per-platform overrides configured now show a blue badge 🔵 near the "⋮" button of the avatar selector.
• Moved PerPlatformOverrides code into the VRC.SDK3A.Editor assembly. This avoids breaking changes made in 3.8.1-beta.1.
  • Updated the documentation to reflect the revised API for getting and setting per-platform avatar overrides.
  • See this canny for details.
• Fixed a case where the content blueprint ID could get cleared when BuildAndUpload is called right after switching Scenes.
• Reserved layers can no longer have their culling distance modified via VRCCameraSettings.LayerCullDistances.

Features & Changes in 3.8.1-beta.3​

• Added the Toon Standard shader, available as VRChat/Mobile/Toon Standard!
• The SDK no longer gets stuck on "Building Avatar" when building many avatars consecutively.

Fixes & Changes in 3.8.1-beta.4​

• New features for Toon Standard based on your feedback!
  • Added toggleable vertex color support.
  • Added MultiplyX2 detail map mode, similar to Standard Lite.
  • Removed Mask detail map mode. Instead, all modes now apply the mask texture.
    • The detail mask is now also applied to the detail normal map.
  • Added Hue Shift slider for emission, as well as a Hue Shift Mask affecting all 3 sliders.
    • Hue Shift is now a toggleable feature that can be turned off to improve performance if unused.
  • All mask textures can now select which color channel they use. You can configure this by clicking the > arrow to the left of each texture slot.
    • By default, the setup matches Standard Lite, just like in beta.3.
  • Removed Anisotropy slider and switched Specular implementation to regular isotropic GGX.
    • The anisotropic mode caused more confusion than it helped and had a non-insignificant performance overhead. If you have a specific use-case you consider important that requires this, let us know on our Feedback board.
  • Added Albedo Tint slider for Rim light.
  • Light clamping is now applied on direct and indirect lighting together, instead of individually, and can be toggled on or off via the "Limit Brightness" option.
  • Also fixed a couple of bugs:
    • Switching to a built-in Shadow Ramp now resets Scale/Offset properly.
    • Selecting multiple materials using Toon Standard at once no longer resets their Shadow Ramp setting.
    • Detail and Emission maps no longer appear pixelated at high Scale/Offset values on certain hardware.
    • Matcaps in Multiplicative mode now apply correctly to additional lights in the ADD pass.

Fixes & Changes in the final release​

• Toon Standard fixes:
  • Improved specular stability on mobile devices, which should help reduce bright flashes/"sparkles".
  • The Gloss Map now applies to Reflectivity as well.
  • Fixed Hue Shift foldout incorrectly being synced to the topmost one.
  • Fixed default values for the Shadow Ramp slot.
• Per-platform overrides now work correctly with prefabs and prefab variants.

Known Issues​

• In rare cases, you may see an "All pipe instances are busy" error while building. This is a Unity issue - restarting your editor and trying again should fix it.

Version 3.8.0 adds an Udon interface for the VRChat+ Drone, improves PhysBones, and fixes a variety of minor bugs.

This release went to beta as version 3.7.7.

Fixes & Changes​

• Added Udon API to access the VRChat+ Drone of players in your world!
  • Check out the documentation to get started.
• Improved the content ownership confirmation flow during uploads.
  • The old checkbox was removed in favor of a modal.
  • The modal only appears once per Unity Editor session and content ID.
• Includes PhysBone dependency sorting as introduced in VRChat client version 2025.1.3.
  • PhysBones and PhysBone Colliders now execute in deterministic order depending on their transform relationships with other Physbones. There is a maximum dependency depth of 8 levels deep.
• Added an ignoreOtherPhysBones option to PhysBone components.
  • If you enable this option, the Physbone will ignore other Physbones and their affected transforms beneath itself in the scene hierarchy.
  • You should avoid disabling this option. Controlling the same Transform with multiple Physbones may lead to unsupported behaviour.
  • This option is enabled by default. For compatibility, it is disabled for existing avatars.
• Allowlisted IVRCImageDownload.Dispose() for Udon, allowing you to dispose individual downloaded textures once they're no longer needed.
  • This is an alternative to disposing the entire downloader at once. This makes it easier to set up a rotating carousel of images using an image downloader.
  • For more information, see our documentation for Image Loading.
  • Note that failing to dispose IVRCImageDownload objects can lead to excessive memory consumption of your world over time!
• Fixed avatar dynamics sometimes not simulating as soon as you enter play mode in avatar projects that have automatic domain reloading disabled.
• Fixed four benign warning messages that always appeared in World SDK projects.

Changes since 3.7.7-beta.1​

• Bumped version to 3.8.0 due to a minor breaking change around type signatures in the com.vrchat.dynamics package.
  • Note that the affected functions aren't considered part of the official public API, and may change further in the future.
• Added "Force Kinematic On Remote" option to VRCObjectSync. Use this for objects that simulate physics only for the owner.
  • As an example, the VRChat Drone uses this option so the owner can calculate physics and collisions, while remote users do not run any physics logic.

Known Issues​

• In rare cases, you may see an "All pipe instances are busy" error while building. This is a Unity issue - restarting your editor and trying again should fix it.

Version 3.7.6 reworks the SDK's Build Panel, adds multi-platform Build & Publish, and allows you to Build & Test Android/Quest avatars. It also improves ClientSim's pause menu and fixes several bugs.

Fixes & Changes​

• The VRChat SDK's Build Panel has received a major overhaul.
  • You can now target multiple platforms at the same time when publishing!
    • Multi-Platform Build & Publish goes through each selected platform in sequence and build your content for that platform, always starting with PC (if selected).
    • You can monitor the progress in both the Builder panel and in Unity's Background Processes window accessed in the bottom right area of the editor.
    • Once the builds are done, the editor returns to the platform you started the build on.
    • The updated UI also incorporates all of the changes made to support Build & Test for Android/Quest.
  • Content Info editing has been improved.
    • The Content Warnings section has been changed into a simple dropdown.
    • The tag editor has moved to a new popup.
  • Capturing thumbnails is significantly easier and more responsive.
    • Likewise, this new method addresses past Color Space and Post Processing issues.
• You can now build and test avatars on Android/Quest.
  • This requires connecting a phone (or any ADB device) to your PC.
  • Check out our documentation!
• Added support for Contact Senders to be local only.
  • If you enable "local only", the Contact Sender only exists on the local avatar in a similar way to local only Contact Receivers.
  • These do not contribute to an avatar's performance ranking, but still count towards the hard Contact limit.
• Fixed an exeception that could appear when toggling VRChat Contacts in Play mode.
• Implemented all VRChat Constraint fixes from client version 2025.1.2 (and older).

Client Sim​

• Added a new ClientSim setting, Hide Menu on Launch.
  • This setting automatically closes the ClientSim pause menu when entering Play Mode, after you've accepted the warning about differences between ClientSim and the VRChat Client.
  • In addition, the ClientSim pause menu now automatically closes when you move your player, similar to how the Quick Menu works in the Client.
• Fixed multiple UdonBehaviour scripts on one GameObject not functioning correctly in ClientSim.

Changes & Fixes in 3.7.6-beta.2​

• Fixed UdonSharp's log watcher by updating it to VRChat's new log file format.
• Fixed an issue with uploading worlds on Linux.
  • Linux is not a supported platform for our SDK, but internal tests show that you should now be able upload both worlds and avatars.
• The "Prepare Your Content" panel should no longer auto-collapse whenever "Show All Avatar Performance Details" is checked.
• The "Validations" panel now only rescans the scene when something in the scene changes.
  • This should generally improve editor performance.
• The checkbox confirming "The information provided above is accurate (...)" will now reset correctly when switching between different worlds or avatars.
• ASTC compression setting for Android builds are now correctly applied during multi-platform builds.
  • Fixed the beta SDK not preventing Android uploads if textures don't use ASTC compression.
• The SDK validation message list should now wrap text correctly at smaller window sizes.
• Fixed an issue with execution order when a PhysBone and Constraint component are used together on the same game object.

Changes & Fixes in final release​

• The performance stats in the Avatar SDK validations list are now correctly sorted by rank.
• The "Build & Publish" button now correctly specifies "... the terms below ..." when builds are blocked in the Avatar SDK.

Known Issues​

• In rare cases you may see an "All pipe instances are busy" error while building. This is a Unity issue, restarting your editor and trying again should fix it.

Version 3.7.5 adds Build & Test for Quest, similar to how it works on Android phones. Local-only contact receivers no longer count towards an avatar's performance rank. And there's also a new Udon event, OnVRCPlusMassGift, to make your worlds react to Gift Drops!

Fixes & Changes​

• Build & Test mode is now available for Quest!
• DPID has been reworked to have much sharper visuals when operating on AlphaIsTransparency textures.
  • When you import textures with DPID and AlphaIsTransparency enabled, the SDK now considers the alpha channel separately, making alpha masks as sharp as equivalent color masks.
• Resolved an issue where the DPID setting in the SDK would not persist between sessions.
• Fixed issue where running "Build and Test" before setting theblueprintId of a world or avatar would trigger the error "Attempted to load the data for a world we do not own, clearing blueprint ID". This error has also been downgraded to a warning.
• Contact receivers marked as local-only no longer count towards an avatar's performance rank.
• Fixed more cases of jittering with specific configurations of VRChat Constraints.

Udon​

• Added a new OnVRCPlusMassGift event that allows worlds to react to Gift Drops.
• Added the ability for GetComponent to be called on all TextMeshPro Components and VRCMidiPlayer.

ClientSim​

• Fixed a ClientSim bug where the first OnAvatarEyeHeightChanged call after entering Play Mode would cause a type mismatch error.
• Fixed Interaction Passthrough layers in ClientSim to more closely match client behavior.

Video Players​

• Video players no longer play untrusted URLs in public instances unless the world creator adds the domain to the world's allowlist via the VRChat website.
  • Video players in private instances can play any untrusted URL.

This update adds Persistence to Udon! Persistence allows you to build VRChat worlds that store data between sessions.

This update also fixes a few minor issues around VRCJSON and VRChat Constraints.

Persistence!​

Persistence allows worlds to save high scores, inventories, the player's last position, currency, unlocks, preferences, and much more. When a player leaves a world and returns later, Udon can access their saved data.

Learn all about the new features in our Persistence SDK docs.

Other Fixes​

• Fixed VRChat Constraints that need to run before Physbones not updating while in edit mode.
• Fixed VRChat Constraints that have a child Physbone, but also depend on one, not following their sources correctly.
• Several fixes for VRCJSON:
  • Fixed an issue where braces inside strings can fail to deserialize.
  • Fixed an issue where empty arrays can fail to deserialize if there is whitespace between the opening and closing, such as [ ].
  • JSON which starts with a BOM (Byte Order Mark, \uFEFF) would fail to deserialize. This character will now be ignored if it is at the start of the input.

This update fixes multiple issues with VRChat Constraints.

New features​

• Added an option to the Settings tab of the SDK Control Panel to prevent VRChat constraints from running while in Edit mode.
• It is now possible to trigger the "Activate" and "Zero" functions on a VRChat constraint from C# Unity Editor scripts by using the new ActivateConstraint() and ZeroConstraint() methods, addressing this Canny request.

Fixes & Changes​

• Improved Physbone and Contact behavior when used beneath VRChat Constraints to reduce jittering.
  • They sort their internal execution orders properly within a frame now.
• Fixed a case where toggled constraints could misbehave when three or more constraints are used on the same GameObject at once.
• Fixed the "Activate" and "Zero" functions of VRChat Constraints not applying as overrides to prefab instances.
• Fixed VRCConstraintSource having its values overwritten with defaults when created with the default constructor in C#.
• Fixed rotation, aim and look-at constraints drifting very gradually when one or more axes are unfrozen in certain configurations.
• Fixed constraints applying incorrect positions when the target transform is scaled to zero in any axis.
• Fixed constraints sometimes having their position or rotation shifted by a tiny amount every frame under certain conditions when they should be staying still.
  • This should make it easier to work with prefabs containing constraints.
• Physbone stats now recalculate properly when reloading a scene or switching platform.
• Fixed Physbone jitter by including fixes from client release 2024.3.3.
• Fixed "Avatar Options" incorrectly being shown twice in the Settings tab of the SDK Control Panel.
• Fixed com.unity.ugui missing as a dependency of the Worlds SDK, addressing this Canny request.
• Added a new "ExampleData" type to the SDK, which will be used to hold metadata for Examples in the future.

Known Issues​

• The first time you open a Scene and select a GameObject inside a prefab with a U# Behaviour, the GUI for the component directly below that U# Behaviour will not show its GUI. Deselecting and re-selecting the prefab fixes this.
• Buffer Particles don't work as they did in Unity 2019, there is a workaround to fix them from community member hfcRed here.
• Unity 2022 sometimes causes Rider's debugger to stop for unhandled exceptions in Unity's IMGUI.
  • Please refer to this workaround and Jetbrains's bug tracker for more information.

This update adds Build & Test for Mobile, Example Central and some fixes for Spookality '24! It also introduces Udon Code Signing for improved security.

New features​

• Build & Test for Mobile - send worlds directly to a connected Android Device while working on it for much quicker testing and iteration.
• Example Central - browse and import SDK Examples from within the Unity Editor.

Fixes & Changes​

• VRCPlayerAPI.SetAvatarEyeHeightByMultiplier now works properly in ClientSim.

Changes in 3.7.2-beta.2​

• Added Udon Code Signing!
  • Any worlds uploaded with this SDK (or newer) receive a server-side signature. This helps ensure only authentic (unmodified) versions of your world can be loaded into VRChat.
    • This makes it significantly harder for malicious players to cheat or bypass scripts in your worlds.
  • Each platform (PC, Android, iOS) has a different signature, so you need to upgrade all of your world's platforms.
  • Udon code signing does not affect non-malicious users, and will not change anything about your Unity editor experience.
  • This SDK also upgrades all your Udon scripts to a more efficient storage format (only relevant for very old world projects).
  • We recommend upgrading and re-uploading your worlds with this SDK to make your worlds more secure!

Changes in 3.7.2-beta.3​

• Fixed timing of Udon Code Signature calculation.
  • It is now calculated during the IProcessSceneWithReport callback with an execution order of int.MaxValue - 8192 when you build a world.
  • This fixes an issue with some Udon compilers (e.g. CyanTrigger) that modify code after signature calculation, making uploaded worlds fail verification.

Changes between beta.3 and the the final release​

• Fixed several bugs with Build & Test for Mobile from open beta feedback.
• Added a number of helpful error messages when incorrectly setting up Build & Test for Mobile.
  • For example, we will now warn you if your device's screen is locked.

Known Issues​

• The first time you open a Scene and select a GameObject inside a prefab with a U# Behaviour, the GUI for the component directly below that U# Behaviour will not show its GUI. Deselecting and re-selecting the prefab fixes this.
• Buffer Particles don't work as they did in Unity 2019, there is a workaround to fix them from community member hfcRed here.
• Unity 2022 sometimes causes Rider's debugger to stop for unhandled exceptions in Unity's IMGUI.
  • Please refer to this workaround and Jetbrains's bug tracker for more information.

This update exposes some highly-requested functions to Udon, adds high-quality DPID mipmapping support (opt-in beta), and optimizes PhysBone gizmos.

New features​

• Exposed the following C# features to Udon:
  • Array.Sort() allows Udon to sort Arrays in various ways, which is useful for managing Players in an Udon world. Addresses this Canny post.
  • System.Random allows Udon to create deterministic random seeds, as well as random Bytes and Doubles, extending the possibilities for randomness in Udon Worlds beyond what UnityEngine.Random can do. We exposed 4 new functions, addressing this Canny post.
  • System.Text.StringBuilder allows Udon to build and reformat strings with better performance than the existing string functions. We exposed 18 new functions and properties, addressing this Canny post.
  • System.Text.RegularExpressions - RegEx is a powerful system for searching, matching and replacing patterns within strings of text. We exposed 14 new functions and properties, addressing this Canny post.
  • System.Type allows Udon to interact with data types, and can be useful to advanced creators who want to validate object types at runtime. We exposed 67 new functions and properties, addressing this Canny post
• The SDK now supports "Detail Preserving Image Downscaling" (DPID) mipmaps, which greatly improve the sharpness of world/avatar textures.
  • ⚠️ We're still working on this one! It is currently a BETA feature and requires explicit opt-in via the "Settings" panel in the SDK control panel.
  • DPID replaces the mipmapping algorithm on all textures with the "Kaiser" filtering algorithm selected. "Box" filtering is unaffected.
    • The SDK build panel already encourages you to enable "Kaiser" filtering, which in turn now enables DPID.
  • Unlike the original algorithm, VRChat's version of DPID supports transparency. Enable Alpha is Transparency to avoid filtering artifacts on the edges of transparent textures.
  • The original algorithm implementation was published under BSD 3-Clause (a permissive license like MIT). To 'pay it forward,' we've released our compute shader version under the same license! You can find it in the SDK: com.vrchat.base\Editor\VRCSDK\Dependencies\VRChat\Resources\PerceptualMipmapping\PerceptualPostProcessor.compute.
• PhysBone gizmo rendering has been optimized.
  • Editor gizmos for PhysBones with non-0 radius setting now render 2-3x faster.
  • Editor gizmos of multiple PhysBone components in the hierarchy of the selected object now render 1.5-2x faster.
  • Addresses this Canny post.

Fixes & Changes​

• The SDK now blocks avatars containing particle systems or trail renderers set to destroy themselves when they finish. Particle systems on the avatar's root that disable themselves when they finish are also not allowed.
• Fixed typo in the Expression Parameters inspector showing used memory as bytes rather than bits.
• Fixed SDK Control Panel setting scripting defines every IMGUI redraw (improves performance slightly).
• Improved Lightprobe Hack behavior in situations with lots of ambient lighting.
• Fixed how empty expression parameter lists are filled with default parameters. Expression parameter lists can be empty again.
• Removed internal warning messages related to PhysBone and Constraint Burst jobs sometimes appearing when opening a project or recompiling scripts.

Fixes & Changes to DPID in 3.7.1-beta.2​

• Fixed alphaIsTransparent over-emphasising incorrect details.
• Fixed non-sRGB textures (e.g. normal maps) diverging at higher mip levels.
  • This should now be consistent with sRGB behavior.
• Fixed edge cases where a single fully-transparent pixel would get counted when the others are all the same color.
• Fixed null reference exceptions being spammed in the log when importing SDK 3.7.1 for the first time.
  • DPID is now correctly applied to all mipmaps that previously used Kaiser.
• Simplified and streamlined the compute shader.
• Reduced DPID-related log spam.

Fixes & Changes to DPID in the final version​

• Marked DPID as "BETA" and switched to opt-in.
• Set "conservative mode" to be the default, since it seems to give better results overall.
• Fixed normal maps (again).
• Fixed support for lightmaps.
• Support DPID mipmaps on HDR and Float format textures.

Known Issues​

• The first time you open a Scene and select a GameObject inside a prefab with a U# Behaviour, the GUI for the component directly below that U# Behaviour will not show its GUI. Deselecting and re-selecting the prefab fixes this.
• Buffer Particles don't work as they did in Unity 2019, there is a workaround to fix them from community member hfcRed here.
• Unity 2022 sometimes causes Rider's debugger to stop for unhandled exceptions in Unity's IMGUI.
  • Please refer to this workaround and Jetbrains's bug tracker for more information.

This update adds VRChat Constraints, Unity AI Navigation, improves Avatar editor panels, upgrades Standard Lite, implements new Player State APIs, and more!

New features​

• ⚠️ The SDK now blocks uploads if the last built avatar exceeds the new reduced download or uncompressed size limits for Avatars.
• This release integrates Unity 2022's AI Navigation package, which allows you to create non-player characters (NPCs) that can intelligently move around the game world, using navigation meshes that are created automatically from your Scene geometry.
  • As the VRChat SDK now includes a reference to the AI navigation package, an "AI Navigation" window appears when you upgrade your scene. You can close it by right-clicking and selecting "Close."
  • We published AI Navigation documentation for VRChat Worlds and an AI Navigation Example Scene to help you get started.
• Some Avatar editor panels have been updated:
  • The Expression Parameters and Expressions Menu editors have been rebuilt from the ground up.
  • The updated Expression Parameters editor:
    • Allows you to reorder elements via drag & drop easily
    • Uses a progress bar style meter to indicate how many synced bytes the parameters use
    • The Expression Parameters assets now have a new icon, making them easier to see in your Assets folder
  • The updated Expressions Menu editor:
    • Shows the current Menu Controls count alongside the maximum number of Controls you can add
    • Shows the types of each Control at-a-glance
    • Allows you to reorder the Controls via drag & drop easily
    • Has improved and updated warnings and errors
    • Has improved layout for editing all the Control types
    • For Sub-Menu Controls - allows for quick creation of a new Menu asset and provides a button to open the editor for the submenu with a single click
    • The Expressions Menu assets now have a new icon, so they're easier to see in your Assets folder
• Massively upgraded Standard Lite shader!
  • Considerably improved performance in the baseline.
  • Non-linear Lightprobe sampling: This will avoid unusual stark contrast for real-time objects in a scene.
  • Lightprobe specularity: This will fall back to using lightprobes in the scene to generate specular highlights if no reflection probes are present.
  • Geometric Specular AA: This will avoid jagged/aliased edges for shiny objects at a distance/at sharp angles by tweaking the roughness to add just enough to stretch any highlights over at least one extra pixel - this should reduce the apparent 'screen door' effect on a lot of geometry.
  • Spherical Harmonics lightmap compatibility through MonoSH (Bakery): This allows you to have the appearance of real-time lighting without the cost, by having every pixel of a lightmap encode light spread and direction, and otherwise treating it as being lit that way. The MonoSH version in particular avoids additional memory cost by squeezing everything into just one extra map. Baking MonoSH-compatible lightmaps requires the external Bakery plugin.
• Added OnLanguageChanged Udon event that gets called on join and when users select a new display language.
• Added an info-level message in the SDK build panel that encourages using Kaiser mipmapping for higher clarity.
  • We talked about the new DPID mipmapping algorithm in a dev update before. This is a first step towards that - though the algorithm is not included yet, so this will recommend default Unity Kaiser mips for now.
• Added a gizmo to VRCSceneDescriptor to visualize the respawn height.
• The VRC Scene Descriptor now shows a gizmo in your scene for each spawn defined in the spawns list.
• Auto-converting Dynamic Bones components into PhysBones is now required before uploading.
• Implemented some new player state APIs available via Udon:
  • event OnPlayerSuspendChanged(VRCPlayerApi player)
  • event OnMasterTransferred(VRCPlayerApi newMaster)
  • VRCPlayerApi Networking.Master { get; }
  • VRCPlayerApi Networking.InstanceOwner { get; }
  • bool VRCPlayerApi.isSuspended { get; }

VRChat Constraints​

VRChat Constraints are a full-featured replacement for Unity's built-in "Constraint" components. These are available to use on avatars. Existing constraint setups can be auto-converted.

In the client, all constraints will be auto-converted on load, but it is still recommended to use the SDK option to do so, as it allows direct testing and even further improved performance.

VRChat Constraints are supported on Mobile avatars! Check out our updated performance rank page for limits.

VRChat Constraints also have a few unique features, like native "world constraints". Go check out the extensive documentation for more info!

Fixes​

• Fixed issue with broken input events in ClientSim, addressing this Canny issue.
• Fixed world uploads failing in some cases when using inline sprites in TextMeshPro labels.

Breaking API Changes​

As the minor version bump indicates, 3.7.0 contains breaking changes for user tooling. In particular, all exposed information and APIs related to DynamicBones have been removed without replacement. As uploading with DynamicBones is no longer supported, user tooling should be updated to reflect that and only support PhysBones going forward.

Fixes & Changes relative to 3.6.2-beta.1​

This supercedes the 3.6.2 series.

• Improved stability of the new editor panels.
• Fixed some issues displaying code-generated avatar asset files, as many community tools do.
• Fixed avatar expression menu missing parameters between SDK upgrades and restarts.
• Fixed empty control names being incorrectly overwritten with "New Control".
• Fixed boolean Toggle menu entries not working as expected in-game (toggles created in 3.6.2-beta.1 or 3.6.2-constraints.4 may need to be recreated).
• Sub-assets of expression menus will now copy the target parameter object from the root asset if set.
• Fixed network IDs not being displayed in the Scene Descriptor inspector.

Fixes & Changes in 3.7.0-beta.2​

• Fixed inconsistent loading of Expression Menu and Parameter icons in editor.
• Fixed issue that caused Diffuse and BumpedDiffuse mobile shaders to appear all white.

Constraints Fixes​

• Fixed rotation constraints locked in exactly one axis sometimes appearing at the wrong rotation. (Woo, gimbal lock.)

• Fixed parent constraints potentially shifting in the SDK when Activate is pressed.

• Improved stability for constraints that reference one another in a loop.

• Fixed more issues with super-low weight constraints.

• Fixed offsets not always being calculated correctly for unlocked VRChat position constraints.

• Made corrections to how aim and look-at constraints behave when they are solving in local space.

• Fixed constraint sources losing their references when selecting multiple VRChat constraints and editing their sources lists at the same time.

• Improved support for community made tools interacting with the constraints auto-converter in the SDK.

  • Please refer to our documentation for more info.

Fixes & Changes in the final version​

• Further adjustments to the exposed API for constraints. Refer to the constraints documentation for more info.
  • This includes a parameter to indicate if a conversion was triggered by clicking "Auto-Fix".
• Improved parameter assignment for submenus in the expression menu editor.
• Fixed incorrect LFS references in .dylib files.

Known Issues​

• The first time you open a Scene and select a GameObject inside a prefab with a U# Behaviour, the GUI for the component directly below that U# Behaviour will not show its GUI. Deselecting and re-selecting the prefab fixes this.
• Buffer Particles don't work as they did in Unity 2019, there is a workaround to fix them from community member hfcRed here.
• Unity 2022 sometimes causes Rider's debugger to stop for unhandled exceptions in Unity's IMGUI.
  • Please refer to this workaround and Jetbrains's bug tracker for more information.

This update adds AI Navigation, improves Avatar editor panels, implements new Player State APIs, fixes input events in ClientSim, and fixes World uploads failing when using inline sprites.

New features​

• This release integrates Unity 2022's AI Navigation package, which allows you to create non-player characters (NPCs) that can intelligently move around the game world, using navigation meshes that are created automatically from your Scene geometry.
  • As the VRChat SDK now includes a reference to the AI navigation package, an "AI Navigation" window appears when you upgrade your scene. You can close it by right-clicking and selecting "Close."
  • We published AI Navigation documentation for VRChat Worlds and an AI Navigation Example Scene to help you get started.
• Some Avatar editor panels have been updated:
  • The Expression Parameters and Expressions Menu editors have been rebuilt from the ground up.
  • The updated Expression Parameters editor:
    • Allows you to reorder elements via drag & drop easily
    • Uses a progress bar style meter to indicate how many synced bytes the parameters use
    • The Expression Parameters assets now have a new icon, making them easier to see in your Assets folder
  • The updated Expressions Menu editor:
    • Shows the current Menu Controls count alongside the maximum number of Controls you can add
    • Shows the types of each Control at-a-glance
    • Allows you to reorder the Controls via drag & drop easily
    • Has improved and updated warnings and errors
    • Has improved layout for editing all the Control types
    • For Sub-Menu Controls - allows for quick creation of a new Menu asset and provides a button to open the editor for the submenu with a single click
    • The Expressions Menu assets now have a new icon, so they're easier to see in your Assets folder
• The VRC Scene Descriptor now shows a gizmo in your scene for each spawn defined in the spawns list.
• The SDK now blocks uploads if the last built avatar exceeds the new reduced download or uncompressed size limits for Avatars.
• Implemented some new player state APIs available via Udon:
  • event OnPlayerSuspendChanged(VRCPlayerApi player)
  • event OnMasterTransferred(VRCPlayerApi newMaster)
  • VRCPlayerApi Networking.Master { get; }
  • VRCPlayerApi Networking.InstanceOwner { get; }
  • bool VRCPlayerApi.isSuspended { get; }

Fixes​

• Fixed issue with broken input events in ClientSim, addressing this Canny issue.
• Fixed world uploads failing in some cases when using inline sprites in TextMeshPro labels.

Fixes between 3.6.2-beta.1 and 3.6.2-beta.2​

• Improved stability of the new editor panels.
• Fixed avatar expression menu missing expression parameters between SDK upgrades and restarts.

Known Issues​

• The first time you open a Scene and select a GameObject inside a prefab with a U# Behaviour, the GUI for the component directly below that U# Behaviour will not show its GUI. Deselecting and re-selecting the prefab fixes this.
• Buffer Particles don't work as they did in Unity 2019, there is a workaround to fix them from community member hfcRed here.
• Unity 2022 sometimes causes Rider's debugger to stop for unhandled exceptions in Unity's IMGUI.
  • Please refer to this workaround and Jetbrains's bug tracker for more information.

This release exposes additional TextMesh Pro components and other useful properties to Udon.

New features​

• Exposed three new TextMeshPro components to Udon.
  • Added TMP Dropdown, TMP InputField, and TMP Text to Udon.
  • TextMeshProUGUI and TextMeshPro and exposed through TMP Text.
  • VRChat will now open the on-screen keyboard when selecting a TMP InputField.
• Added two properties to BaseVRCVideoPlayer and exposed them to Udon.
  • int VideoWidth { get; }
  • int VideoHeight { get; }
  • These are also available in the subclasses VRCUnityVideoPlayer and VRCAVProVideoPlayer.
• Added five voice-related getter methods to VRCPlayerApi and exposed them to Udon.
  • float GetVoiceGain()
  • float GetVoiceDistanceNear()
  • float GetVoiceDistanceFar()
  • float GetVoiceVolumetricRadius()
  • bool GetVoiceLowpass()

Fixes​

• Worlds with vastly more renderers than materials will now build faster.
• Fixed a performance bottleneck when validating avatars after a local test build, especially when multiple avatars are present in the scene.
• Fixed some issues where the Network ID Utility could get confused about duplicate GameObject paths.
  • Note that it still is not recommended or fully supported to have networked objects share the same hierarchy paths!
• Fixed a missing reference error locking up the build panel if an audio clip was deleted or missing from an VRC_AnimatorPlayAudio state behaviour on the avatar.

Changes between 3.6.1-beta.2 and final release​

• Udon can now access the three new TextMeshPro components directly.
  • Only the properties listed in VRChat's documentation have been exposed.
  • The previously new VRC_TMP wrapper components have been removed.
• ClientSim: Udon behaviours instantiated via other Udon scripts will now initialize right away and have variables and functions ready.

Known Issues​

• The first time you open a Scene and select a GameObject inside a prefab with a U# Behaviour, the GUI for the component directly below that U# Behaviour will not show its GUI. Deselecting and re-selecting the prefab fixes this.
• Buffer Particles don't work as they did in Unity 2019, there is a workaround to fix them from community member hfcRed here.
• Unity 2022 sometimes causes Rider's debugger to stop for unhandled exceptions in Unity's IMGUI.
  • Please refer to this workaround and Jetbrains's bug tracker for more information.

This release overhauls the World SDK UI, exposes new Udon functions, and fixes some issues across the SDK and ClientSim.

Supercedes release 3.5.3, which was available for beta testing but was not launched officially.

New features​

• Big updates to the Worlds SDK for creators! This is a major update with a lot of additions including:
  • A rewrite of all almost all custom inspectors in the World's SDK.
  • Updated HelpURLs (the question mark on a component) to actually taking you to the VRC docs (gasp).
  • Properly added almost 20 components to the Add Component -> VRChat section.
  • The Two-Factor Authentication field in the SDK automatically submits once you enter six digits, instead of requiring you to press the Verify button.
• World creators now have the ability to modify the value of UnityEngine.Physics.bounceThreshold via Udon. Addresses this Canny request.
  • This allows world creators to have better control over when objects should or shouldn't bounce, which can be important for physics-based worlds.

Changes​

• Layers 3, 6, and 7 are now reserved layers for VRChat. Previously, these were internally reserved by Unity and were freed up in Unity 2022.
  • VRChat now reserves them for internal use moving forward and will move any objects in this layer to the default layer. Reflected here in our creator docs.

Fixes​

• Fixed the broken Standard Lite shader Emission feature.
• Fixed an error about failing to assign network IDs when trying to upload the default VRC world scene right after initialization.
• Fixed Unity warning when using the sample dynamic Robot Avatar from the VRChat Avatars SDK.
• Exposed missing string methods to Udon. Addresses this Canny request.
  • Certain variants of Trim, TrimStart, TrimEnd, and others were previously available in Unity 2019 but caused compilation issues in Unity 2022. This fixes those regressions.

ClientSim​

• Fixed joystick drift issues by adding input axis deadzones. Addresses this GitHub issue.
• Updated ClientSim to use IETF language codes instead of full language names to more accurately simulate VRChat's behavior.

Public API Changes​

• SDK methods from ShaderValidation have been moved into the ValidationUtils class.
• Method signatures from ValidationUtils have been modified. Anyone using these methods may need to update their code!

Fixes between 3.5.3-beta.2 and 3.6.0-beta.1​

• ClientSim input axis dead zones would make mouse movement awkwardly slow.
• World upload could fail with an AmbiguousMatchException when a scene contained components with multiple RequireComponent attributes.
• Calling Instantiate from Udon in certain events like OnPlayerJoined could fail in ClientSim.
• Pickups would not work in ClientSim.
• Canvas UI with VRC_UiShape components would not be interactable in ClientSim.
• VRC_ObjectSync and VRC_ObjectPool would fail to initialize in ClientSim.

Fixes between 3.6.0-beta.1 and final release​

• Fixed an issue that could cause editor crashes with a memory allocation warning under rare circumstances.

Known Issues​

• The first time you open a Scene and select a GameObject inside a prefab with a U# Behaviour, the GUI for the component directly below that U# Behaviour will not show its GUI. Deselecting and re-selecting the prefab fixes this.
• Buffer Particles don't work as they did in Unity 2019, there is a workaround to fix them from community member hfcRed here.
• The Editor may crash when updating a shader graph reference by another shader using UsePass. This is an issue with Unity 2022.3.6f1 and is fixed in 2022.3.14f1.
• Unity 2022 sometimes causes Rider's debugger to stop for unhandled exceptions in Unity's IMGUI.
  • Please refer to this workaround and Jetbrains's bug tracker for more information.

This release brings new functionality for avatar creators and various fixes.

New features​

• Added the VRCHeadChop component to the avatars SDK.
  • This component allows avatar authors to control which parts of their avatar are hidden from the perspective of the user wearing it.
• Added the AnimatorPlayAudio state behaviour to the avatars SDK.
  • This allows you to modify an AudioSource when transitioning to an animation state.
  • It can change the audio clip, volume, pitch, or loop. It can also play or stop the AudioSource automatically.
• Added new OnInputMethodChanged Event to Udon, which is triggered whenever the user switches Input Methods, from a Keyboard to a Game Controller, or a Game Controller to a Touchscreen, for example.

Changes​

• The worlds SDK will now suggest replacing Unity's default UI shader with a super-sampled shader where appropriate.
  • This can help improve the readability of text elements when viewed in VR.
  • TextMeshPro components are not affected by this change. Their readability is very high without supersampling.
• Added Byte and Bit operations to Udon.
  • Exposed System.BitConverter, System.Buffer, and System.Text.Encoding to Udon.
  • Added DataToken.BitCast method.
• Added ResultBytes field to string downloader event to allow raw data downloads.
• The avatars SDK now warns against using mixed Write Defaults settings across avatar animators.

Fixes​

• If an Udon script uses [RequireComponent], the SDK will now silence some harmless errors while building.
• Updated UnityEngine.Timeline package version & added to base SDK package dependencies.
• Changed "Polygons" to "Triangles" in SDK avatar performance stats for a more accurate description of recommended limits.
• Fixed issues with InputUse Udon events firing constantly when using VRChat Mobile. They should now only fire when a genuine tap is done, not while swiping or long-pressing.

ClientSim​

• Added all languages supported by VRChat.
• Added support for player scaling APIs.
• Fixed EditorOnly objects not getting removed in Play Mode.
• The stacked camera is now enabled/disabled depending on the state of the pause menu to improve performance.

Known Issues​

• The first time you open a Scene and select a GameObject inside a prefab with a U# Behaviour, the GUI for the component directly below that U# Behaviour will not show its GUI. Deselecting and re-selecting the prefab fixes this.
• Buffer Particles don't work as they did in Unity 2019, there is a workaround to fix them from community member hfcRed here.
• The Editor may crash when updating a shader graph reference by another shader using UsePass. This is an issue with Unity 2022.3.6f1 and is fixed in 2022.3.14f1.
• Unity 2022 sometimes causes Rider's debugger to stop for unhandled exceptions in Unity's IMGUI.
  • Please refer to this workaround and Jetbrains's bug tracker for more information.

This release contains multiple Unity 2022 follow-up fixes and overall quality-of-life improvements.

New features​

• New methods have been added to the Worlds SDK. These methods were previously only available to Creator Economy sellers but can now be used by all world creators.
  • Store.OpenGroupPage: Opens a group page based on its grp_ ID.
  • Store.OpenGroupStorePage: Opens a seller's store page.
  • Store.OpenGroupListing: Open a seller's listing.
• Various features for sellers have been added to the Worlds SDK.
  • These features cannot be used in an uploaded world unless you are a seller.

Changes​

• The VRChat SDK now automatically enables "Clamp BlendShape Weights" option in VRChat projects. This mirrors VRChat Client behaviour and prevents BlendShapes from moving beyond their maximum (100) offset.

Fixes​

• Fixed spatialized audio sources creating warnings when entering play mode or adjusting their settings. Users might be prompted to restart their editor when adding the 3.5.1 SDK for the first time.
• Fixed upload speed increase logic breaking on macOS/Linux, preventing users from uploading.
• Fixed an issue where the SDK would not detect if the blueprint ID of a world / avatar is taken by another user or invalid, and attempt to upload a new world / avatar to that ID. That would result in an "Application Error" message. The blueprint ID is now cleared correctly in this case.
• Fixed an issue where builds that went above the upload limit, e.g. 10 MB for Android Avatars, reported the size incorrectly. The SDK now correctly shows all the decimal points for the size. You should no longer see error messages like "10.00 MB > 10.00 MB".

Known Issues​

• The first time you open a Scene and select a GameObject inside a prefab with a U# Behaviour, the GUI for the component directly below that U# Behaviour will not show its GUI. Deselecting and re-selecting the prefab fixes this.
• Buffer Particles don't work as they did in Unity 2019, there is a workaround to fix them from community member hfcRed here.
• The Editor may crash when updating a shader graph reference by another shader using UsePass. This is an issue with Unity 2022.3.6f1 and is fixed in 2022.3.14f1.
• Unity 2022 sometimes causes Rider's debugger to stop for unhandled exceptions in Unity's IMGUI.
  • Please refer to this workaround and Jetbrains's bug tracker for more information.