Debugging multifile Blender add-on by quick reinstall

It is convenient to use the following system for debugging developing multi-file Blender add-ons. But it has one drawback: modules imported in file becomes available only after the file running (after the execution of the register() function). This means that any access to the imported modules before they are registered will cause an error. This is not critical in most cases, but it will cause a problem if, for example, in one imported module is used inheritance from the class, described in the other imported module, because the classes descriptions are processed before the add-on registration.

To get more freedom working with imported modules, we can use another way to debug the add-on – do not run the add-on directly from the development directory, but install it in Blender and check its “live” work. However, manual add-on reinstallation requires a set of routine actions, which complicates such sort of debugging. This issue can be solved by reinstalling the add-on in automatic mode.

Let’s consider add-on debugging with the previously created test “addCube” add-on, consisting of three modules:


“addCube” (adds a default cube to the scene) and “addCubePanel” (the panel with the button for adding a cube) modules will remain unchanged:

But the main module becomes much simpler.

Now the package with add-on modules is always located in the same place – in the Blender add-ons directory, so we can import required modules any place with the single command:

and there is no need to pre-import all the package modules.

Now in the file we need to import only the main modules “addCube” and “addCubePanel”.

If (in more complex add-ons) somewhere in modules we need to import some other modules, no pre-import in the file is necessary. The same command “from . import module_name” is enough.

Except main modules import only the “register” and “unregister” functions remain in the file (to initialize those modules) and the dictionary with the add-0n description.

The complete file looks like the following:

The add-on modules are finished, it remains to modify the debugging script in Blender.

Open Blender, switch to the “Text Editor” window and create a new script.

To start, let’s define the input parameters: the name of the add-on directory (its package name), the full path to the add-on directory, and the mask describes add-on modules – all files with the “.py” extension. To include some additional add-on files, for example, “” and “LICENSE”, let’s specify them in a separate list.

Collect all necessary files with their full paths in the “files” list:

In the system temporary directory, let’s create our temporary folder to prepare add-on files for the installation into Blender. Using the “with” construction will automatically clean up all temporary files and directories after the script execution.

Copy all the add-on files to the created temporary folder. It is necessary to copy them to the package – in a subdirectory with the same name as the name of the add-on.

Zip the package folder with the files in the archive:

The full path to the created zip-archive saved in the “addon_zip_path” variable. The further add-on installation will be carried out from this path.

The code of the developing add-on is constantly updated. Therefore, each script launch must first remove the old add-on version (installed at the previous launch).

First string deactivates the add-on, and the second removes it from Blender. However, imported add-on modules still remain in the memory. To update all the code, they also need to be removed. We need to remove only modules loaded from the package of our add-on.

Now we can reinstall the add-on from our temporary directory:

The complete script code that reinstalls the add-on:

In order to fully update the add-on code in Blender, it’s enough just to press the “Run Script” button.

Now it is simple and convenient to make changes into developing code, switch to Blender, press “Run Script” and have updated add-on installed and ready for the test run.

This debugging script is universal, it can be used to develop any multi-file add-ons. You just need to change the add-on directory and the path to the development directory in the corresponding variables to new ones.

0 0 votes
Article Rating
Notify of

0 Comment
Inline Feedbacks
View all comments