アドオンをインストールする方法を紹介する。
複数ファイル構成のアドオンのインストール方法・再読み込み方法・インストールできない場合などの対処法なども紹介する。
もくじ
GitHubからのダウンロード方法
アドオンは、ネットで公開されている様々なサイトからダウンロードできるが、公開サイトは特にGitHubというソースコード共有サイトにあることが多い。
ただし、Githubはダウンロード方法が少し面倒くさいので、手順をここに書く。
単一ファイルのアドオンの場合
- ソースコードのページの右にある[Raw]を右クリック
- 「リンク先を別名で保存」する
- ファイルの拡張子が[.py]になるようにする
- Blenderの設定 → アドオン → アドオンをインストールするボタン
複数ファイルで構成されたアドオンの場合
アドオンが複数のファイルで構成されている場合、リポジトリ(プロジェクトのようなもの)をまるごとzipでダウンロードする必要がある。
- 緑色のClone or Download から[Zip Download]でダウンロード
- もし、アドオンが内に入っているフォルダが直下でない場合は、一度zipを開いて、その階層のみをzip に圧縮
- Blenderの設定 → アドオン → アドオンをインストールするボタンから、zipを選択してインストール
「releases」 からのダウンロード
公開している作者によっては、ダウンロードしやすいようにページを用意している場合がある。
releasesが用意されている場合は、こちらからダウンロードして使用する方がよい。
- releases をクリック
- ほしいバージョンを選び、〇〇.zipをクリックしてダウンロード
単一ファイルをインストールする
単一ファイルで構成されているアドオンであれば、Blenderの機能の"Install…"からインストールする事ができる。
- Edit -> Preferences... -> Addon -> Install…
- 〇〇.pyファイルを選択してインストール
zipファイルをインストールする(複数ファイル構成のアドオン)
複雑なアドオンの場合、複数ファイルで構成されている場合がある。
この場合は、〇〇.pyではなく、zipファイルのままインストールする。
複数ファイル構成のアドオンは、"__init__.py"というファイル名のファイルが必ずあるので、これで判別できる。
直接addonsフォルダにコピーする
アドオンはインストールされると、下記の場所に保存される。
なので、手動でこのフォルダにコピーしてもインストールすることができる。
■ Windows C:\Users\「ユーザー名」\AppData\Roaming\Blender Foundation\Blender\「2.80などのバージョン名」\scripts\addons ■ Mac /Users/「ユーザ名」/Library/Application Support/Blender/「2.80などのバージョン名」/scripts/addons AppDataやLibraryは隠しフォルダなので注意
コピーした後は設定のアドオンの再読み込みボタンから再読み込みするか、Blenderを再起動すること。
Blender2.79であれば、F8キーからも再読込することができる。
Blender2.8 からはショートカットがなくなったため、手動で script.reload をキー登録することでも再読み込みできる。
内蔵のアドオンについて
アドオンは、既にBlenderのアプリ自体に内蔵されているものもある。
その場合は、普通にアドオンタブ内で検索すれば有効化するだけで使用できる。
- Edit -> Preferences... -> Addon -> 右上の検索ボックスからアドオン名を検索
- チェックボックスをクリックして有効化
インストールできない場合
アドオンリストに表示されない
インストールするzipのフォルダーの直下に、"__init__.py"ファイルが存在していることを確認すること。
たまにzipのフォルダー内に、アドオン以外のファイルがさらに階層分けで入っている場合がある。
その場合は、 "__init__.py" ファイルがあるフォルダを手動でzipに圧縮して、インストールする。
もしくは、上記項目の「直接addonsフォルダにコピーする」方法でインストールしてみる。
エラーが出る
エラーをGoogleなどで検索して、自分の環境に問題があるようであれば改善する。
調べてもわからないようであれば、アドオン作者に問い合わせる。
その場合、エラーログをコピーしてアドオン作者に送ると、スムーズに解決しやすい。
エラーログは、情報エディターから閲覧することができる。
- ウィンドウの左上 -> エディタータイプ切り替えアイコン -> Info(情報)
アドオンのファイル名に”.”が入っている
"g_lasso_draw_2-8_ver1-4.1.py"のような、ファイル名に"."が入っているアドオンを有効化しようとすると、下記のようにエラーが起こる。
Traceback (most recent call last):
File "C:\Program Files\blender-2.80.80\scripts\modules\addon_utils.py", line 351, in enable
mod = __import__(module_name)
ModuleNotFoundError: No module named "g_lasso_draw_2-8_ver1-4-"
ファイル名から"."を除去すると解決する。