Repolode
scenario-labs

scenario-labs/blender-plugin

A Blender add-on that brings Scenario AI image, video, 3D, PBR material and audio generation into the viewport, plus a local MCP server for agents.

Stars
638
Forks
67
Open issues
52
Last commit
4 hours ago

What is it?

Scenario for Blender is a GPL-3.0-or-later Python extension for Blender 5.0 and later that connects a Scenario account to the 3D viewport. It covers image, video, 3D mesh, PBR material, audio and 360 environment generation, and can use scene captures, selected meshes and camera playblasts as inputs. A Blockout lane turns a written scene description into a greybox layout, and Film tasks build shots, a timeline and an exported video from a JSON recipe.

Generation requires a Scenario account with API key and secret, and an internet connection with Blender's online access enabled. Generations consume Creative Units, and the panel shows a cost estimate before each run. The project is marked experimental, and its known limitations are documented separately.

The extension also includes a local MCP server on a loopback HTTP endpoint, so agents such as Claude Code, Codex, Cursor or Claude Desktop can read the open scene and request generation. Arbitrary Python execution is a separate opt-in permission that is disabled by default. A headless entry point allows running the server with blender --background.

Key features

  • 01Generates images, video, 3D meshes, PBR texture sets and audio from prompts or references
  • 02Uses scene captures and selected meshes as inputs for rendering and editing
  • 03Turns a written scene description into a greybox layout via Blockout
  • 04Provides a local MCP server for agents, with opt-in Python execution
  • 05Builds shots and exported video from a JSON recipe through Film tasks

Use cases

  • Creating textures and PBR material sets for game asset pipelines in Blender
  • Blocking out levels or scenes from a text description before modeling
  • Letting an AI agent drive scene generation inside a running Blender session

Quick start

  1. 1

    Turn on Allow Online Access in Edit > Preferences > System > Network

  2. 2

    Add the remote repository https://blender.scenario.com/repo/index.json under Get Extensions > Repositories

  3. 3

    Install Scenario from Get Extensions

  4. 4

    Enter your Scenario API key and secret in Add-ons > Scenario, then press Test connection

Things to know

  • Marked experimental by its authors, so workflows may change or fail.
  • Requires a Scenario account with API access, and generations consume paid Creative Units.
  • Requires Blender 5.0 or later.
  • Licensed GPL-3.0-or-later, a copyleft license that applies to derivative works.

In collections

Topics

FAQ

What is blender-plugin?
A Blender add-on that brings Scenario AI image, video, 3D, PBR material and audio generation into the viewport, plus a local MCP server for agents. Scenario for Blender is a GPL-3.0-or-later Python extension for Blender 5.0 and later that connects a Scenario account to the 3D viewport. It covers image, video, 3D mesh, PBR material, audio and 360 environment generation, and can use scene captures, selected meshes and camera playblasts as inputs. A Blockout lane turns a written scene description into a greybox layout, and Film tasks build shots, a timeline and an exported video from a JSON recipe.
Is blender-plugin free to use? What license does it have?
blender-plugin is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is blender-plugin still maintained?
Actively maintained. The last commit to blender-plugin was on Oct 22, 2026.
What can I use blender-plugin for?
Creating textures and PBR material sets for game asset pipelines in Blender Blocking out levels or scenes from a text description before modeling Letting an AI agent drive scene generation inside a running Blender session
How do I install blender-plugin?
Turn on Allow Online Access in Edit > Preferences > System > Network Add the remote repository https://blender.scenario.com/repo/index.json under Get Extensions > Repositories Install Scenario from Get Extensions Enter your Scenario API key and secret in Add-ons > Scenario, then press Test connection
Where can I get blender-plugin?
The source code and installation instructions are on GitHub: https://github.com/scenario-labs/blender-plugin

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects