SUMMARY

The SDK's default Additive controller (vrc_AvatarV3IdleLayer) has a single layer whose blending mode is Additive, and both of its states ("Upright Idle" and "Empty") are Write Defaults OFF.

When no WD OFF state in a playable layer above Additive covers it, every shape key that

- is bound by some clip in the avatar's playable layers, and

- has a non-zero value on the SkinnedMeshRenderer

is shown at 3x its value (30 becomes 90).

We observed this in the VRChat client on an affected avatar, and reproduced it with the minimal steps below in Gesture Manager.

Setting only the Additive controller's states to Write Defaults ON fixes it, without changing the idle body motion.

STEPS TO REPRODUCE

Environment: Unity 2022.3.22f1, VRChat SDK Avatars 3.10.4, Gesture Manager 3.9.9

- "Idle" (default state): an empty clip, Write Defaults ON.

- "Shape": a clip that animates that shape key, Write Defaults ON, with no transitions into it (it never plays).

Assign this controller to the FX slot.

(Packages/com.vrchat.avatars/Samples/AV3 Demo Assets/Animation/Controllers/)

into Assets, turn Write Defaults ON on every state, and assign it to the Gesture slot.

Expected: 30

Actual: 90

Actual: 30. The idle body motion is unchanged.

Notes:

- Only shape keys that some clip in the playable layers binds are affected, even if that clip never plays.

- A value of 0 stays 0.

- Base does not matter.

- The error is hidden while any WD OFF state plays above Additive: the default Gesture controller, a WD OFF FX, or Action at weight 1 during an emote or AFK. This is why most avatars never notice it.

WHY IT HAPPENS

A WD OFF state asserts every animated binding of the avatar. For the bindings it does not animate itself, it fills in its held (bind-time) value.

On the Additive input, which is additive, that dense pose is added on top of the lower layers twice:

- once through the additive playable input, and

- once more through the additive layer blend.

So a shape key the Additive layer never touches still gets its default value added twice:

d + 2d = 3d

With an empty (zero-curve) clip in the same state, the value does not settle; it keeps growing every frame.

WHY WD ON IS SAFE FOR THIS CONTROLLER

We compared Additive = default (WD OFF) against a WD ON copy in every combination of:

- Base: WD OFF / WD ON

- Gesture: WD OFF / WD ON

- FX: WD OFF / WD ON / mixed per layer

- Action weight: 0 / 1

That is 24 configurations, 300 frames each, checking all 54 humanoid bones and the root. The idle clip was a muscle-only additive clip that moves the body by up to 8 degrees.

Results:

- Shape keys, Additive WD OFF: 3x whenever Gesture and FX are WD ON and Action is at weight 0. 1x otherwise.

- Shape keys, Additive WD ON: 1x in all 24 configurations.

- Humanoid motion: identical in all 24 configurations (0 degrees / 0 m difference between WD OFF and WD ON Additive).

Humanoid muscles are applied as a single human pose, which Write Defaults does not affect, so the idle motion does not depend on this setting.

On WD OFF avatars the change is invisible. On WD ON avatars it removes the error.

Tools already apply this fix: VRCFury's "Fix Write Defaults" option marks all additive states WD ON.

REQUEST

Please set Write Defaults ON on both states of the SDK's default Additive controller, and on the client's internal equivalent if it mirrors the SDK asset.

RELATED

"[BUG] VRChat apply blend shape values 3 times" (2020, marked fixed) has the same symptom. The cause described here is in the default controller asset.

------日本語------

概要

SDK 既定の Additive コントローラ（vrc_AvatarV3IdleLayer）は、合成方式が Additive のレイヤー 1 枚だけでできていて、その 2 つのステート（"Upright Idle" と "Empty"）はどちらも Write Defaults OFF になっている。

Additive より上の Playable レイヤーに、これを覆う WD OFF のステートが無いとき、次の条件を満たすシェイプキーがすべて、その値の 3 倍で表示される（30 が 90 になる）。

- アバターの Playable レイヤー内のどこかのクリップが bind している

- SkinnedMeshRenderer 上の値が 0 でない

問題が起きるアバターで、VRChat クライアント上での発生を確認した。また、下記の最小手順で Gesture Manager 上でも再現した。

Additive コントローラのステートだけを Write Defaults ON にすると、idle の体の動きを変えずに直る。

再現手順

環境: Unity 2022.3.22f1、VRChat SDK Avatars 3.10.4、Gesture Manager 3.9.9

- "Idle"（既定ステート）: 空のクリップ、Write Defaults ON

- "Shape": そのシェイプキーを動かすクリップ、Write Defaults ON。ここへの遷移は作らない（再生されない）

このコントローラを FX 枠に割り当てる。

（Packages/com.vrchat.avatars/Samples/AV3 Demo Assets/Animation/Controllers/）

を Assets にコピーし、全ステートの Write Defaults を ON にして、Gesture 枠に割り当てる。

期待値: 30

実際: 90

実際: 30。idle の体の動きは変わらない。

補足:

- 影響を受けるのは、Playable レイヤー内のどこかのクリップが bind しているシェイプキーだけ。そのクリップが一度も再生されなくても対象になる。

- 値が 0 のものは 0 のまま。

- Base は関係しない。

- Additive より上で WD OFF のステートが再生されている間は、誤りが覆い隠される。既定の Gesture コントローラ、WD OFF の FX、エモートや AFK 中で weight 1 の Action がこれに当たる。多くのアバターで気付かれないのはこのため。

原因

WD OFF のステートは、アバターがアニメーションしている全 binding を主張する。自分がアニメーションしていない binding は、保持値（bind 時の値）で埋める。

Additive の入力は加算なので、この「密なポーズ」は下位レイヤーの上に 2 回足される。

- 1 回目: 加算の Playable 入力として

- 2 回目: 加算レイヤーの合成として

そのため Additive レイヤーが一切触らないシェイプキーにも、既定値が 2 回足される。

d + 2d = 3d

同じステートに空の（カーブ 0 本の）クリップを置くと、値は落ち着かず、毎フレーム増え続ける。

このコントローラを WD ON にしても安全である理由

Additive = 既定（WD OFF）と、WD ON のコピーを、次の全組み合わせで比較した。

- Base: WD OFF / WD ON

- Gesture: WD OFF / WD ON

- FX: WD OFF / WD ON / レイヤーごとに混在

- Action の weight: 0 / 1

計 24 構成、各 300 フレーム、人型の 54 ボーンすべてとルートを確認した。idle のクリップには、体を最大 8 度動かすマッスルだけの加算クリップを使った。

結果:

- シェイプキー、Additive WD OFF: Gesture と FX が WD ON かつ Action の weight が 0 のとき 3 倍。それ以外は 1 倍。

- シェイプキー、Additive WD ON: 24 構成すべてで 1 倍。

- 人型の動き: 24 構成すべてで一致（Additive の WD OFF と WD ON の差は 0 度 / 0 m）。

人型のマッスルは「1 枚の人体ポーズ」として適用され、Write Defaults の影響を受けない。そのため idle の動きはこの設定に左右されない。

WD OFF のアバターでは変更は見た目に表れない。WD ON のアバターではこの誤りが消える。

この修正は既にツールでも行われている。VRCFury の "Fix Write Defaults" オプションは、加算レイヤーの全ステートを WD ON にする。

要望

SDK 既定の Additive コントローラの 2 つのステートを、Write Defaults ON にしてほしい。クライアント内部の同等品が SDK のアセットと同じなら、そちらも。

関連

"[BUG] VRChat apply blend shape values 3 times"（2020 年、修正済みとして完了）は症状が同じ。ここで述べる原因は、既定コントローラのアセットにある。