Content
# Tool List
AI-driven Blender 3D modeling Skill that generates production-grade 3D assets through natural language descriptions.
---
## Quick Start
```bash
/blender-model-generator "A wooden table"
```
**First-time use** will automatically detect the environment and guide you through setup (approximately 5 minutes).
---
## Features
- 🎯 **Natural Language Modeling** - Use descriptions instead of manual modeling
- 🤖 **Multi-Agent Collaboration** - 5 specialized agents work together
- 👀 **Real-time Visualization** - See the modeling process in the Blender GUI
- 📦 **Complete Output** - Model + Animation + Materials + Documentation + Integration Guide
- 🎮 **Platform Compatibility** - Supports Unity, Unreal, Three.js
---
## Usage Examples
```bash
# Simple Model
/blender-model-generator "A wooden table"
# With Animation
/blender-model-generator "Office chair that can rotate and adjust height"
# Game Asset
/blender-model-generator "Treasure chest with switch animation" --type game --target unity
# Digital Twin
/blender-model-generator "Charging pile with status display and plug animation" --type digital-twin --target unity
```
---
## Installation and Setup
### Prerequisites
1. **Blender 3.0+**
2. **Python 3.10+**
3. **uv package manager**
### One-Click Setup
Running the skill will automatically detect the environment and guide you:
```bash
/blender-model-generator test
```
### Manual Setup (if automatic setup fails)
#### Step 1: Install uv
**Windows:**
```powershell
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
```
**Mac:**
```bash
brew install uv
```
**Linux:**
```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```
⚠️ You must **restart your terminal** after installation.
#### Step 2: Add MCP Server
```bash
claude mcp add blender uvx blender-mcp
```
⚠️ You must **restart Claude Code** after configuration.
#### Step 3: Install Blender Plugin
1. Open Blender
2. Edit → Preferences → Add-ons
3. Click "Install..." and select `addon.py`
4. Enable "Interface: Blender MCP"
#### Step 4: Launch Connection
1. Press `N` in Blender to open the sidebar
2. Switch to the "BlenderMCP" tab
3. Click "Connect to Claude"
4. See "Server running" for success
✅ After completion, re-run the skill!
---
## Output Content
The generated asset package contains:
```
AssetName_Package/
├── models/
│ ├── asset.blend # Blender source file
│ ├── asset.fbx # Exported model (Unity/Unreal)
│ └── previews/ # Multi-angle preview images
├── scripts/
│ ├── blocking_model.py # Concept script
│ └── production_model.py # Production script (reproducible)
└── documentation/
├── api_spec.json # API specification
└── integration_guide.md # Platform integration guide
```
---
## Troubleshooting
### Error: "Failed to connect to Blender"
✓ Check if Blender is open
✓ Check if the plugin is enabled
✓ Check if you clicked "Connect to Claude"
✓ Try restarting Blender
### Error: "uvx command not found"
✓ Confirm uv is installed
✓ Restart your terminal
✓ Check environment variable PATH on Windows
### Error: "MCP tool unavailable"
```bash
# Add MCP server
claude mcp add blender uvx blender-mcp
# Restart Claude Code
```
---
## Technical Architecture
```
Claude Code (Skill)
↓ Using MCP Tools
BlenderMCP Server (uvx blender-mcp)
↓ Socket connection (localhost:9876)
Blender Addon (GUI mode)
↓ bpy API real-time execution
Blender window ← Real-time user visibility!
```
---
## Multi-Agent Workflow
1. **Demand Analyst** - Analyze demands, search for reference images, and generate technical specifications
2. **Concept Designer** - Create design schemes and blocking models
3. **Technical Reviewer** - Verify structure and functional requirements
4. **Asset Builder** - Generate complete models, animations, and materials
5. **Quality Assurance** - Test, generate documentation, and integration guides
---
## Applicable Scenarios
### ✅ Suitable
- Industrial equipment (charging piles, ATMs, vending machines)
- Furniture (tables, chairs, cabinets, beds)
- Game props (treasure chests, weapons, tools)
- Architectural elements (doors, windows, stairs)
### ❌ Not Suitable
- Complex organic models (characters, animals)
- Highly artistic shapes
- Models requiring fine carving
---
## File Description
- **SKILL.md** - Skill main file (AI reading)
- **README.md** - This file (user documentation)
- **addon.py** - Blender plugin file
- **references/** - Code templates and schema definitions
- **SKILL.md** - Skill main file (AI reading)
- **README.md** - This file (user documentation)
- **references/** - Code templates and schema definitions
- **addon.py** - Blender plugin file
---
## Effects
## License
- **BlenderMCP**: See `ahujasid/blender-mcp`
- **Skill code**: MIT License
**Contribution**: BlenderMCP created by [Siddharth Ahuja](https://github.com/ahujasid)
---
**Start creating your first 3D model!** 🚀
```bash
/blender-model-generator "Your model description"
```
