Blenderアドオンを好きな場所に置いて管理する2つの方法
お疲れ様です。
Blenderのアドオンを通常の手順でインストールすると、Blenderが管理するバージョン別のフォルダへコピーされます。
手軽ではありますが、次のような場面では少し不便です。
Blenderを更新するたびにアドオンの場所が変わる
Gitで管理している自作アドオンを更新しにくい
複数バージョンのBlenderから同じアドオンを使いたい
アドオンの保存場所を自分で整理したい
制作チーム全員へ同じアドオンを配布したい
そこで便利なのが、Blenderの「ローカルリポジトリ」と「スクリプトディレクトリ」です。
どちらも、アドオンを任意の場所に置いたままBlenderから利用できる仕組みです。ただし、対象となるアドオンの形式が異なります。
この記事では「ローカルリポジトリ」と「スクリプトディレクトリ」について詳しく解説します。
先に結論
現在のBlenderで新しい形式のアドオンを管理するなら、基本的には「ローカルリポジトリ」がおすすめです。
古い形式のアドオン、いわゆるレガシーアドオンをそのまま使いたい場合は「スクリプトディレクトリ」が便利です。
方法主な対象見分け方ローカルリポジトリ新しいExtensions形式blender_manifest.tomlがあるスクリプトディレクトリ従来のレガシーアドオンbl_infoを記述した__init__.pyなどがある
※この記事は主にBlender 4.2以降を想定しています。バージョンによって項目名や画面の配置が多少異なる場合があります。
方法1:ローカルリポジトリを使う
ローカルリポジトリは、指定したフォルダをBlenderのExtensions用保存場所として登録する機能です。
ここでいう「リポジトリ」はGitリポジトリという意味ではなく、Blenderが拡張機能を探すフォルダのことです。
たとえば、次のようなフォルダを用意します。
D:\Blender_Addons\extensions\
├─ my_addon\
│ ├─ blender_manifest.toml
│ ├─ __init__.py
│ └─ その他のファイル
└─ another_addon\
├─ blender_manifest.toml
└─ __init__.pyBlenderには、一番上のextensionsフォルダを登録します。個々のアドオンフォルダではない点に注意してください。
設定方法
Blenderの「編集」から「プリファレンス」を開く
「エクステンションを入手(Get Extensions)」を開く
リポジトリの設定を開く
「ローカルリポジトリを追加」を選ぶ
用意したextensionsフォルダを指定する
一覧に表示されたアドオンを有効にする
アドオンのファイルを更新したあとは、「ローカルを更新(Refresh Local)」を実行すると、フォルダの内容が再スキャンされます。
反映が不完全な場合は、アドオンの無効化と再有効化、またはBlenderの再起動を試します。
Blenderの公式開発資料でも、開発中のアドオン用に独立したローカルリポジトリを作る方法が案内されています。
Gitで管理している場合
アドオンをGitで管理しているなら、ローカルリポジトリの下へクローンしておくと便利です。
D:\Blender_Addons\extensions\my_addonこのフォルダで更新を取得すれば、ZIPファイルを作って毎回インストールし直す必要はありません。
ただし、ローカルリポジトリ自体にGitの更新や自動更新の機能があるわけではありません。
Gitやファイル同期などを使ってアドオンのファイルを更新し、そのあとBlender側で再スキャンまたは再起動する、という使い方になります。
方法2:スクリプトディレクトリを使う
スクリプトディレクトリは、BlenderがPythonスクリプトを探す場所を追加する機能です。
従来形式のアドオンを任意の場所から読み込ませたい場合に利用できます。
フォルダは次のように作ります。
D:\Blender_Addons\scripts\
└─ addons\
├─ my_legacy_addon\
│ └─ __init__.py
└─ another_legacy_addon.pyBlenderに登録するのはaddonsフォルダではなく、そのひとつ上のscriptsフォルダです。
設定方法
「編集」から「プリファレンス」を開く
「ファイルパス(File Paths)」を開く
「スクリプトディレクトリ(Script Directories)」を探す
「+」ボタンで項目を追加する
名前とscriptsフォルダの場所を指定する
Blenderを再起動する
プリファレンスのアドオン一覧から有効にする
スクリプトディレクトリの中では、用途に応じて次のサブフォルダも利用できます。
scripts\
├─ addons\ アドオン
├─ modules\ Pythonモジュール
├─ presets\ 各種プリセット
└─ startup\ 起動時に読み込むスクリプトアドオンだけを使う場合は、基本的にaddonsフォルダだけ用意すれば十分です。
公式マニュアルでも、スクリプトディレクトリを追加することで、自作スクリプトやアドオンをBlender本体のバージョンとは独立して保存できると説明されています。
どちらを使えばよいのか
blender_manifest.tomlが含まれている新しい形式のアドオンなら、ローカルリポジトリを使います。
従来のbl_infoを使ったアドオンで、Extensions形式へ移行していないものなら、スクリプトディレクトリを使います。
新しく自作アドオンを作る場合も、今後の管理を考えるとExtensions形式とローカルリポジトリの組み合わせが扱いやすいでしょう。
制作スタジオの共有ツール配布にも使える
ローカルリポジトリやスクリプトディレクトリは、個人でアドオンを整理するだけでなく、制作スタジオ内の共有ツールを配布する用途にも利用できます。
たとえば、社内サーバーに次のような共有フォルダを用意します。
\\studio-server\blender-tools\
├─ extensions\
│ └─ studio_tools\
│ ├─ blender_manifest.toml
│ └─ __init__.py
└─ scripts\
└─ addons\
└─ legacy_studio_tools\
└─ __init__.py一般ユーザーには読み取り権限だけを与え、ツールを管理する担当者だけが書き換えられるようにします。
各ユーザーのBlenderから共有フォルダを登録しておけば、管理担当者がサーバー上のアドオンを更新するだけで、全員が同じツールを利用できます。
利用者が更新のたびにZIPファイルを受け取り、個別にインストールし直す必要がないため、ユーザー側の負担を減らせます。
Extensions形式を共有する場合
新しいExtensions形式のアドオンでは、サーバー上の共有フォルダをローカルリポジトリとして登録します。
制作スタジオで利用する場合は、リポジトリの詳細設定にある「Source」を「System」にするのがおすすめです。
Systemリポジトリは、Blenderの外部で管理される読み取り専用のリポジトリとして扱われます。
サーバー側でも、次のようにアクセス権限を分けておくと安全です。
一般ユーザー:読み取りのみ
ツール管理者:読み取りと書き込み
その他のユーザー:必要に応じてアクセス不可
Systemに設定しただけでサーバーの権限が自動的に変わるわけではないため、実際のアクセス権限はサーバー側でも設定しておきます。
PCのセットアップを一括管理しているスタジオでは、環境変数BLENDER_SYSTEM_EXTENSIONSを使って共有リポジトリを指定する方法もあります。
この方法では、指定したフォルダの中にsystemフォルダを用意し、その下へ各Extensionsを配置します。
\\studio-server\blender-extensions\
└─ system\
└─ studio_tools\
├─ blender_manifest.toml
└─ __init__.py公式マニュアルでも、Systemリポジトリを読み取り専用のネットワークドライブへ配置し、すべてのユーザーへExtensionsを提供する運用が紹介されています。
従来形式のアドオンを共有する場合
レガシーアドオンは、共有サーバー上のフォルダをスクリプトディレクトリとして登録できます。
各ユーザーの「プリファレンス」→「ファイルパス」→「スクリプトディレクトリ」に、共有サーバー上のscriptsフォルダを指定します。
管理された環境では、環境変数BLENDER_SYSTEM_SCRIPTSを使って、すべてのユーザーへ同じスクリプトディレクトリを追加することもできます。
Blender 4.2の公式リリースノートでも、アニメーションスタジオですべてのユーザーへスクリプトを提供する用途が例として挙げられています。
共有ツールを更新するときの注意
サーバー上のファイルを書き換えても、すでに起動しているBlenderの中でアドオンが自動的に入れ替わるとは限りません。
Extensions一覧の「ローカルを更新(Refresh Local)」で再スキャンできますが、大きな変更を確実に反映させるにはBlenderの再起動がおすすめです。
また、ユーザーが作業している時間帯にアドオンを直接上書きすると、更新途中のファイルを読み込んでしまう可能性があります。
実際の運用では、次のような流れにすると安全です。
管理者が別の場所で新しいバージョンをテストする
問題がなければ共有サーバーへ反映する
利用者へBlenderの再起動を案内する
問題があった場合に戻せるよう、以前のバージョンを保管する
アドオン自身が設定、ログ、キャッシュなどを保存する場合は、共有アドオンフォルダへ直接書き込まない設計も重要です。
Extensions形式では、アドオンの保存場所が読み取り専用である可能性を考慮し、ユーザーごとのデータ保存先を取得する仕組みがBlenderに用意されています。
共有フォルダ方式のメリットと注意点
共有フォルダ方式には、次のようなメリットがあります。
全員が同じバージョンのツールを使える
利用者が個別に更新作業をしなくてよい
不具合修正や機能追加を一括で配布できる
ツールを管理できるユーザーを限定できる
新しいPCのセットアップを簡略化できる
一方で、ネットワークへ接続できない場合は、共有フォルダ上のアドオンを読み込めない可能性があります。
利用者が多い場合や、ネットワークが切れても作業を続ける必要がある場合は、共有サーバーから各PCへアドオンを同期する方式や、スタジオ専用のリモートExtensionsリポジトリを用意する方法も検討できます。
少人数から中規模程度のチームであれば、まずは共有フォルダを直接登録する方法が導入しやすいでしょう。
同じアドオンを重複して置かない
同じアドオンを、通常のインストール先と任意のフォルダの両方に置かないようにします。
同名のアドオンが複数見つかると、どちらが読み込まれているのか分かりにくくなり、更新内容が反映されない原因にもなります。
管理方法を切り替える際は、以前インストールしたコピーを無効化または削除してから確認するのがおすすめです。
また、Blenderのバージョンが異なるとPython APIの互換性に問題が出る場合があります。複数バージョンで同じフォルダを共有する場合は、それぞれのBlenderで動作確認が必要です。
まとめ
Blenderのアドオンを任意の場所で管理すると、Blenderの更新に左右されにくくなり、Gitなどを使った更新も楽になります。
新しいExtensions形式なら「ローカルリポジトリ」
従来形式のアドオンなら「スクリプトディレクトリ」
制作スタジオでは共有サーバーから全員へ配布できる
共有する場合は一般ユーザーを読み取り専用にする
更新後は再スキャン、再有効化、またはBlenderの再起動を行う
同じアドオンを複数の場所へ重複して置かない
更新前のテストと、以前のバージョンを戻せる準備をしておく
自作アドオンを編集しながら使う人、複数バージョンのBlenderを使い分けている人、社内ツールを一括管理したい制作チームには、特に便利な設定です。