2026-11-20 公開

Write Defaults の意味と、オンとオフを混ぜたときのつまずき

アバターのアニメーターで、Write Defaults をオンにするかオフにするか分からない。切り替えた表情や衣装が戻らない、思わない値になる。ここでは、VRChat の作る人向けの公式の説明にある、Write Defaults のオンとオフの違いと、気をつける所をまとめます。対象は、Unity でアバターのアニメーターを作る・直す人です。公式のページは 2026-11-20 に確かめました。

まず見る所

アバターのアニメーターの中で、Write Defaults がオンのステートとオフのステートが混ざっていないかを見ます。公式の説明によると、混ぜると思わない値になることが知られていて、SDK は混ざっていると注意を出します。

オンとオフの違い

公式の説明によると、Write Defaults は、アニメーターの中のステートごとの設定です。

  • オフのステートは、アニメーションで動かす値だけを決めます。決めた値は、また別のアニメーションで動かすまで変わりません
  • オンのステートは、そのステートで動かしていない値を、元の値に戻します。たとえば、ある値を 0 から 1 に動かしたとき、そのステートを出ると、次のステートが 1 のまま動かしていなければ、元の 0 に戻ります

オンかオフに、そろえる

公式の説明は、どちらを選んでも、アバター全体でそろえる(全部オフか、全部オン)よう勧めています。混ぜることは Mixed Write Defaults と呼ばれ、思わない値になることがある、と書かれています。

VRChat の最初からあるアニメーターや見本のアニメーターは、オフを使っている、とも書かれています。

オフにするときに気をつけること

公式の説明にある、オフにするときの注意です。

  • 新しく作ったステートは、最初はオンになっています。作るたびにオフに変える必要があります
  • 値を決まった値に戻すためのアニメーションを、足す必要があることがあります
  • レイヤーの中のどのステートでも、そのレイヤーが動かすすべての値を、はっきりアニメーションで決めるよう勧めています
  • どのステートにも、少なくとも 1 つの値を動かすアニメーション(motion)を入れるよう書かれています。motion が None のステートや、空のアニメーションのステートは、オンと同じように動きます

コミュニティの勧め(加算のレイヤーと Direct のブレンドツリー)

公式の説明には、VRChat のアバターを作る人たちのコミュニティの勧めとして、次の 2 つはオンにする、と書かれています。ほかをオフにしていても同じで、SDK もこの 2 つでは、混ぜたことの注意を出しません。

  • 加算(additive)で混ぜるレイヤー
  • Direct で混ぜるブレンドツリー

まとめ

  • オフは動かした値だけを決め、オンは動かしていない値を元に戻します
  • アバター全体で、オンかオフにそろえます(混ぜると思わない値になることがあります)
  • オフにするなら、新しいステートを作るたびにオフに変え、どのステートにもアニメーションを入れるようにします

確かめていないこと

  • この記事は、VRChat の作る人向けの公式の説明に書いてあることをまとめたものです。作者がアニメーターを作って確かめたものではありません
  • 加算のレイヤーと Direct のブレンドツリーをオンにする話は、公式の説明の中で、コミュニティの勧めとして書かれているものです
  • Modular Avatar などのツールが、アニメーターをまとめるときの Write Defaults の扱いは、扱っていません
  • 「表情や衣装が戻らない」という症状は、このページには書かれていません。Write Defaults が原因かどうかは、アニメーターを見て確かめてください

出どころ

2026-11-20 にページを開いて確かめました。

同じ分野の読みもの

こんなツールが欲しい、を送る

困っていることを、ひとことでも。良いアイデアは作って、サイトと X でお知らせします。

どの分野ですかえらばなくてもかまいません

名前やメールは聞きません。送った人を見分けるものは残しません。いただいた声は、作者が読んで、次に作るツールの参考にします。