Automatic Fixes

When VRCFury is present in a project, it applies several fixes to resolve common VRChat and Unity bugs.

VRCSDK (Base)

• The VRCSDK spams the unity console with AmplitudeAPI errors if your network uses pihole or adguard
  • VRCFury hides these messages from the console, since they are non-actionable and clutter actual errors that the user is looking for
• A bug in Mono can make the VRCSDK builder fail to open when the system locale is non-English and the project path contains non-English characters
  • VRCFury patches this so the builder still opens normally
• Having the VRCSDK in a project creates a useless folder called XR in the Assets root
  • VRCFury automatically moves the Assets/XR folder into its own temporary package to keep your project clean
  • Fixed in latest VRCSDK
• Some versions of the VRCSDK save assets for no useful reason during script reloads
  • VRCFury removes that extra save step to reduce unnecessary scene and asset churn
  • Fixed in latest VRCSDK

VRCSDK (Avatars)

• The VRCSDK incorrectly applies android validations while in windows mode if you select the android tab in the inspector of a texture asset
  • VRCFury automatically syncs this setting back to the proper value when the vrcsdk dialog loads and when a build begins
• The VRC avatar descriptor can wind up with duplicate FX layers if you change the rig to generic and back to humanoid
  • VRCFury repairs the descriptor by restoring the proper FX and Action layer assignments
• The VRCSDK fails with a cryptic error message when menu icons are too large
  • VRCFury detects this condition and shows a useful error message with the icon paths
• VRCSDK contacts do not properly distinguish between "Self" and "Others" when testing in editor play mode
  • VRCFury automatically adjusts avatar contacts in play mode to make "Self" and "Others" work properly
• The VRCSDK adds unwanted Undo entries when it synchronizes Gesture and FX layer masks while opening an avatar descriptor or finishing a build
  • VRCFury applies these automatic mask updates without recording them in the Undo history
• The VRCSDK switches back to the Authentication tab every time you reload scripts
  • VRCFury automatically switches the VRCSDK to the Builder tab if you are already logged in when scripts reload
• Dynamics and contacts stop working after the first time you enter play mode in VRCSDK 3.7.6
  • VRCFury patches the VRCSDK to fix this bug
• Avatar colliders can be unset, or set to incorrect transforms, if the rig is modified and then the VRCSDK collider section is not viewed afterward
  • VRCFury forces the VRCSDK to recalculate collider transforms at the beginning of each build
• The VRCSDK fails upload if textures do not have Streaming Mip-Maps enabled
  • VRCFury automatically clones textures and enables Streaming Mip-Maps on them when needed
• The VRCSDK fails upload if menu icons are too large or uncompressed
  • VRCFury automatically clones menu icons and resizes or compresses them to fit VRCSDK limits
• The VRCSDK fails upload if audio clips do not have Load in Background checked
  • VRCFury automatically clones those clips and enables the setting when needed
• Non-mobile materials can still get pulled into a Quest/mobile upload if they are referenced by animations
  • VRCFury removes those materials from mobile builds so they are not included in the upload bundle
• Some Unity constraints on avatars need to be upgraded to VRC Constraints for VRChat to use them correctly
  • VRCFury automatically upgrades them during upload
  • In the rare situation that this breaks things, it can be disabled in Tools > VRCFury > Settings
• Certain particle system settings cause VRChat to disable avatars for Security Checks
  • VRCFury automatically corrects those settings before upload
• VRCAnimatorPlayAudio clips are still included in Android builds even though they cannot play there
  • VRCFury removes those behaviours from mobile builds to save upload space
• VRChat Expression Parameters sync across platforms by order and type rather than by name
  • VRCFury aligns mobile parameter order to the last desktop upload of the same blueprint ID, fills missing entries with placeholders, and disables sync on mobile-only extras with a warning
• Expression menu items with an invalid type show up as Button in the editor, but break in game and in tools
  • VRCFury converts invalid menu item types to Button to match what the editor shows
• VRChat does not support Animator Override Controllers
  • VRCFury automatically flattens Animator Override Controllers on your descriptor, making them compatible with VRChat.
• VRChat throws away parameters in game if there are more than 256 unique params, even if they are not network synced
  • VRCFury detects this condition and shows a useful error message
• VRChat throws away contacts in game if you have more than 256 total
  • VRCFury detects this condition and shows a useful error message
• VRChat IK and OSC will crash if you have two parameters with the same name, except one has underscores where the other has spaces
  • VRCFury automatically renames parameters conflicting in this way
• VRChat IK and OSC will crash if you have a parameter containing the text []
  • VRCFury automatically renames parameters conflicting in this way
• VRChat ignores Animator Tracking Control behaviors that run too soon after the avatar is loaded
  • VRCFury buffers all tracking control changes and repeats them several times as the avatar is loaded
• Params in the FX controller with invalid parameter types break synchronization of the mirror clone
  • VRCFury automatically removes all controller parameters with invalid types
• Physbones not marked as Animated targeting humanoid bones completely break full-body animations, even if they are set to Ignore multi-child mode
  • VRCFury automatically marks all physbones targeting humanoid bones as animated
• The expressions menu does not appear in-game if your avatar does not have a valid humanoid rig
  • VRCFury automatically attaches a dummy rig to any non-humanoid avatar to ensure the menu loads properly in game
• VRCSDK dialog box crashes when you don't own the blueprint ID currently set in the Pipeline Manager
  • VRCFury patches this VRCSDK bug
  • Fixed in latest VRCSDK
• The VRCSDK opens an empty Animator window that cannot be closed if scripts reload while viewing a Parameter Driver
  • VRCFury patches this issue to not occur
  • Fixed in latest VRCSDK
• The VRCSDK spams the console with "Animator is not playing an AnimatorController" before the animator loads if your avatar contains contacts
  • VRCFury patches this issue to not occur
  • Fixed in latest VRCSDK
• Because of a Unity editor bug, VRCSDK's AnimatorPlayAudioEditor can throw an exception after scripts reload if the editor was previously used on a behaviour that has since been deleted
  • VRCFury patches this editor path to return safely instead of throwing
  • Fixed in latest VRCSDK
• Some versions of the VRCSDK break the testing of contacts in play mode
  • VRCFury patches the VRCSDK to resolve this issue
  • Fixed in latest VRCSDK
• A bug in the VRCSDK prints an error message related to "stopwatch" when using play mode for the first time after scripts reload
  • VRCFury patches the VRCSDK to fix this bug
  • Fixed in latest VRCSDK
• The VRCSDK collider editor automatically reverts custom collider transforms any time you look at the component
  • VRCFury prevents this from happening when in play mode, so custom collider transforms will appear properly while testing
  • Fixed in latest VRCSDK
• The VRCSDK collider editor doesn't mirror offsets properly if the avatar is not at x=0
  • VRCFury patches the mirroring logic so colliders mirror properly across the avatar origin
  • Fixed in latest VRCSDK

VRCSDK (Worlds)

• VRCFury can invoke VRCSDK build callbacks while testing, even though no upload is taking place
  • VRCFury skips upload-only product ID and scene network ID assignment unless an actual upload is in progress
• Assets/Create/U# Script can fail if you save into a package outside the project root
  • VRCFury patches the save path handling so script creation still works
• ClientSim and related world tooling can spam the console with non-actionable errors
  • VRCFury suppresses the known noise so real errors are easier to see
• The first draw of a UdonSharp inspector can clip the component below it
  • VRCFury patches the inspector so it lays out correctly the first time
  • Fixed in latest VRCSDK
• World projects can spam Value cannot be null errors during certain serialization and reload edge cases
  • VRCFury suppresses this non-actionable error noise
  • Fixed in latest VRCSDK
• UdonBehaviour.OnDisable can run during play mode teardown when the scene is already half unloaded
  • VRCFury blocks that broken teardown path to avoid follow-on errors
  • Fixed in latest VRCSDK
• "Build & Reload" can leave the SDK world build flag unset on supported SDK versions
  • VRCFury patches the build flow so world testing and build state stay in sync
  • Fixed in latest VRCSDK
• ClientSim persistence can try to save multiple times in parallel
  • VRCFury gates those saves so they do not race each other
  • Fixed in latest VRCSDK
• ClientSimNetworkingUtilities can break when domain reload is disabled
  • VRCFury resets that state so play mode remains usable
  • Fixed in latest VRCSDK
• ClientSim can delete EditorOnly objects too early when scene reload is disabled
  • VRCFury delays that cleanup so testing behaves correctly
  • Fixed in latest VRCSDK
• UdonSharp can run a full recompile when VRCFury invokes build callbacks for testing
  • VRCFury skips that upload-only recompile unless an actual upload is in progress
  • Fixed in latest VRCSDK

Unity (Editor)

• VRCFury removes the built-in unity "Toggle", "Dropdown" and "Toggle Group" components from the Add Component menu, as they are not usable during avatar creation, and cause confusion when creating an avatar Toggle.
• Unity 2019 does not properly apply changes from nested prefabs when those changes are made externally (for example, using version management) until the outer prefab is reimported
  • VRCFury automatically recursively triggers unity to reimport prefabs in inside-out order prior to loading their vrcfury components
  • This bug is resolved in Unity 2022
• Users accidentally hide console errors and then complain that there are no script errors when checking
  • VRCFury ensures the Error logging level is enabled in the unity console whenever scripts are reloaded
• Users accidentally go into pause mode forever and then complain that Gesture Manager does not work properly
  • VRCFury ensures pause mode and "Error Pause" are both disabled when scripts are reloaded
• Reloading scripts in the editor breaks things if you are in play mode
  • VRCFury automatically changes unity's "Compilation During Play" setting to "Recompile After Finished Playing" if it is set to "Recompile And Continue Playing"
• Unity can segfault during the avatar build if certain methods are called after using the VRCSDK's custom thumbnail camera
  • VRCFury unsets the unity main camera before executing to prevent this issue
• Unity can invoke expensive material property drawers while VRCFury reads or writes material properties during a build
  • VRCFury suppresses those drawers for its build-time operations, avoiding unnecessary work and slowdowns
• Asset postprocessors can perform expensive or unwanted work when VRCFury writes transient generated build assets
  • VRCFury skips asset postprocessors for those generated asset writes
• Unity Animator Controller editors spam the console with "Invalid Layer Index" and shows incorrect layer weight and parameter values while viewing an avatar controlled by a controller mixer (Gesture Manager or av3emu)
  • VRCFury patches the animator controller editor to work properly with controller mixers
• A bug in Mono breaks the VRCSDK dialog when Harmony is used, the system locale is non-english, and the project path contains non-english characters
  • VRCFury patches Mono to prevent this issue from occurring to the VRCSDK and other plugins using Assembly.GetName()
• Unity throws a NullReferenceException in "UnityEditor.Graphs.Edge.WakeUp" when reloading scripts if an empty animator has been open recently
  • VRCFury fixes this unity bug and prevents the error
• Unity reloads all scripts and scenes when entering play mode
  • VRCFury automatically disables play mode domain reload and scene reload, which greatly speeds up entering play mode, and is (at this point) compatible with basically all unity plugins
• Unity's "Mesh Data Optimization" takes FOREVER during avatar uploads, and is not a required process
  • Mesh data optimization removes unused UV channels from meshes if it determines the UVs are unused by all attached shaders
  • The duration of this process scales with the number and complexity of shaders used. Since poiyomi creates a unique shader for each material, this complexity grows extremely fast.
  • Unused UV channels are already quite rare (why would a model have them if they are not used?), and an entire UV channel is only half the size of one single blendshape.
  • VRCFury automatically disables this optimizer to massively speed up avatar builds
• Dragging a controller state, by even a single pixel, while previewing a controller in play mode, immediately disables the animator and breaks gesture manager
  • VRCFury prevents you from dragging controller states while previewing them in live-link
• Unity's controller layer list scrolls all the way to the top any time you move or delete a layer
  • VRCFury patches this issue

Unity (Avatars)

• Transition times for muscle animations are ignored by unity when placed on layer 0 of an animator
  • VRCFury inserts an empty base layer when this issue is detected
• Assets that were used in an animator previously, but the layer was deleted, are still included in the upload bundle
  • VRCFury corrects this by walking all controllers and building a new copy containing only the layers and states that are actually used
• Controller layers that are empty still take processing time in game
  • VRCFury automatically removes layers that are guaranteed to be empty and have no side-effects
• Animations that target invalid objects still take processing time
  • VRCFury automatically removes animation properties that are guaranteed to be invalid (targeting an object that does not exist)
• States in an additive layer marked as WD off can cause blendshape values to multiply by 3x, and cause unrelated transforms to move continuously
  • VRCFury removes the additive controller that VRChat adds by default (unused by virtually everyone)
  • VRCFury automatically marks all additive states as WD on (only if you opt into Fix Write Defaults)
• States marked as WD off containing a direct blendtree can cause unrelated animations in the controller to break
  • VRCFury automatically marks all direct blendtrees as WD on (only if you opt into Fix Write Defaults)
• Controller states and blendtree children with a "None" (missing) animation can break transforms and other animations in avatars using WD off
  • VRCFury automatically replaces missing animations with an empty 1-second clip in these scenarios
• Unity "claims" transforms and muscles for the lowest controller that has them unmasked, even if they are not actively being animated
  • This is a common issue between an avatar's Gesture and FX layers, because when users have no mask in FX, it "claims" all transforms, breaking any transforms that are attempted in Gesture.
  • VRCFury solves this issue by moving all non-muscle animations from Gesture into the top of FX, ensuring they continue working as they did previously.
  • Applying a mask to all FX layers (as recommended in other guides) is not a foolproof solution, as masking layers is impossible in some scenarios (read more about it here).
• Using WD off in a controller state that is placed in a layer at or below a state with WD on causes unity to break all animations in the controller
  • VRCFury detects this scenario and offers the option to solve it automatically by aligning the WD of each setting.
  • Additive layers and direct blendtrees are excluded from this rule, and must always be WD on (as described above).
• MMD worlds do not work properly for avatars using WD off, disable the Gesture controller, and (in some songs) disable FX layer 1 and 2
  • VRCFury automatically resolves all of these issues (only if you opt into VRCFury MMD Compatibility)
• When you delete an int controller parameter and recreate it as a bool, all controller transitions using that parameter will say "True", even though internally they are broken and will never transition.
  • VRCFury automatically corrects these transitions to work if the bool is true, as indicated by the editor.
• When you delete or change the type of a parameter, but have conditions expecting the old type, attempting to use the controller will cause unity to abort the controller entirely, breaking the avatar in the editor and in game
  • VRCFury automatically removes these transitions, as they are never valid
• When you delete a float parameter and recreate it as an int, unity will internally respect the old float thresholds even though the editor displays them as floored
  • VRCFury automatically updates the internal thresholds to reflect the value displayed in the editor
• If one of the controllers on the avatar descriptor is set to "None", unity animation states temporarily reset in between frames, causing Audio Sources to restart every frame
  • VRCFury automatically replaces "None" controllers with an empty replacement
• Animator Tracking Control behaviors from various unrelated plugins can break MMD dances
  • VRCFury buffers all tracking control changes and triggers them only once the avatar is not in an MMD station
• Avatars with WD on will incorrectly always select the default value of material properties from the first material slot, even if that material doesn't have the property.
  • Strangely, this issue only happens in-game and is not reproducible in the editor
  • VRCFury resolves this issue by detecting these cases and forcefully records the default state in a top defaults layer, even if WD is on.
• Because of the way stereo cameras work in VR, objects with small bounding boxes can disappear when still in view, even if the bounding box is technically correct.
  • VRCFury automatically increases the bounds of all renderers to fill the existing overall bounds of the avatar.
  • Renderers using lights are left untouched (DPS/TPS/SPS).
  • The bounds are not increased if they will impact the avatar's overall bounds, ensuring the performance rank will not be affected.

Unity (Package Importer)

• Importing Poiyomi or the VRCSDK from an avatar package when they are already installed breaks the project for users who do not know to exclude them from the import
  • VRCFury prevents Poiyomi or VRCSDK asset files from being imported if they are already detected in the project.

AudioLink

• AudioLink in the editor does not automatically attach to newly-created renderers after entering play mode.
  • VRCFury reinitializes all AudioLink components in the scene after an avatar's preprocessor hooks have run.

Av3Emulator

• Av3Emualator throws errors and breaks if an animator in the scene disappears or has its controller changes after play mode has begun
  • VRCFury reinitializes Av3Emu after an avatar's preprocessor hooks have run

CommonTXL / Texel

• If CommonTXL / Texel packages are present, some scripts still target VRCPlayerApi[100] and break on newer SDK layouts
  • VRCFury patches those references to VRCPlayerApi[200]

Bakery

• If Bakery is present, its editor integration can misbehave with Unity Play Mode Options
  • VRCFury patches it so fast play mode remains usable

PCSS Shader

• PCSS shader (available on Booth) contains a pass that fails to compile (as of 2026)
  • When used by SPS, VRCFury automatically patches the shader to compile properly.

Poiyomi

• Poiyomi locks down all materials when preprocessor hooks run without an actual upload, including in play mode in versions before 9
  • VRCFury only allows Poiyomi's material-locking callbacks to run during an actual upload.
• Thry's Auto Anchor can overwrite VRCFury's Anchor Override Fix when an avatar is uploaded
  • VRCFury skips Thry's Auto Anchor for avatars using Anchor Override Fix.
• Thry can rebuild its preset cache after VRCFury creates generated material assets without running asset postprocessors
  • VRCFury registers those material GUIDs with Thry's known-material cache when saving generated assets.

lilToon

• lilToon can lock down materials when VRCFury invokes build callbacks without an actual upload
  • VRCFury only allows lilToon's material-locking callback to run during an actual upload.