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

AI Material Generator

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

The AI Material Generator is a Blender addon that turns natural language descriptions into complete shader node trees. Describe the material you want -- "weathered copper with green patina" or "holographic carbon fiber" -- and the addon generates a fully connected node tree ready for rendering. Built by StraySpark. Licensed under the MIT License.

Feature Overview

FeatureDetails
LLM ProvidersOllama (local, free), OpenAI (GPT-4o), Anthropic (Claude)
Presets50+ built-in presets across 5 categories (Metals, Wood, Stone, Fabric, Sci-Fi)
Node Types30+ validated Blender shader node types
Complexity LevelsLow, Medium, High -- controls node tree depth and detail
Blender Version4.2 or later
DependenciesZero -- pure Python addon with no external packages required

How It Works

The addon enriches your description with context about Blender's node system, sends it to the configured LLM, validates the returned JSON against known node types and socket compatibility, then builds and auto-layouts the shader tree.

User describes material
    |
    v
Prompt enrichment (complexity, node constraints)
    |
    v
LLM generates JSON (node definitions + connections)
    |
    v
Node validation (type checking, socket matching)
    |
    v
Shader tree creation (bpy.data.node_groups)
    |
    v
Auto layout (even spacing, left-to-right flow)

Each step includes error handling. If the LLM produces an invalid node type or connection, the validator strips it and logs a warning rather than failing the entire generation.

Quick Start

Get your first AI-generated material in under five minutes:

  1. Install the addon zip in Blender.
  2. Configure a provider (Ollama is free and runs locally).
  3. Open the N-Panel, type a description, and click Generate.

See the Getting Started guide for detailed instructions.

Next Steps

  • Getting Started -- Install the addon and generate your first material
  • Providers -- Configure Ollama, OpenAI, or Anthropic
  • Presets -- Browse 50+ built-in material presets
  • Tweak Mode -- Modify existing materials with natural language
  • Node Reference -- All 30+ supported shader node types
  • API Reference -- Operators, properties, and preferences

API Reference

Transport modes, WebSocket protocol, configuration options, and extension points for the Godot MCP Server.

Getting Started

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

On this page

Feature OverviewHow It WorksQuick StartNext Steps