https://github.com/doramas-ga-jo/blender-addon-template
Structured starting point for developing Blender add-ons.
https://github.com/doramas-ga-jo/blender-addon-template
addon blender dcc template
Last synced: about 2 months ago
JSON representation
Structured starting point for developing Blender add-ons.
- Host: GitHub
- URL: https://github.com/doramas-ga-jo/blender-addon-template
- Owner: doramas-ga-jo
- License: mit
- Created: 2026-05-19T18:49:02.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-19T19:26:09.000Z (about 2 months ago)
- Last Synced: 2026-05-19T22:57:05.497Z (about 2 months ago)
- Topics: addon, blender, dcc, template
- Language: Python
- Homepage:
- Size: 6.84 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Blender Add-on Template
![Python][python_badge]
![Blender][blender_badge]
Structured starting point for developing **Blender** add-ons.
## Set Up Instructions
This guide shows how to set up a custom scripts folder so you can reload your add-on without restarting **Blender**.
1. **Open preferences**:
Open **Blender** preferences by pressing `Ctrl + ,` or going to `Edit → Preferences` in the **Blender** topbar menu.\
![][blender_addon_01]
2. **Add custom scripts directory**:
In the File Paths section, add a custom scripts directory.
Make sure there is a directory named `addons` (lowercase) inside the selected folder and place the addon inside it.\
![][blender_addon_02]
3. **Save preferences**:
Save your preferences so the settings persist between **Blender** sessions.
5. **Refresh local add-ons**:
Refresh local add-ons. Your add-on should now appear in the list for enabling/disabling.
Reload your add-on during development by refreshing local add-ons again with no need to restart Blender.\
![][blender_addon_03]
6. **Activate the addon**:
Search for your add-on and activate it.\
![][blender_addon_04]
## Custom Scripts Directory Structure
Here’s an example of how your custom scripts directory might be organized when adding **Blender** add-ons.
> [!NOTE]
> **Blender** supports both single-file and folder-based add-ons.
```
custom scripts directory/
└── addons/
├── addon.py # Single-file add-on
└── addon_folder/ # Folder-based add-on
├── __init__.py
├── other_module.py
└── ...
```
[python_badge]: https://img.shields.io/badge/Python-3.13+-3776AB?logo=python&logoColor=white
[blender_badge]: https://img.shields.io/badge/Blender-4.5.0+-F5792A?logo=blender&logoColor=white
[blender_addon_01]: https://res.cloudinary.com/difrkkpmx/image/upload/v1777570428/blender_addon_01_aq1xpo.webp
[blender_addon_02]: https://res.cloudinary.com/difrkkpmx/image/upload/v1777570428/blender_addon_02_c5mdoj.webp
[blender_addon_03]: https://res.cloudinary.com/difrkkpmx/image/upload/v1777570428/blender_addon_03_toy8gf.webp
[blender_addon_04]: https://res.cloudinary.com/difrkkpmx/image/upload/v1777570428/blender_addon_04_cvnbbn.webp