こんにちは、Unityエンジニアのオオバです。

お悩みさん
お悩みさん
  • Prefabの参照をAIにテキストで書き換えさせたら、PlayModeで参照がnullのままになる
  • ファイルを見るとさっきの変更そのものが消えている
  • Unityを開いたままファイルを直接いじっても大丈夫なのか
  • オオバ
    オオバ
    本記事ではこれらの悩みを解決します。

    AIにUnityの作業を任せていると、ファイルを直接書き換えたくなる場面があります。

    Prefabにコンポーネントを足して参照をつなぐ作業は、YAMLを書き換えれば一瞬で終わりそうに見えますよね。

    僕もAIにPythonとsedでPrefabのテキストを編集させ、そのまま進めました。

    Unityを開いたままテキストで編集すると巻き戻る。AIにはエディタスクリプトで編集させる

    結論から言うと、Unityを開いたままファイルを直接書き換えるのは避けたほうがよいです。

    Unityは、メモリ上に読み込んでいるアセットを、自分の内容で保存し直すからです。

    なので、PrefabやScriptableObjectの編集は、エディタスクリプトを通してUnityに保存させるのが安全でした。

    起きたこと

    Unityエディタを開いたまま、AIに .prefab をPythonとsedでテキスト編集させました。

    編集の内容は、コンポーネントの追加と参照の配線です。

    コンパイルもテストも通りました。

    ところが、PlayModeで確認すると参照がnullのままでした。

    しかも、ディスク上の差分まで消えていました。 git diff を見ると、何も出てこない状態です。

    別の日には、もっと厄介なことが起きました。

    SmartAddresserの設定アセット(LayoutRuleData.asset)のYAMLを直接書き換えたところ、開いたままだった Layout Rule Editor ウィンドウの古い状態で上書きされました。

    追加したフォルダ指定が別グループのフィルタにずれてしまい、500件以上のアセットが別のグループへ移りました。

    原因:Unityはメモリ上の内容で保存し直す

    Unityは、メモリに読み込んでいるアセットを、compile、PlayModeへの切り替え、ウィンドウの保存といったタイミングで再保存します。

    外部から書き換えたテキストは、Unityのメモリ側には反映されていません。

    そのため次の再保存で、メモリ上の古い内容がディスクへ丸ごと書き戻されます。

    Prefabの参照が消えたのも、設定アセットがずれたのも、同じ仕組みでした。

    設定系のアセットは、開いているエディタウィンドウが状態を持っています。

    つまり、テキストで正しく直しても、Unityに上書きされて消えるということ。

    解決:エディタスクリプトで編集させる

    Prefabは「読み込む、足す、保存する」の順番で

    Prefabは、次の順番でエディタスクリプトから編集させるようにしました。

    1. PrefabUtility.LoadPrefabContents でプレハブをメモリに読み込む
    2. AddComponent でコンポーネントを追加する
    3. SerializedObject を使って参照を入れる
    4. PrefabUtility.SaveAsPrefabAsset で保存する
    5. PrefabUtility.UnloadPrefabContents で後片付けをする

    AIには、このスクリプトを uLoopMCP の execute-dynamic-code で実行させています。

    設定系のScriptableObjectは、ウィンドウを閉じてから

    設定系のScriptableObjectは、手順が少し違います。

    まず、関連するエディタウィンドウを閉じます。

    次に、AssetDatabase で読み込んだオブジェクトを書き換えて、EditorUtility.SetDirty の後に AssetDatabase.SaveAssets で保存します。

    補足・注意点

    保存したら、次の2つを確認すると安心です。

    SaveAsPrefabAsset には癖があります。レイアウトの再計算で、無関係な m_SizeDelta の差分を混ぜることがあるんです。

    単一の値を変えるだけなら、そのプレハブをメモリで開いていない状態でYAMLを書き、AssetDatabase.ImportAsset を ImportAssetOptions.ForceUpdate 付きで呼ぶと、差分が最小になりました。

    ただし、この方法はそのプレハブをUnityで開いていないことが前提です。

    まとめ

    今回のポイントをまとめます。

    今回のまとめ
    • Unityを開いたままファイルを直接書き換えると、メモリ上の古い内容で巻き戻る
    • Prefabは読み込み・追加・保存・解放の順にエディタスクリプトで編集する
    • 設定系のScriptableObjectは関連ウィンドウを閉じてから書き換えて保存する
    • 保存後はgit diff --statとPlayModeで反映を確認する
    • 単一値の変更ならImportAssetで差分を最小にできる

    AIに任せる範囲が広がるほど、テキストで直接いじりたくなる場面は増えると思います。

    それでも、Unityが管理しているアセットは、Unityの中で編集させるのが結局いちばん確実でした。

    オススメ記事
    検証環境