StraySpark Docs
StraySpark Docs
DashboardWebsiteStraySpark Documentation

Products

Procedural Placement ToolGetting StartedConfigurationDensity ModesBiome ZonesSpline ScatterExclusion ZonesPresetsExamplesAPI ReferenceChangelog
Cinematic Spline ToolGetting StartedCamera Modes and FeaturesFilmback PresetsComponentsSequences and Camera ManagerCamera CollisionExamplesAPI Reference
Blueprint Template LibraryGetting StartedHealth SystemInventory SystemDialogue SystemQuest SystemAbility/Buff SystemStat/Attribute SystemInteraction SystemSave/Load SystemProgression SystemFaction / Reputation SystemStatus Effect SystemLoot Table SystemSkill Tree SystemParty / Team SystemNetworking & Event BusAI IntegrationDebug ToolsExamplesAPI ReferenceChangelog
DetailForgeGetting StartedAttributesConditional LogicDisplay WidgetsAPI Reference
UltraWireGetting StartedWire RoutingWire EffectsNode ThemingMinimap & HeatmapPresetsSettings Reference
Unreal MCP ServerGetting StartedInstallation and ConfigurationTool CategoriesTool PresetsResourcesPromptsArchitectureSTDIO BridgeAPI Reference
Blender MCP ServerGetting StartedInstallationTool CategoriesPresetsResourcesPromptsConfigurationArchitectureAPI Reference
Godot MCP ServerGetting StartedInstallationTool CategoriesResourcesPromptsArchitectureAPI Reference

Blender Addons

AI Material GeneratorGetting StartedProvidersPresetsTweak ModeNode ReferenceAPI Reference
Procedural Damage & Wear SystemGetting StartedWear EffectsPresetsExportSurface TypesAPI Reference
One-Click PBR Bake & ExportGetting StartedChannelsEngine PresetsChannel PackingBatch BakingAPI Reference
AI Material Generator

Getting Started

Install the AI Material Generator addon, configure a provider, and generate your first material in minutes.

This guide walks you through installing the AI Material Generator addon, configuring an LLM provider, and generating your first shader node tree from a text description.

Prerequisites

  • Blender 4.2 or later (Windows, macOS, or Linux)
  • An LLM provider -- either a local Ollama instance or an API key for OpenAI/Anthropic

Step 1: Install the Addon

  1. Download the ai_material_generator.zip file from your purchase.
  2. Open Blender and go to Edit > Preferences > Add-ons.
  3. Click Install from Disk and select the downloaded zip file.
  4. Enable the addon by checking the checkbox next to AI Material Generator.

The addon requires no external Python dependencies. Everything is self-contained in the zip.

Step 2: Configure a Provider

Open the addon preferences at Edit > Preferences > Add-ons > AI Material Generator and choose your LLM provider.

Ollama (Recommended for Free Local Use)

Ollama runs models entirely on your machine. No API key needed, no data leaves your computer.

  1. Install Ollama from ollama.com.
  2. Pull a model:
ollama pull llama3
  1. In the addon preferences, set Provider to Ollama.
  2. Verify the Ollama URL is http://localhost:11434 (the default).

OpenAI

  1. Get an API key from platform.openai.com.
  2. In the addon preferences, set Provider to OpenAI.
  3. Paste your API key in the OpenAI API Key field.

Anthropic

  1. Get an API key from console.anthropic.com.
  2. In the addon preferences, set Provider to Anthropic.
  3. Paste your API key in the Anthropic API Key field.

For a full comparison of providers, see the Providers page.

Step 3: Generate Your First Material

  1. Open the N-Panel in the 3D Viewport (press N if it is not visible).
  2. Click the AI Material Gen tab.
  3. In the description field, type:
brushed steel with fingerprints
  1. Set the Complexity level to Medium (a good starting point).
  2. Click Generate.

The addon sends your description to the configured LLM, validates the response, and builds the shader node tree. Progress is displayed in the panel. Generation typically takes 5-15 seconds depending on your provider and model.

Step 4: Apply to Object

After generation, the material is available in two ways:

  • Auto-assign: If you had an object selected before clicking Generate, the material is automatically assigned to its active material slot.
  • Manual assignment: Select any object, go to the Material Properties panel, click the material dropdown, and choose the newly generated material.

The generated material appears in bpy.data.materials with a name based on your description (for example, AI_brushed_steel_with_fingerprints).

What to Read Next

  • Providers -- Detailed provider setup and comparison
  • Presets -- Use built-in presets without needing an LLM connection
  • Tweak Mode -- Refine generated materials with follow-up prompts
  • API Reference -- Operators and properties for scripting

AI Material Generator

Turn natural language descriptions into complete Blender shader node trees powered by LLMs.

Providers

Configure Ollama, OpenAI, or Anthropic as the LLM backend for material generation.

On this page

PrerequisitesStep 1: Install the AddonStep 2: Configure a ProviderOllama (Recommended for Free Local Use)OpenAIAnthropicStep 3: Generate Your First MaterialStep 4: Apply to ObjectWhat to Read Next