OtakuSolutions API Reference

要約：リグファイルをコピーしてシーンに貼り付けるのはやめましょう。Fast-Ref の Add でクリーンにリンクするだけにして、シーンデータに影響なく Remove で外すことができます。リグファイルの状態は 緑・黄・X の信号機カラーで 5 分ごとにリアルタイム更新されます。

1. Maya のリファレンスのように管理する

Fast-Ref の基本コンセプトは、複雑なセットアップなしに Maya の直感的な参照メカニズムを 3ds Max へ完璧に移植することです。
外部ファイルとの「リンク関係」だけを作成し、シーンファイルを極めて軽量に保ちながら、シーン内のあらゆる状態変更を専用のテーブルビューで簡単に制御します。

2. Add — リファレンスの登録

Fast-Ref UI を開き、元のリグフォルダ内の .max マスターファイル（例：master_mable.max）を選択して Add ボタンを押すと、テーブルに登録されます。

📊 スロット登録時に即座に有効になる操作ボタン

🟢 緑マーク：ディスク上のファイルパスが有効で、開いているシーンが最新の完璧なリグ状態を参照していることを示します。
👁️ Visibility（表示 on/off）：該当リファレンスを画面で非表示または表示します。1 つのシーンにキャラクターが 3〜4 人以上登場してビューポートが重くなるときに便利です。
❄️ Freeze（凍結）：誤ってキャラクターをドラッグしてビューポートで動かしてしまうミスを防ぐ、ワンクリック固定モードです。
🎯 Selection helper（選択補助）：そのリファレンスに属する複雑なリグボーン構造をワンクリックですべて一括選択します。

3. リガーがリグを修正したとき（黄色の警告ライト）

ネットワークドライブ上で作業中にリガーがリグのスキンやメッシュを修正してマスターファイルに配布したら、どうなるでしょうか？
アニメーターがリガーに「修正しましたか？」と手動で聞く必要はまったくありません。Fast-Ref テーブルのマークがすぐに 🟡 黄色に変わります。

「ディスク上のファイルのタイムスタンプが最近更新されました。アニメーターさん、このシーンは古いバージョン基準です！」 という親切な警告です。

このとき選択肢は 2 つです。
1. Reload：ファイルパスはそのままに、ディスクに新しく上書きされた最新リグファイルの内容でシーン内のリグ構造だけを安全にリフレッシュします。
2. Replace：リガーが完全に別のパスに新しいファイルを作成した場合、新しいファイルパスを指定して骨格を交換します。

4. Remove — リファレンスの削除

シーンからキャラクターを除外したり不要になったりしたとき、Remove ボタンを押します。
従来の 3ds Max では XRef などを削除する際、ノードが絡まっていたり空のダミーノードが残骸として残り、シーンが徐々に汚染されるという慢性的な問題がありました。
しかし Fast-Ref は、残骸ノードやスキニングデータ汚染を一切残さず、最初からなかったかのようにシーンを純粋な状態に復元して削除します。

5. リアルタイム信号機状態検査システム（5 分検査周期）

Fast-Ref の最も賢い特徴のひとつが、バックグラウンド検知周期です。
- ツール起動の瞬間、すべてのスロットのディスクファイルタイムスタンプとパス状態を確認して状態を更新します。
- 作業中も約 5 分間隔でバックグラウンドが静かにマスターリグファイルの変更有無を自動確認します。

これにより、複数のチームメンバーが同時に協業する緊迫した実務環境でも、現在作業中のシーンが正しいパスを参照しており最新データ状態かどうかを、いつでも確実にモニタリングできます。

🚫 重要な注意事項とまとめ

すでに Fast-Ref としてシーンに読み込まれているファイルを再度強制 Add しようとしたり、絡まった接続状態を放置したりすると衝突のリスクがあります。エラーを事前にフィルタリングしてくれるプラグインの親切なポップアップを必ず確認してください。
すべてのアニメーション作業の始まりは、テーブル上部の 🟢 緑ライトを確認することです。