Sakura's Project Hub

Blender Development

The ultimate PyCharm plugin for developing and debugging Blender extensions with real-time reloading.

Supported in:PyCharm logo

About Blender Development for PyCharm

Blender Development for PyCharm is a comprehensive plugin that streamlines the creation and debugging of Blender extensions by enabling seamless launch and real-time reloading directly from the IDE. It features a dedicated management system for multiple Blender versions (LTS 4.2+, 5.0, & 5.1) and more.

Blender Management

Dedicated system for discovering, downloading, and managing multiple Blender versions with automatic linter configuration.

Real-Time Development

Robust auto-reload capabilities powered by bidirectional TCP communication for instant feedback in Blender.

Automated Lifecycle

Streamlined project creation via an integrated wizard that handles multi-source directories and manifest configuration.

Global Ready

Comprehensive internationalization support for 11 languages, ensuring a native experience for developers worldwide.

License

This project is licensed under the GNU General Public License v3.0 (GPL-3.0).

AI Usage Declaration

This project is developed in collaboration with Junie, an AI agent by JetBrains integrated into IntelliJ IDEA. AI assistance is utilized for:

  • Code Generation & Architecture: Implementing core logic, refactoring, and documentation.
  • Quality Assurance: Assisting with code reviews, optimization, and bug fixing.
  • Internationalization: Localizing the plugin into 11+ languages.
  • Workflow Automation: Managing repetitive tasks, git commits, and documentation updates.

Human Oversight: All AI-generated contributions are strictly reviewed, tested, and approved by Sakura Sedaia to ensure project integrity and security.

Downloads

Stable Branch

Version:
V1.0.0 (Latest)
V1.0.0 (Latest)
Download Blender Development V1
Build VersionRelease DateFile Size
V1.0.0TBA0.00 MB

Changes Summary

This project has not been officially released yet, but is available for testing and feedback through the Development Branch.

View full Changelog - Repository

Development Branch

Version:
0.6.0 Alpha (Latest)
0.6.0 Alpha (Latest)
0.5.0 Alpha
0.4.0 Alpha
0.3.0 Alpha
0.2.0 Alpha
0.1.0 Alpha
Download 0.6.0 Alpha
Build VersionRelease DateFile Size
0.6.0 Alpha04/26/20263.8 MB

Changes Summary

Blender Development for PyCharm 0.6.0 significantly strengthens the foundation of the plugin. The move to uv, the improved project setup tools, the safer execution flow, and the extensive threading and process fixes make this release faster, more predictable, and better suited for real-world Blender extension development across Windows, macOS, and Linux.

View full Changelog - Repository

Operating Instructions

More In-Depth Documentation

For more detailed and up to date documentation, including in-depth configuration, architectural overviews, and usage guides, please visit the official Blender Development for PyCharm Wiki.

Configuration and Setup

Prerequisites and installation steps for PyCharm.

  1. Ensure uv is installed (the plugin can handle this automatically).
  2. Download the latest ZIP from the releases page.
  3. In PyCharm: Settings > Plugins > Install from Disk....
  4. Create a Blender Run Configuration.
  5. Enable Auto-reload extension on save in Tools settings.

Management & Usage

How to manage Blender versions and use reloading.

  • Blender Management: Use the tool window on the right sidebar to download and manage versions.
  • Automatic Reload: Triggered on Ctrl+S once enabled.
  • Manual Reload: Use Ctrl+Alt+R or the Blender menu.
  • Custom Splash: Add splash.png to your project root.

Found a Bug?

For any bugs, feature requests, or general issues, please file a report on the Codeberg repository so we can address them.

Report an Issue

Known Issues

Currently there are no known issues impacting user experience, though there are guaranteed to be more as the plugin is tested and stressed. Issues listed here are confirmed, verified, and are either planned or are currently being worked on.

  • No Known issues as this time.

    Confirmed on MM-DD-YYYY

    No known issues as of now, this page will be updated as more issues are discovered and logged.