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).

  • Managed Versions: Tool Window provides scrollable tables and dedicated action buttons for easier Blender version management.

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

  • Sandbox Control: Integrated tools for clearing and managing Blender sandboxed environments, providing granular control over configuration discovery and isolation.

Execution & Permission Validation

To ensure Blender starts reliably across different Linux distributions and macOS versions, the plugin includes a dedicated validation layer:

  • Automatic Permissions: On Unix-like systems (Linux/macOS), the plugin automatically checks if the Blender binary has the required execution bit set. If not, it attempts to apply the correct permissions before launching.

  • Filesystem Restriction Detection: The plugin proactively and reactively detects if a partition is mounted with restrictive flags (like noexec on Linux).

  • Actionable Feedback: If an execution failure occurs due to filesystem restrictions, the plugin provides a detailed error message with direct links to the Linux Execution Guide (Permission Denied) for permanent solutions.

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