【Unityエディタ拡張】-WriteDefaultsOff- Animator に追加された State の Write Defaults を自動OFFにする

- WriteDefaultsOff -

Animator Write Defaults 自動OFF & 一括補正ツール

概要

Unity の AnimatorController で State を追加すると Write Defaults が ON で作成されてしまう問題に対処する、

Write Defaults を OFF に統一するためのエディタ支援ツールです。

Animator の編集作業中に

・ 意図しない Transform / 表情 / 値の上書き

・ レイヤー間の競合

・ 再生結果が安定しない

といった事故が起きるのを防ぐことを目的としています。

VRChat アバター制作や複雑な Animator 構成での利用を想定しています。

主な機能

■ State / Layer 追加時の自動OFF（常時）

AnimatorController に対して

・ State 新規作成時

・ Layer 追加時

のみをトリガーに、

該当 AnimatorController 内の Write Defaults を自動で OFF に統一します。

※ AnimatorController を「選択しただけ」「開いただけ」では変更されません。

■ 選択してOFF（手動補正）

選択中の AnimatorController を対象に、

全レイヤー／全 State を走査して Write Defaults を一括で OFF にします。

・ 既存 AnimatorController の整理

・ 配布前・最終チェック

といった用途に使えます。

■ 安心設計

・ 編集操作が発生したときのみ動作

・ 未編集の AnimatorController を勝手に変更しない

・ Undo 対応（元に戻せます）

・ 軽量・常駐型（不要時は OFF 可）

こんな時に

・ Write Defaults は 常に OFF 運用している

・ State を追加するたびに OFF にするのが面倒

・ Animator の事故を未然に防ぎたい

・ VRChat アバター／NPC／相棒ギミック制作をしている

・ Animator を触る頻度が高い

使い方

1. インポート

パッケージを Unity プロジェクトへインポート

2. ツール起動

メニュー

HeartfulFactory → WriteDefaultsOff → 自動OFF（常時）

を ON にします

3. Animator 編集

以後、

・ State 新規作成

・ Layer 追加

を行うと、Write Defaults が自動で OFF に補正されます。

4.（任意）手動補正

既存 AnimatorController に対しては、

HeartfulFactory → WriteDefaultsOff → 選択してOFF

を使用してください。

既知の注意点

・ Unity の仕様上、State 作成時の初期値（Write Defaults ON）自体は変更できません

→ 本ツールは 作成後に自動補正する仕組みです

・ AnimatorController が未ロードの場合は自動対象になりません

→ 必要に応じて「選択してOFF」を使用してください

更新履歴

[ver1.0] 2026/01/03

初回リリース