VRChat Avatar Error Guide日本語Free tool
VRChat Avatar Error Guide

VRChat "This avatar uses a mixture of Write Defaults" - expressions not resetting fix

Quick fix
  1. Make them all the same (matching the majority is safest)
  2. If a gimmick's readme specifies a setting, follow it

Want it checked automatically? Avatar Setup Doctor checks your parameters and animator layers in one click - free version. Try it free

What you see on screen:

This avatar uses a mixture of Write Defaults in its animator states. To avoid animation issues, VRChat recommends using the same Write Defaults setting across all animator states.

What it means

Write Defaults (whether values reset after an animation ends) is on in some animator states and off in others. It doesn't block the upload, but it causes expressions that don't reset, mixed expressions, and gimmicks that don't turn off.

Common causes

How to fix it

  1. Make them all the same (matching the majority is safest)
  2. If a gimmick's readme specifies a setting, follow it
  3. For gimmicks added with Modular Avatar, turn on "Match Avatar Write Defaults" in Merge Animator

Before you change anything, make a full copy of your project folder so you can go back.

Fix this automaticallyAvatar Setup Doctor adds a window to Unity. Press Diagnose and it lists what's wrong with your avatar project, why, and how to fix it - the paid version fixes many issues in one click. Free version available.
For this problem, it lists animators and layers where on and off are mixed.
Get Avatar Setup Doctor (Free version available)

Related errors

See other errors