提出プラグイン：DCCごとのインストール、更新、トラブルシューティング

SuperRenders提出プラグインは、DCCを離れることなくレンダリングジョブをファームに提出できるよう、3Dソフトウェアに「SuperRenders」メニューまたはシェルフボタンを追加する小さな拡張機能です。プラグインはシーンをパッケージ化し、事前チェックのアセットとバージョン確認を実行し、1ステップでジョブをファームキューに渡します。

ほとんどのユーザーはプラグインを手動でインストールする必要はありません。SuperRenders Client Appをインストールすると、対応するプラグインが自動的に検出され、ワークステーションのサポートされているDCCごとにインストールされます。以下のページは、自動インストールパスが機能しない場合 — 新しいDCCバージョン、カスタムインストール場所、制限されたユーザーアカウント — または再現性のために手動インストールを好む場合をカバーしています。

このページでは、提出プラグインの機能、サポートされているDCCとエンジン、DCCごとの手動インストール手順、更新手順、メニュー/シェルフが表示されない問題の修正、プラグインのクリーンな削除方法、v1機能マトリクスについて説明します。

プラグインのインストール後のジョブ提出ワークフローについては、クイックスタートガイドと関連するDCCセットアップドキュメントを参照してください。Client AppのインストールについてはClient Appを参照してください。

プラグインの概要

提出プラグインはClient AppのDCC側コンパニオンです。Client Appはデスクトップでのアップロード、ジョブ追跡、ダウンロードを処理し、プラグインはDCC内での「シーン → ジョブ」を処理します。

DCC内でプラグインが行うこと：

• SuperRendersメニューまたはシェルフボタンを追加し、DCCを離れずに提出ダイアログを起動できるようにします。
• アクティブなシーンを読み取り — フレーム範囲、出力パス、レンダー設定、参照アセット — ジョブフォームに事前入力します。
• 提出前のアセットチェックを実行して、アップロードが開始する前に欠落しているテクスチャ、欠落している参照、壊れたファイルパスにフラグを立てます。
• シーンファイルをアセットとともにバージョン管理して、ファームが後の編集ではなく提出したシーンの状態を正確にレンダリングします。
• パッケージ化されたジョブをClient App（またはClient Appバックグラウンドサービスが実行中の場合はファームキューに直接）に渡してアップロードします。

このページは現在の本番プラグインであり、今日唯一の顧客向けプラグイン世代であるプラグインv1を文書化しています。将来の世代はSpaces移行ツールとともに提供される可能性があります（Client App § 移行パス：Spacesを参照）；その場合は別ページで新しいプラグインをカバーします。プラグインv1が今日サポートするDCCとエンジンは、以下の機能マトリクスに一覧表示されています。

インストール前に

以下の手動インストール手順を実行する前に確認すべきいくつかの事項：

• DCCを実行する同じユーザーアカウントを使用する。 プラグインはDCCのプログラムファイルディレクトリではなく、ユーザーのDCCスクリプトフォルダにインストールされます。ソフトウェアインストール専用の管理者アカウントなど異なるユーザーとしてログインしている状態でインストールすると、通常ユーザーがDCCを開いてもプラグインが表示されません。実際にDCCを開くユーザーとしてサインインしてインストーラーを再実行してください。
• インストール前にDCCを少なくとも1回実行する。 ほとんどのDCCは最初の起動時にユーザー固有のスクリプトフォルダを作成します。そのフォルダが存在する前にインストールすると、一部のMayaおよび3ds Maxバージョンでサイレントに失敗します。
• インストール中はDCCを閉じる。 プラグインのスタートアップスクリプトはDCCのロード時に読み取られます。インストール中にDCCが実行中の場合は、インストール後にスクリプトが取り込まれるよう再起動してください。
• SuperRendersアカウントを準備する。 プラグインは最初の起動時にサインインを求めます。

スタジオが自分のDocumentsフォルダに書き込めないロックダウンされたワークステーションイメージを使用している場合は、サポートに連絡してください — プラグインは標準のDCCスクリプトディレクトリへの書き込みアクセスが必要です。

DCCごとのインストール

すべてのDCCで最初に試すべきことは自動インストールパスです：Client Appをインストールし、Pluginsパネルを開いてScan to updateをクリックします。Client AppはインストールされているDCCを検出し、それぞれに正しいプラグインをプッシュします。以下の手動手順は、scan-to-updateがDCCを検出しない場合、新しいマシンへの再現可能なインストールが必要な場合、またはClient Appサービスをバックグラウンドで実行せずにプラグインをインストールしたい場合のフォールバックです。

3ds Max（自動インストール + 手動フォールバック）

3ds Maxプラグインv1は単一の.mzp MAXScriptパッケージとして提供されます。Client Appのscan-to-updateフローが通常のケースでインストールを処理します。手動インストールは2ステップのプロセスです。

1. パッケージをダウンロードする。 サポートにsuperrenders.mzpのスタティックダウンロードリンクをお問い合わせください（Client Appはそのプラグインキャッシュディレクトリにローカルコピーも保存しています）。
2. 3ds Max内でスクリプトを実行する。 3ds Maxを開き、Scripting → Run Script…でsuperrenders.mzpを見つけて確認します。スクリプトはプラグインを登録し、トップレベルメニューバーにSuperRendersメニューを追加します。
3. メニューが表示されない場合は3ds Maxを再起動する。 一部の3ds Maxバージョンはトップレベルメニュー定義を起動時にのみ再読み込みします。

3ds Maxバージョン対応。ファームは3ds Max 2013〜2027に対応しています。SuperRenders Client Appの「PLUGIN」タブからインストールするプラグインは、3ds Max 2023以降に対応しています。上記の手動.mzpパッケージは、3ds Max 2018〜2024で本番使用されています。

Maya（自動インストール + 手動フォールバック）

Mayaプラグインv1はZIP形式のスクリプトバンドル（superrenders_maya_v2xx.zip）として提供されます。Client Appは検出された各Mayaバージョン用のMayaスクリプトフォルダに自動インストールします。手動インストールは、Client AppのDCC互換性テーブルが更新される前に新しくインストールされたMayaリリースをClient Appが検出できない場合に必要です。

手動インストール、5ステップ：

1. バンドルをダウンロードする。 サポートにsuperrenders_maya_v240.zip（または最新バージョン）のスタティックダウンロードリンクをお問い合わせください。
2. MayaのスクリプトフォルダにExtract（解凍）する。 Mayaのバージョンごとのスクリプトディレクトリに解凍してください： C:\Users\<YourWindowsUser>\Documents\maya\<MayaVersion>\scripts\superrenders 例えば、WindowsユーザーadminのMaya 2023では、パスはC:\Users\admin\Documents\maya\2023\scripts\superrendersです。 macOSの場合、同等のパスは~/Library/Preferences/Autodesk/maya/<MayaVersion>/scripts/superrendersです。
3. userSetup.melを編集する。 superrendersの1つ上の親のscriptsフォルダ内のuserSetup.melを見つけるか作成してください： C:\Users\<YourWindowsUser>\Documents\maya\<MayaVersion>\scripts\userSetup.mel
4. SuperRenders初期化ブロックをuserSetup.melに追記する： /***superrenders_begin***/ python("import sys"); python("sys.path.append(u'__srfscriptPath__')"); python("import superrenders_runner"); python("superrenders_runner.init()"); /***superrenders_end***/ __srfscriptPath__をsuperrendersフォルダへのフォワードスラッシュを使ったフルパスに置き換えてください： C:/Users/admin/Documents/maya/2023/scripts/superrenders フォワードスラッシュが必要です。バックスラッシュはPythonのsys.path.appendの呼び出しを壊します。
5. Mayaを再起動する。 次回起動時にSuperRendersシェルフとメニューが表示されるはずです。

Mayaバージョン対応。ファームはMaya 2014〜2027に対応しています。以下に記載する範囲は、プラグインv1自体について個別に検証されたホスト対応範囲であり、ファームの対応範囲より狭くなっています。プラグインv1はMaya 2017〜2023で本番使用されています（Crispの文書化された機能マトリクスより）。Maya 2024、2025、2026は現在よく使用されていますが、プラグインv1のインストールについてSRFが独自に検証していません。

Cinema 4D（Client App自動インストールのみ）

Cinema 4Dプラグインは Client AppのScan-to-updateフローによってインストールされます。今日Cinema 4Dプラグインv1の別の手動.mzpスタイルのインストーラーは公開されていません。

インストール方法：

1. SuperRenders Client Appをインストールします。
2. Client App内のPluginsパネルを開きます。
3. Scan to updateをクリックします。Client AppはワークステーションにインストールされているCinema 4Dの各バージョンを検出し、対応するプラグインをC4Dプラグインディレクトリにインストールします。
4. Cinema 4Dを再起動します。SuperRendersの提出エントリがC4D Extensionsメニューに表示されます。

Scan-to-updateがCinema 4Dバージョンを「not supported」と報告する場合は、C4DバージョンとOSとともにチケットを送ってください。Maxonがメジャーリリースを提供するたびに、ローリングスケジュールでCinema 4DバージョンをPlugin v1に追加しています。

Blender

Blender 4.2 LTS以降には、SuperRenders提出アドオンがあります。SuperRenders Client App（クライアントアプリ）の「PLUGIN」タブからインストールします。Blenderを再起動するとSuperRendersメニューが表示されるので、そこから開いているシーンを提出してください。

4.2より前のBlenderバージョンの場合や、アドオンをインストールしない場合は、Client AppのDrag-and-dropアップロードフローまたはWebダッシュボードから提出してください。.blendファイルのメタデータはアップロード時に解析され、Client Appはほとんどの提出フィールドを自動的に事前入力します。

再起動後にSuperRendersメニューが表示されない場合は、Blenderのバージョンが4.2以降であることを確認してから、BlenderのバージョンとOSを添えてサポートにお問い合わせください。

その他のDCC

Houdiniにも、SuperRenders Client Appの「PLUGIN」タブからインストールする提出プラグインがあります。After Effectsやファーム自体がサポートするその他のDCCの提出フローは以下を通じて行われます：

• Webダッシュボード（クイックスタートガイド）— ファームがレンダリングするすべてのDCCに対応、
• Client AppのDrag-and-dropアップロード（Client App）— すべてのDCCに対応し、再開可能なアップロードと自動ダウンロードのメリットがあります。

Houdini固有の提出のヒントについてはSetting up Houdiniを参照してください；After EffectsについてはSetting up After Effectsを参照してください。After EffectsにはSuperRenders提出プラグインがありません；そのセットアップドキュメントは、プラグインなしでプロジェクトをパッケージ化して提出する方法をカバーしています。

更新手順

Client AppはPlugin v1を自動的に最新状態に保ちます。SuperRendersが更新をリリースすると — 新しいDCCバージョン、アセット再リンカーの修正 — Client Appは新しいプラグインを取得し、次回起動時にインストールするよう申し出ます。

手動で更新を実行するには：

1. 3Dソフトウェアを閉じる。 DCCは実行中にプラグインファイルをロックし、更新をサイレントにブロックすることがあります。
2. Client AppのPluginsパネルを開き、Scan to updateをクリックします。Client AppはインストールされているプラグインバージョンとLatestを比較し、新しいものが利用可能な場所にインストールします。
3. 各行が「Up to date」と表示されるまで待つ。
4. DCCを再起動する。 新しいプラグインバージョンは次回起動時に読み取られます。

「Scan to update」が特定のDCCで失敗する場合、通常の原因は：DCCがまだ実行中でファイルロックを保持している；Client Appを実行するユーザーアカウントにDCCのスクリプトフォルダへの書き込み権限がない（DCCを実行するのと同じWindowsユーザーとしてClient Appを実行してください）；または以前の失敗したインストールが部分的なプラグインフォルダを残した（プラグインの削除に従って削除し、再スキャン）です。

Client Appが利用できない場合は、より新しいプラグインパッケージを使用してDCCごとのセクションの手動インストール手順を再実行してください。プラグインはその場で上書きされるよう設計されています。

プラグインメニューまたはシェルフが表示されない場合（トラブルシューティング）

プラグインがエラーなしにインストールされても、SuperRendersメニューまたはシェルフアイコンが表示されない場合、根本的な原因はほぼ常に2つのうちの1つです：プラグインが誤ったディレクトリに配置された、またはサードパーティツールがDCCのスタートアップ設定を壊した。

原因1 — プラグインが誤ったスクリプトディレクトリにインストールされた。

プラグインは実行中のDCCバージョンのユーザー固有のスクリプトフォルダに存在する必要があります。別のMayaバージョンのフォルダや別のWindowsユーザーのプロフィールに配置されると、起動時にDCCが見つけられません。

Mayaの場合はScript Editorを開いて以下を実行して確認してください：

import superrenders_runner
superrenders_runner.init()

SuperRendersの提出ウィンドウが開く場合、プラグインは正しくインストールされており、シェルフの問題はUIの問題です（原因2）。ImportError: No module named superrenders_runnerが表示される場合、プラグインはMayaのPythonパスにありません。Mayaインストールの手動インストール手順を再実行し、特に以下に注意してください：

• パス内のMayaバージョンが起動するMayaと一致している（例：Maya 2023の場合maya/2023/scripts/superrenders）。
• パス内のWindowsユーザーがMayaを起動するユーザーと一致している。
• userSetup.mel内のパスがバックスラッシュではなくフォワードスラッシュを使用している。

同じロジックが3ds MaxとCinema 4Dにも適用されます — インストールパスは実行中のユーザーアカウントとDCCバージョンと一致する必要があります。

原因2 — サードパーティツールがDCCのシェルフ設定を壊した。

Script Editorがsuperrenders_runnerがインポートされることを確認するがシェルフアイコンが依然として表示されない場合、DCCの保存済みシェルフ設定が壊れています — 通常は別のプラグインが書き換えたためです。

Mayaの場合：

1. Mayaを終了します。
2. userPrefs.melを見つけます： - Windows：C:\Users\<YourWindowsUser>\Documents\maya\<MayaVersion>\prefs\userPrefs.mel - macOS：~/Library/Preferences/Autodesk/maya/<MayaVersion>/prefs/userPrefs.mel
3. userPrefs.melをuserPrefs.mel.backupにリネームします（削除しない — カスタムシェルフレイアウトをマージし直したい場合に備えて保持）。
4. Mayaを再起動します。MayaはフレッシュなuserPrefs.melを再生成し、SuperRendersシェルフが表示されます。

カスタムシェルフのカスタマイズと最近のファイルリストは失われます；重要であればバックアップからマージし直してください。

3ds Maxでは、同等の修正はCustomize → Revert to Startup UI Layoutを実行してからsuperrenders.mzpインストールを再実行することです。

どちらの原因にも当てはまらない場合は、以下と一緒にサポートチケットを送ってください：DCCの名前とバージョン、OSとユーザーアカウント、Script Editor / MAXScriptリスナーからの全エラーテキスト、userSetup.melの内容（Maya）またはMAXScriptインストールログ（3ds Max）。

プラグインの削除

Plugin v1をアンインストールするには — クリーンな再インストール、共有ワークステーションのクリーンアップ、または移行前の準備 — 手順はDCCごとです。

Maya：

1. Mayaを終了します。
2. Mayaのスクリプトディレクトリの下のsuperrendersフォルダを削除します： - Windows：C:\Users\<YourWindowsUser>\Documents\maya\<MayaVersion>\scripts\superrenders - macOS：~/Library/Preferences/Autodesk/maya/<MayaVersion>/scripts/superrenders
3. userSetup.melを開いて/***superrenders_begin***/と/***superrenders_end***/の間のブロックを削除します。保存します。
4. Mayaを再起動します。ワークステーションの各Mayaバージョンに対して繰り返します。

3ds Max：

1. 3ds Maxを閉じます。
2. 次回起動時にCustomize → Revert to Startup UI LayoutでUIをデフォルトにリセットするか、C:\Users\<YourWindowsUser>\AppData\Local\Autodesk\3dsMax\<Version>\ENU\usermacros\のSuperRendersマクロスクリプトファイル（SuperRenders_で始まるファイル）を削除します。
3. 3ds Maxを再起動します。

Cinema 4D： Cinema 4Dを閉じ、そのC4DバージョンのC4Dプラグインディレクトリの下のSuperRendersプラグインフォルダを削除し、Cinema 4Dを再起動します。Client AppはDCCごとのアンインストールボタンを現在公開していません。

削除後も、Client AppとWebダッシュボードはプラグインなしでジョブを提出できます。

提出プラグイン機能マトリクス

以下のマトリクスは、DCCごとの提出プラグインの機能をまとめたものです。3ds Max、Maya、Cinema 4Dの列はCrispが文書化したPlugin v1の機能リストから引用しています。新しいDCCリリースについては、その後の通貨に関する注記を参照してください。Blenderアドオン（Blender 4.2 LTS以降）はSuperRenders Client Appの「PLUGIN」タブからインストールでき、開いているシーンを提出します。その他の機能はここではまだ文書化されていません。HoudiniプラグインもSuperRenders Client Appからインストールしますが、このマトリクスではまだカバーされていません。

マトリクスはDCC内でPlugin v1ラッパーが処理する内容を追跡しています。ファーム側のエンジンサポート — 実際にジョブをレンダリングするエンジン — はより広く、関連するDCCセットアップドキュメントで追跡されています。Plugin v1はシーンをパッケージ化します；レンダラー（Arnold、V-Ray、Redshift等）はファーム側で実行されます。

通貨に関する注記

マトリクスは2023〜2024年に公開されたCrisp KBエントリから引用しています。3ds Maxについては、SuperRenders Client Appからインストールするプラグインが2023以降に対応しています。新しいMayaおよびCinema 4Dのリリース（Maya 2024 / 2025 / 2026、Cinema 4DのR26以降の命名、継続的なRedshift / Octaneのアップデート）は、Plugin v1が増分的にメンテナンスされてきたため高い確率で動作しますが、SRFは各新しいリリースに対して新鮮な確認を公開していません。 新しいDCCでプラグインの問題が発生した場合はチケットを送ってください；P1として扱います。

プラグインが適切でない場合

インストールされて動作している場合でも、プラグインなしの方が良いワークフローがあります：

• スポット提出でDCCに何もインストールしたくない場合。Webダッシュボードを使用してください。
• ロックダウンされたスタジオのワークステーションでユーザーが自分のスクリプトフォルダへの書き込みアクセスを持っていない場合。Webダッシュボードを使用してください。
• GUIなしのヘッドレスレンダー準備マシンでプラグインの提出ダイアログをクリックできない場合。Client AppのDrag-and-dropを使用してください。
• 提出プラグインがないDCC（例：After Effects）、および4.2より前のBlender。Client AppまたはWebダッシュボードを使用してください。

Client App、Webダッシュボード、提出プラグインは相互に排他的ではありません — 単一プロジェクトをClient App経由でアップロードしてプラグイン経由で提出したり、Web経由でアップロードしてプラグイン経由で提出したりできます。ワークステーションに合ったパスを選んでください。

クロスリファレンス

• Client App — アップロード、提出、ダウンロードのデスクトップラッパー
• クイックスタートガイド — プラグインなしのブラウザ提出フロー
• Webサブミット — ブラウザベースの提出詳細
• アップロードとダウンロード — アップロード方法の比較
• Setting up Maya — Maya固有の提出ノート
• Setting up 3ds Max — 3ds Max固有の提出ノート
• Setting up Cinema 4D — Cinema 4D固有の提出ノート
• Setting up Blender — Client App / Webを通じたBlenderの提出
• 一般的なエラー — DCC横断トラブルシューティング

FAQ

Q: 提出プラグインをインストールしなければなりませんか、それともプラグインなしでジョブを提出できますか？ A: プラグインはオプションです。Client AppとWebダッシュボードはどちらもDCCプラグインなしでジョブを提出します。プラグインは3Dソフトウェア内からワンクリックで提出することを好むユーザーのための利便性のためです。

Q: どの3DアプリケーションにSuperRendersの提出プラグインがありますか？ A: SuperRenders Client Appの「PLUGIN」タブからインストールするプラグインは、3ds Max（2023以降）、Maya、Cinema 4D、Houdini、Blender（4.2 LTS以降）をカバーしています。After Effectsには提出プラグインがありません；After Effectsのジョブは、Client AppまたはWebダッシュボードから提出します。

Q: インストール後にSuperRendersメニューが表示されないのはなぜですか？ A: 最も一般的な原因：プラグインが誤ったスクリプトフォルダに配置された（多くの場合DCCを実行するユーザーとは別のユーザーとしてインストールしたため）、またはDCCの保存済みシェルフ設定が壊れている。完全な診断フローについてはプラグインメニューまたはシェルフが表示されない場合を参照してください。

Q: プラグインをどのように更新しますか？ A: Client AppのPluginsパネルを開き、「Scan to update」をクリックしてDCCを再起動します。手動での更新も機能します — より新しいプラグインパッケージを使用してDCCごとのインストール手順を再実行してください；新しいバージョンが古いものをその場で上書きします。

Q: プラグインはMaya 2024以降、3ds Max 2025以降、または最新のCinema 4Dで動作しますか？ A: 3ds Maxについては、はい。SuperRenders Client Appからインストールするプラグインは3ds Max 2023以降をカバーしています。ファーム自体は3ds Max 2013〜2027およびMaya 2014〜2027に対応しています。MayaとCinema 4Dについては、Plugin v1の文書化されたマトリクスがMaya 2017〜2023とCinema 4D R15〜R25をカバーしています。Plugin v1は増分的にメンテナンスされてきたため、新しいリリースは高い確率で動作しますが、SRFはバージョンごとに改めて確認した結果を公開していません。新しいDCCで問題が発生した場合はチケットを送ってください；P1として扱います。

Q: Client Appをインストールせずにプラグインをインストールできますか？ A: 3ds MaxとMayaについてはそうです — このページの手動インストール手順はスタンドアロンのプラグインパッケージを使用します。Cinema 4Dの「Client Appなし」での手動パスは現在公開されていません；C4Dプラグインのインストールにはこ Client Appをインストールすることをお勧めします。

Q: プラグインは開きますが提出に失敗します。どこを確認すればよいですか？ A: 提出時のエラーは通常、シーンが正しくパッケージ化されたがファームが何かを拒否したことを意味します — 欠落しているアセット、ファームがサポートしていないレンダラー / エンジンバージョン、またはアカウントの請求の問題。エラーテキストを一般的なエラーと照合してください。メッセージが記載されていない場合は、エラーテキストとジョブIDと一緒にチケットを送ってください。