OtakuSolutions API Reference

要約：安定したリファレンスシステムを運用するために最初にすべきことは、「マスターリグフォルダ」と「アニメーション作業フォルダ」を徹底的に分離し、絶対に混在させないことです。

1. このエピソードが生まれた痛切な背景

Maya 中心のスタジオでは、骨格とアニメーションを分けるという構造が基本ルールとして定着しています。しかし 3ds Max や Blender ベースで成長したチームを調査してみると、思いのほか多くの場所で決まったフォルダ規則なしにファイルを行き当たりばったりで混在させています。
発表者の経験では、10 社中 6 社がフォルダ構造を完全に混乱させた状態でした。専任のリギング部門がなく、ジェネラリストが一手に担うチームほど、この問題が深刻に起きています。

Fast-Ref の導入を決めたなら、ツールを起動する前にフォルダ構造を整理するという前提条件が必ず満たされていなければ、パイプラインは正常に機能しません。

2. 絶対に守るべき 2 種類のファイル分類

スタジオのアニメーションパイプラインには、次の 2 種類の核心ファイルだけが存在するべきです。

ファイル種別	含めるべき内容	❌ 絶対に入れてはいけない内容
オリジナルリグファイル (Original Rig)	スケルトン・コントローラー・スキンウェイト・メッシュ	アニメーションキーフレーム
アニメーションシーンファイル (Animation Scene)	リグファイルをリファレンスリンク (Add) した後に打ったアニメーションデータ	オリジナルリグソース自体の直接編集版

🚨 よくある悪いパターン (Anti-Patterns)

テストアニメーションをオリジナルリグに保存する行為：「このリグちゃんと動くかな？」とテストするためにマスターリグファイルにキーを打ち、うっかり保存してしまう状況です。（テストキーは必ず別の一時ファイルや .bip に保存してください。）
リグファイルを開いて「名前を付けて保存」でアニメーション作業を始める行為：最も多く、最も破壊的な作業方法です。元のリグファイルの接続関係をすべて断ち切り、ハードコードされた単一ファイルとしてシーンを独立させてしまうため、リグ修正時にシーン全体を捨てる羽目になります。
リンクの代わりにリグをシーンへ丸ごと Merge して使う行為：シーンに重いリグデータが固定された状態になり、リグの修正内容をまったく反映できなくなります。

3. リグファイルにアニメーションが混入した際のエンジン大惨事

これは、ある Blender ベーススタジオにアニメーション TA として参加したときの実話です。リガーに「キャラクター A のマスターリグファイルはどこですか？」と聞いて受け取ったリグファイルを開いてみると、キャラクターの派手なアルティメットスキルアニメーションがデフォルトポーズ状態のまま焼き込まれて（Bake）いました。
前任者がアニメーション作業後、うっかりマスターリグファイルにそのまま上書き保存してしまっていたのです。

😱 バインドポーズ（Bind Pose）汚染が引き起こす連鎖反応

アニメーションキーが焼き込まれたリグを Unreal や Unity にスケルタルメッシュとしてインポートすると、エンジンが認識するキャラクターの初期デフォルトポーズ（バインドポーズ）自体が完全に歪んでしまいます。
基本の体型情報自体が壊れているため、その後どれだけ完璧なアニメーションクリップをキャラクターに適用しても、エンジン内で関節がねじれて潰れる恐ろしいレンダリングバグが続出します。
最終的に TA が投入されてアニメーションデータを一つひとつ削除し、純粋なデフォルト A-ポーズ / T-ポーズ状態に復元するという不要な工数が発生しました。

4. 部署間の明確な「エリア整理」（推奨 NAS フォルダ構造）

数十人のアーティスト（例：35〜40 人規模のアニメーションチーム）が協業する環境では、完全に分離されたルールが必要です。

Project_Super/ (ネットワーク共有ドライブ)
  ├─ rigging/             ← リガー専用領域（リガーのみ書き込み権限あり）
  │   └─ CH_Mable/
  │       ├─ master_mable.max   （アニメーションキーが皆無のクリーンリグ）
  │       ├─ textures/          （相対パス指定のテクスチャフォルダ）
  │       └─ old/               （旧バージョン履歴バックアップフォルダ）
  │
  └─ animation/           ← アニメーター専用領域（アニメーターのみ書き込み権限あり）
      └─ Scene_Walk/
          └─ walk_mable_v01.max （master_mable.max を Fast-Ref で「Add」リンクしたファイル）

🚫 厳格なアクセス制限ルール

リガー：アニメーターのフォルダは参照できますが、アニメーターの作業シーンに直接介入して上書きする行為は禁止です。
アニメーター：リギングフォルダ内のマスターリグファイルを「読み取り専用」で開いて参照することはできますが、リギングフォルダ内にいかなるファイルも作成・上書きしてはなりません。

5. 「カオス比率を 7% 以下に抑えろ」

プロダクションが進むにつれ、ルールを完璧に守ることは不可能であり、一定程度の整理されていないファイルの混乱（Chaos）は避けられません。
しかし発表者はパイプライン全体の混乱指数を最低 7% 以下に抑えるというガイドラインを立て、ファイルが絡み始めるたびに積極的に整理します。

この整理の主体は、下の立場のアーティストが遠慮して手を出しにくいため、チームを率いるリードや実務 TA が権限をしっかり持ち、フォルダ階層とファイルアクセス権限を規定して随時フィルタリングしなければなりません。

このようにしっかり設計された「マスターフォルダ規則」が整って初めて、Fast-Ref の自動チェック・交換機能が本来の力を発揮できます。