Blender Addon

This repository is a toolbox to create a new blender addon. To used-it, clone this repository and rename the folder blender_addon_folder with your addon name. It's important to change some files :

• Update the file "tests/main.py", line 29, set your addon name.

  # Prepare Blender and Unreal dependency
  generate_archive(archives, 'blender_addon_folder')
  

• You can remove the folder "presets" and disable the workflow (.gitea/workflows/pr_main.yml, line 38 and 53)

⚠️ It's more easy to use the "_" with your addon folder name, the "-" character can be problematic with python use.

Features

All features covered with this Blender Addon template are :

• Generate addon release (.zip archive)
• Generate preset release (.zip archive)
• Update addon version (bl info) with tag name
• Execute unit test with Gitea Action (check if the addon can be installed with blender)
• Configuration with Pycharm to test locally
• Linter config

Unit Test

All unit tests call docker image stilobique/blender. It's a simple ubuntu image with blender compile. If you want change the blender version tested, edit the main.py inside the tests folder ; change the tag version with your requested tag.

class Container(enum.Enum):
    """Enumerate about the Geometry node"""
    BLENDER = ContainerObject(name='Blender', image='stilobique/blender', tag='3.1.2')

Find the repository git on my public space.

Addons/Plugins dependency

Update json file tests/dependency.json with name, archive and repository Github path. Each entry require archive name, the repository url path '{owner}/{repo}' and optional parameter if the release needed to be a prerelease.