Environment Management

Blender Management Tool Window

Located on the right sidebar (labeled MBVS), this tool window allows you to manage Blender installations globally:

  • Refresh Status: Scans the system path and standard installation directories for already installed Blender versions, as well as managed versions. Scanning is accelerated by version metadata caching.

  • Connection Status: Displays a Status label indicating whether PyCharm is actively connected to a running Blender instance.

  • Download/Delete: Automatically fetch Blender 4.2+ versions (including 5.0 and 5.1) directly from the Blender Foundation’s servers. These are kept in a plugin-managed directory.

  • System Blender Installations: Displays a list of Blender executables found in standard system locations (e.g., Program Files, /Applications, /usr/bin).

  • UI Improvements: Optimized Tool Window layout with scrollable tables and dedicated action buttons for easier Blender version management.

  • Clear Sandbox: Quickly delete the project-local .venv/blender_sandbox directory to reset your testing environment.

  • Sandbox Management: A dedicated tool window for clearing and managing Blender sandboxed environments, providing more granular control over configuration discovery and isolation.

Automated Python Interpreter Setup

When a Blender version is downloaded or selected, the plugin automatically detects and replicates the bundled Python interpreter’s configuration. This ensures that PyCharm’s editor features (autocomplete, linting, type hinting) are correctly set up for the specific Blender version being used.

Version Support

The plugin officially supports all major and minor versions after Blender 4.2+, which introduced the Blender Extension Platform. This includes LTS versions and the latest 5.0/5.1 releases. If you wish to use a version not managed by the plugin, select Custom/Pre-installed in the run configuration and point to your local executable, or add it as a custom path in the MBVS Tool Window