Avatar Bugs & Feature Requests

Affected private avatar: Robot （nested armatures） ( avtr_6cb82e04-86d1-4afe-9261-583b03496c06 ) by WubTheCaptain Create a minimal Excellent avatar (Robot) with 1 particle system, set its max particles to 2. Duplicate the minimal Excellent/Good avatar (Robot) and nest it under the avatar. Modify the particle system under the nested avatar to have a maximum of 2147483647 particles. Delete the animator component, VRC avatar descriptor and pipeline manager script from the duplicated avatar nested under the actual avatar. (Optionally, delete the armature and body meshes too.) Build & Test. Build & Publish as a private avatar. Check the avatar stats of the local SDK test avatar & uploaded avatar separately. Expected result: Red, Very Poor 2,147,483,647 particles in local SDK avatar, SDK performance rank estimation and after upload. Actual result: Local SDK test avatar and SDK performance ranking estimate reports Very Poor 2,147,483,647 particles. However, after Build & Publish the avatar shows Excellent, -2,147,483,648 particles. The avatar is simultaneously ranked both "Good" and "Very Poor" in the client. Remote and local users see this as a Good avatar on nameplate. Typically these avatars behave like unbounded number of particles (a crasher avatar) when particle limiter is disabled in client settings, even if the particle count is reported as negative. Additional info: Nested avatars/armatures must be used, because otherwise the particles will always be capped at maximum integer value (2,147,483,647). SDK 3.10.4, VRChat 2026.2.3p2 Build 1866 (unity-6). Affects both the main branch and unity-6 public beta branch.

(Note: This feature is still in development, so any of the details below might change before the final release.) The Avatar Optimizer runs automatically when you build or upload your avatar. It intelligently generates atlas textures and combines meshes and materials to reduce the number of draw calls, improving performance. You can configure the optimization settings to preserve certain blend shapes, skip generating atlas textures, or disable the optimizer entirely. You can preview optimized Avatars before uploading to check if the optimizations worked correctly. At first, only the Standard Lite and Toon Standard shaders will support material merging and texture atlasing. If you're a shader developer, our documentation will explain how to make your custom shader compatible with the avatar optimizer. Once we're ready, our goal is to test the avatar optimizer in a closed beta to collect more data on its usefulness and to inform our next steps.

Since the Reference Cube has AudioLink support, even on Quest, it only seems natural that Quest avatars should be able to have an AudioLink-supported shader whitelisted/added to the SDK next. Quest users are often missing out on AudioLink, since Quest only allows certain shaders to be used, otherwise it gets replaced by the infamous error shader. Could we have an AudioLink shader or add support for it for Quest avatars?

Luicfer chi by skyster hair from roxifluff ( avtr_8e1cf26f-ca67-4e22-85c2-cee7adfbf875 ) by Skyla~ is loadable without "Security checks failure" errors, but fails to attach the avatar consistently. The avatar 3D preview loads correctly. Expected result: Load into the avatar, or give a "Security checks failed" error? Actual result: Error robot. Additional info: Logs spam indicate Leaked AvatarAnimLayer. errors and Avatar attach failed with exception: System.IndexOutOfRangeException: Index was outside the bounds of the array. .

Syncing has been a major issue between VRChat avatars for many years. Ensuring that other people see parts of your avatar in the same place—regardless of whether they’ve just turned your avatar on, joined late, or are looking in the mirror—is one of the biggest challenges for anyone creating complex avatars. The lack of a reliable way to sync avatars stifles creativity and limits what users can do. What we need is a "Freeze to World" and "Rebake Offset" option on VRC constraints, or a new command that allows game objects or bones to be synced over the network. Community-built workarounds for these issues have helped a lot (VRLabs has done some great work on this), but they come with their own performance costs and animator complexities, making them unsuitable for all situations. World objects are cool, but not every situation needs a world-droppable campfire or DJ deck. For example, I want to be able to take the helmet off my avatar, leave it on the table, and have everyone who joins see it there.

For AV3 development having separate GestureXWeight parameters for the trigger and grib buttons would give avatar developers a bit more flexibility in their avatar control. Currently im sitting with the problem that a newly added revolver toggle where i wanna depress the Grip button to unholster the gun and depress the trigger to shoot cannot be realized because there is no separate GestureXWeight parameters for the trigger and grip buttons. However this could also be used to make more complex facial expressions if needed increasing player expressions. Fx using a 2D blend-tree for one of your facial expressions to make it more dynamic.

There could be an option to include an "Extended Range" variant of Radial Puppets that allow players to use a float for its full precision range. As far as I am aware, floats only have 256 possible values when networked in avatar parameter terms, meaning that each step of a float cover about ~0.3% per step (assuming dividing 1/256) which is great! Until... you consider that Radial Puppets only go from 0 to 1, and floats entire range is from -1 to 1. Because of this, a lot of avatars are wasting half of their float precision being used for most of the time, nothing. In MOST cases this is fine (Nobody has complained about this so far...) but it still only leaves you with ~0.7% per step (dividing 1/128) and that is nearly 1%. Depending on your setup, animations and more, this can look pretty jagged and 'stepped' through the network to other players. Either as a variant or a toggle on the current Radial Puppets. This also means that most people wouldn't have to worry about turning off this feature and instead has to be manually selected when making your Avatar Menus.

Same issue when preloading the big worlds, when player/others have changed the avatar before preload is finish, game will keep loading the world anyway, and then avatars. It's understandable avatars with accessories being loads the last, but the local avatar(not cached?) is another thing, it should load first no matter what(which usually not issue unless player use accessories), otherwise in bigger lobby(or slow internet) it will surely cause issues(and more since there will be more accessories in the future) since you will have no idea how yourself looks like when people came and greets/talk to you. The percentage bar also mislead since it will show the loading progress for whole instance(until everyone joined before you finished unless culled) instead of the actual progress to your own avatar loading.(build 1854)

I suggest "VRChat/Mobile/Particles/Alpha Blended" be relabeled to "VRChat/Particles/Alpha Blended" specifically for the Avatar SDK to reduce confusion regarding Quest compatibility. you shouldn't have the Worlds and Avatars SDKs installed at the same time and the shader is not bundled with the avatar package, so I cannot imagine its path being different causing any issues.

I think when you use radial menues the icons gets cowered too much by the percentage text which makes it hard to see what it represents. This is especially bad with detailed icons.