Blender アドオンのトラブルシューティング

Model Vista Create サイドバーのステータスメッセージを確認します。詳細は Diagnostics > Copy Diagnostics と明示的なアクション JSON コピー操作で調べます。

アドオンが表示されない

• 余分な親フォルダーを含む zip ではなく、model_vista_create-1.0.0-blender45-51-win64.zip をインストールします。
• Preferences で Model Vista Create を有効にし、古い Configurables、ModelVista States、Model Vista Create を削除または無効にします。
• 読み込み済みアドオンを置き換えた後は Blender を再起動します。

ネイティブコアを読み込めない

Blender 4.5 または 5.1 と完全な Windows x64 パッケージを使用します。_modelvista_create_core.cp311-win_amd64.pyd などの ABI 固有ネイティブモジュールを含みます。Python ファイルのコピーだけでは動作しません。他の Blender リリース／プラットフォームには対応パッケージが必要です。

ファイルを読み込めない

• 有効な .glb または .gltf であり、必要な外部リソースが存在することを確認します。
• 標準ファイルに既存のステート拡張は不要です。新しいステートを追加できます。
• ステータスの GLB ヘッダー、JSON、インポート、ネイティブコアのエラーを確認します。

プレビューが動作しない

• Asset Root、ターゲットの種類とパスを確認します。Import Scene On Load を有効にして読み込むか、既存の階層を割り当てます。
• Camera ステートに明示的なターゲットがない場合は Preview Camera を割り当てます。
• ステートが見つからない場合は検索を解除し、Show States for Selected Objects を無効にします。
• プレビューや中断した遷移の後は Restore Scene / Stop Preview でシーンを復元します。
• Light はエネルギー／フィルターと、Blender 5.1 では色温度をプレビューします。未知のステート動作は再現しません。

意図しない複製オブジェクトが変化する

1.0.0 はインポート名の互換一致より正確なパスを優先します。旧版で誤ったターゲットを保存した場合は、Targets または Visible Objects からその項目を削除し、目的のオブジェクトを選択して追加し直します。ターゲットは Asset Root 内に置きます。

マテリアルのプレビューや出力が正しくない

• インポートしたスロットには Diagnostics > Repair > Apply Material Bindings を使用します。
• オプションに既存の Blender マテリアルを割り当て、対象メッシュを確認します。
• 通常の Material ステートは最初のスロットに適用します。Preview All Material Slots は Blender のプレビューだけを変更します。
• 共有マテリアルを編集する前に使用数を確認します。独立した選択肢には Make Unique Copy を使用します。
• 画像欠落やシェーダーのヒントを確認し、glTF 出力用にプロシージャルテクスチャをベイクします。
• 再エクスポートにテクスチャデータが必要な場合に備え、元の GLB+ を保持します。

アニメーションの変更が反映されない

Actions／NLA／制約を編集する前にプレビューを復元し、再度 Bake Timeline into Option を実行します。埋め込みクリップはスナップショットのため、現在の Actions を編集しても更新されません。対象をターゲットのサブツリー内に置き、クリップ番号、速度、ループ、フレーム範囲を確認します。番号 -1 は再生を停止します。アニメーションの対応範囲も確認してください。

Input Actions が正しくない

Input Actions または Edit > Option Triggers の Bindings を展開します。Edit Path は他の設定を保持して 1 つのパスを変更します。Add to Existing Bindings を無効にするとアクションを置き換えます。全 JSON は Diagnostics で確認します。バインディングは Blender のショートカットを動作させません。

非アクティブオブジェクトの表示が正しくない

Overview または Diagnostics の非アクティブレコードと、目的の Asset Root を確認します。エクスポートはマテリアル用補助ジオメトリを除く非表示の子孫を含め、非アクティブとして記録します。

変更が保存されていない

• Blender の Save は作業用プロジェクトを保存します。Save Changes to Source は読み込み元に拡張メタデータを書き込みます。Export Model + States はジオメトリ、マテリアル、ステートをまとめて書き出します。
• Blender で新規作成したアセットにはソースファイルがありません。エクスポートを使用します。
• プレビューは起動時の選択を設定しません。Edit > Set as Startup を使用します。
• 書き込み権限を確認し、保存したプロジェクトや出力ファイルを開き直して確認します。

エクスポートがキャンセルされる

検証結果を読み、欠落／ルート外のターゲット、不正な種類、未解決のマテリアル、メタデータ／ライト／リフレクションプローブのパス、不正な画像参照、欠落／循環する Group リンクを修正します。Choose Object や選択ベースの操作で再割り当てします。必要な参照が不正な場合、エクスポートは意図的に停止します。