> ZAPシリーズ / ユーザーマニュアル

ZAP DOCTOR

Blender 用レンダープリフライトチェッカー

Blender 4.3+（Extensions プラットフォーム） · Cycles & EEVEE · 30項目のチェック (v1.2.1)

>01 概要

スキャンして、直して、レンダー

Zap Doctor は、レンダー（F12）を押す前にシーンをひと通り点検し、最終レンダーを台無しにしがちなミス — 存在しない出力フォルダ、失われたテクスチャ、オンのまま残ったレンダーリージョン — を見つけ出して、その大半をボタン一つで直します。

Check Scene Health をクリック — 一度のスキャンでシーン全体を調べ、見つかった問題を深刻度ごとに Scene Health ゲージへ整理します。
ゲージが低いですか？問題の横の Fix ボタン（またはトグルアイコン）を押します — たいていの問題はワンクリックで解消します。
ゲージが “Ready to Render” になるまで繰り返します — あとは安心してレンダーを回すだけです。

一晩レンダーを回して、朝になって壊れた結果に気づく — そんなことはもう起きません。

>02 インストール

インストール

Zap Doctor は Gumroad と Superhive で入手できます。

やりやすい方を選んでください:

ドラッグ&ドロップ — リリースの zip を Blender のウィンドウにドロップします。
手動 — Edit > Preferences > Get Extensions > Install from Disk から zip を選びます。

インストールが終わると、3D ビューポート右側のサイドバーに “Zap Doctor” タブが現れます。

>03 基本の使い方

基本の使い方

パネルを開く

3D ビューポートで N キーを押してサイドバーを開き、“Zap Doctor” タブをクリックします。3D ビューポートのサイドバーにあるので、別のプロパティタブに切り替えてもパネルが消えることはありません。

スキャンする

パネル上部の大きな “Check Scene Health” ボタン（虫めがねアイコン）を押します。Zap Doctor がシーン全体を調べ、問題を見つけてリストに整理します。

結果を読む — Scene Health ゲージ

スキャンが終わると、上部に横棒の Scene Health ゲージが現れ、Scene Health 72% のようにパーセンテージが表示されます。

問題が一つもなければ → ゲージが満タンになり “Ready to Render” と表示されます。
問題があるとゲージは 乗算式の減衰 で下がります — 問題一つにつき、スコアが一定の比率で掛け算されて下がります: Error 一つで ×0.80、Warning 一つで ×0.96、Suggestion 一つで ×1.00（Suggestion は助言なので、いくつあってもスコアは下がりません）。同じ問題の繰り返しが支配しないよう上限が二つあります — 一つのチェックが数えられるのは Error は 2 回、Warning は 5 回まで。またどのカテゴリも自身の寄与を 0.60 倍より下には引き下げられません。ゲージは何行が悪いかではなく何種類が悪いかを示します。

ゲージのすぐ下には 2 errors · 5 warnings · 3 suggestions のような一行サマリーが出ます（数が 0 の項目は省略されます）。

リストの並び方

問題は深刻度で3つのボックスに分かれます: Errors（⊘）、Warnings（⚠）、Suggestions（ⓘ）。各ボックスの中では、さらに カテゴリ — Output、Assets、Scene、Render、Hygiene — ごとにまとめられ、それぞれアイコン・ラベル・件数で表示されます。

折りたたみと展開

各カテゴリの見出しには三角形が付いています: ▽（下向き）が展開、▷（右向き）が折りたたみです。ゲージの下の “Collapse All” / “Expand All” ボタンで、すべてのグループを一度に開閉できます。

修正する

どの問題の行にも Fix ボタンがあり、そのラベルが何をするかをそのまま示します — Reset to 100%、Turn Off Simplify、Purge All。マウスを重ねればより詳しいツールチップが出ます。カテゴリ見出しに “Fix All (N)” が出ることもあり、そのグループの自動修正できる問題をまとめて片づけます。直した内容はすべて “Recently Fixed” に記録され、たいていの修正は Revert で元に戻せます。

>04 画面リファレンス

すべての要素を上から下まで

Check Scene Health ボタン

上部の大きなボタン（虫めがねアイコン）。押すたびにシーンを一からスキャンし直します。最初のスキャン前は、グレーのヒント “Scan the scene for common render mistakes.” が見えるだけです。

Scene Health ゲージ & サマリー行

棒ゲージと、その下の一行の深刻度サマリーです（基本の使い方を参照）。

“Scene changed since last scan” のヒント

スキャン後にシーンを編集すると（オブジェクトを動かした、など）、ⓘ アイコン付きのグレーの注意書きが出ます — 結果が古くなっている可能性があるので、スキャンし直しましょう。自動で再スキャンすることはなく、ボタンは自分で押します。

Collapse All / Expand All

すべてのカテゴリグループを一度に開閉する2つのボタンです。

問題1行の構造

1つの問題はふつう1行です — 左に説明、右に操作アイコンが並びます。

テキストをクリック

問題がオブジェクトに結びついている場合（先頭にターゲットアイコンが付きます）、クリックするとそのオブジェクトをビューポートで選択します — 複数関わっていれば一度にすべて選びます。何も選択できないとき（非表示、コレクションから除外…）は、その理由をメッセージで知らせます。

Fix ボタン

自動修正を適用します（一部のチェックは代わりにトグルアイコンを使います — 下の Scene カテゴリを参照）。

ピンアイコン — ずっと無視

この問題を永久に黙らせます: 次のスキャンでも、その次でも出てきません。解除はアドオン設定か Ignored リストから。注: 自動修正できない Error（カメラなし、未保存ファイル…）にはあえてピンがありません。致命的な問題を永久に黙らせてしまわないためです — X（今回だけ無視）は使えます。

X アイコン — 今回のスキャンだけ無視

今回のスキャンでは問題を隠します。次にスキャンすると再び現れます。

Scene カテゴリの特別な構造

他のカテゴリと違い、Scene グループはさらにもう一段、サブグループに分かれています。

Render Visibility サブグループ (SCN01 / SCN02)

ビューポートには表示されるのにレンダーから外れる、あるいはその逆のオブジェクトです。これらの行は Fix ボタンの代わりに 3つのトグルアイコン を表示し、それぞれオブジェクトの現在の状態を映してクリックで切り替えます。サブグループの見出しには一括トグルと、3つのアイコンを説明する小さな（クリックできない）凡例が付きます。

アイコン	意味	Blender での対応
目 (HIDE)	ビューポートで一時的に非表示	アウトライナーの目アイコン（H キー）
モニター (RESTRICT_VIEW)	ビューポートで全体的に無効	Disable in Viewports
カメラ (RESTRICT_RENDER)	レンダーで全体的に無効	Disable in Renders

Modifier Mismatch サブグループ (SCN03)

ビューポート表示とレンダー表示が食い違うモディファイアです。これらの行は 2つのトグルアイコン（viewport / render）を表示します。この食い違いは意図的なことも多いため（重いモディファイアをビューポートではオフ、レンダーではオン、など）、無理に一致させるのではなく、それぞれの状態を直接切り替えます。見出しには 4つの一括ボタン があります: viewport オン / オフ、render オン / オフ。

Collection Visibility Issues ボックス

1つのオブジェクトではなくコレクション全体がオフのとき、このボックスが Scene グループの上に現れ、原因となっている一番上のコレクションだけを表示します。除外（Excluded） されたコレクションは “Excluded from view layer” というテキストと “Include” ボタンを表示し、それ以外のコレクションは eye / monitor / camera の3アイコンを表示します。コレクションを直すと、関連する Scene の問題がすぐに再計算されます。

Ignored セクション

X やピンで隠したものは、すべて折りたためる見出し（件数付き）と “Restore All” ボタンの下にここへ集まります。項目の先頭に小さなピンがあれば永久に無視、ピンがなければ今回のスキャンだけの無視です。各項目には個別の復元用の矢印が付きます。

Recently Fixed セクション

このセッションで直した内容の記録です。カテゴリごとにまとめられ、各行にチェック ID と変更内容の一行サマリーが並びます。Revert は1件の修正を取り消し、Revert All は元に戻せる修正をすべて取り消します。Clear（ゴミ箱アイコン）はリストを空にするだけで、実際の修正は 取り消しません。

>05 チェックリファレンス

30項目のチェックすべて

E エラー W 警告 S 提案（コード上は INFO）

Output — 出力設定 6項目

ID	名前	深刻度	内容	Fix の動作
OUT01	出力ディレクトリが存在しない、または読み取り専用	E	レンダー出力用のフォルダが存在しないか、書き込み禁止になっています。（未保存ファイルが相対パス `//` を使っている場合にも検出されます。）	Create Folder — 足りないフォルダを作成します（絶対パスのみ）。
OUT02	既存の出力ファイルが上書きされる	W	フレーム範囲内にすでにファイルがあり、上書きされてしまいます。	—
OUT03	アニメーションを動画ファイルへ直接レンダー	W	アニメーションを1つの動画ファイルにレンダーしています — 途中でクラッシュするとすべて失われます。	Use PNG Sequence — PNG 連番画像に切り替えます。
OUT04	フレーム範囲が怪しい	W	開始 > 終了（逆転）、またはフレームステップが 1 でない（フレームが飛ばされる）状態です。	—
OUT05	推定出力サイズに対してディスク容量が足りない	W	空きディスク容量が、推定される出力サイズを下回っています。	—
OUT06	出力パスが未設定	W	出力パスが空です — レンダーが一時フォルダに落ちてしまいます。	Set Path — ファイルが保存済みなら `//`（blend ファイルの隣）に設定します。

Assets — アセットの整合性 3項目

ID	名前	深刻度	内容	Fix の動作
AST01	画像テクスチャが見つからない	E	画像テクスチャが、ディスク上に存在しないファイルを指しています。	Find Missing Files — フォルダを選ぶファイルブラウザを開きます（その後もう一度 Fix で適用）。
AST02	リンク切れのライブラリ	E	リンクしているライブラリ（.blend）ファイルが失われています。	—
AST04	存在するが中身が空の画像ファイル	E	ファイルは存在しますが、0 バイト（空）です。	—

Scene — シーンの状態 7項目

ID	名前	深刻度	内容	Fix の動作
SCN01	ビューポートでは表示、レンダーでは無効	W	ビューポートには表示されますが、レンダーではオフのため写りません。	トグルアイコン（eye / monitor / camera）。Fix ボタンではありません。
SCN02	ビューポートで非表示だがレンダリングされる	S	ビューポートで非表示なのにレンダリングされるオブジェクト — 作業中にオフにしたコレクション全体であることがほとんどです。	1行に集約して通知するのみ。修正ボタンはありません（多数のオブジェクトを一括でレンダリング対象外にする方が危険なため）。
SCN03	モディファイアの viewport/render 表示が不一致	W	モディファイアの viewport 表示と render 表示が食い違っています。	2つのトグルアイコン（viewport / render）。
SCN04	シーンにアクティブカメラがない	E	アクティブカメラがなく、レンダーが失敗します。	—
SCN05	シミュレーションが未ベイク、またはフレーム範囲を満たしていない	W	シミュレーションがベイクされていないか、キャッシュがフレーム範囲をカバーしていません。	—
SCN06	レンダリングされるライトがなくワールドも暗い	W	光源がなくワールドも暗いため、レンダリング結果が真っ黒になる可能性があります。	—
SCN07	オブジェクトがカメラのクリップ範囲外にある	W	オブジェクトが Clip Start より手前、または Clip End より奥にあり、カメラに映りません。	—

Render — レンダー設定 11項目

ID	名前	深刻度	内容	Fix の動作
RND01	解像度パーセンテージが 100% でない	W	解像度スケールが 100% になっていません（低解像度テスト設定の消し忘れ）。	Reset to 100%
RND02	レンダーリージョン（ボーダー）が有効	W	レンダーリージョン（ボーダー）がオンで、フレームの一部しかレンダーされません。	Clear Render Region — リージョンをオフにします。
RND03	Simplify がレンダー品質を制限している	W	Simplify がサブディビジョンやパーティクルの品質を下げています。	Turn Off Simplify — Simplify を完全に無効化します。
RND04	サンプル数がテスト設定のように見える	W	サンプル数が最終レンダーには低すぎます（テスト設定の消し忘れの疑い）。	—
RND05	GPU が設定済みなのに Cycles が CPU でレンダー	S	GPU が設定されているのに、Cycles が CPU でレンダーしています。	Use GPU — Cycles のデバイスを GPU に設定します。
RND06	Post Processing > Sequencer がレンダーを上書きしている	W	Sequencer のポストプロセスがオンでストリップがあるため、F12 がカメラではなく VSE の出力をレンダーします。	Turn Off Sequencer
RND07	Compositor がオンだが Composite 出力が未接続	E	コンポジターがオンなのに出力ノードが接続されていない（またはミュート）— レンダーが真っ黒になります。	—
RND08	カラーのビュー変換が Raw になっている	W	ビュー変換が Raw のため、カラーマネジメントが適用されません。	Switch to AgX — AgX（または Standard）に設定します。
RND09	透過背景なのにアルファチャンネルを持てない	W	Film が透過設定ですが、出力フォーマット／モードがアルファを保持できません。	Set RGBA — カラーモードを RGBA に設定します（フォーマット自体がアルファを保持できない場合は Fix なし）。
RND10	Cycles にフレームごとの時間制限が設定されている	W	Cycles にフレームごとの時間制限があり、フレームが早く打ち切られる可能性があります。	Clear Time Limit — 時間制限を 0 に設定します。
RND13	レンダーエンジンが Workbench になっている	W	レンダーエンジンが Workbench（プレビュー専用）です。	—

Hygiene — ファイルの衛生 3項目

ID	名前	深刻度	内容	Fix の動作
HYG01	.blend ファイルが一度も保存されていない	E	ファイルが一度も保存されていません — クラッシュするとすべて失われ、相対パスも機能しません。	—（自分で保存します）。
HYG02	未使用（孤立）データがファイルを肥大化させている	S	誰も使っていない孤立データが、ファイルを膨らませています。	Purge All — 未使用のデータブロックをすべて削除します。
HYG03	オブジェクトの未使用マテリアルスロット	S	オブジェクトが、使われていないマテリアルスロットを抱えています。	Remove Unused Slots

各チェックは Preferences > Add-ons > Zap Doctor のチェックボックスで個別にオン／オフできます。同じ画面には、永久に無視（ピン留め）したものを一度にすべて解除する Clear ボタンもあります。

>06 よくある活用シーン

実際の流れ

A — コレクション全体がオフで警告が積み上がる

作業中にコレクションを丸ごとオフにしたとします。スキャンすると、その中の何十ものオブジェクトがすべて SCN01（“レンダーされない”）として引っかかり、リストがとても長くなります。

そのかわり Zap Doctor は、その1つのコレクションだけを Collection Visibility Issues ボックスに浮かび上がらせます。オブジェクトの行を一つずつ直す必要はありません — そのコレクションの camera（render）アイコンを一度切り替えれば、関連する警告がまとめて消えます。（コレクションが覆い隠していた個々のオブジェクト行は自動で隠れ、リストがすっきり保たれます。）

B — 一晩レンダーの前の最終チェック

レンダーをキューに入れる前に Check Scene Health を押します。Errors（カメラなし、出力フォルダがない、テクスチャの喪失…）があると、レンダーが失敗したり真っ黒になったりしかねません — まずそれらに対処します。次に、重要な Warnings を Fix ボタンで片づけます — RND01（解像度が 100% でない）、RND02（ボーダーがオン）、OUT03（動画へ直接）— そしてゲージが “Ready to Render” になったら、安心してレンダーをキューに入れましょう。