# Blender Script Repository
This repository contains AI-generated Blender Python scripts for creating 3D models. These scripts are designed to work seamlessly with the Robotics MCP server's Blender integration.
## 📁 Directory Structure
```
scripts/
├── index.json # Script catalog and metadata
├── robots/ # Robot models and components
├── architecture/ # Buildings and structures
├── tools/ # Modeling utilities
├── environments/ # Terrain and environmental models
└── README.md # This file
```
## 🤖 Script Categories
### Robots
- **moorebot_scout.py**: Complete Moorebot Scout robot with mecanum wheels
- **robby_forbidden_planet.py**: Classic Robby robot from Forbidden Planet film
- **robodog_black_mirror.py**: Terrifying quadrupedal killer robot from Black Mirror Metalhead
- **gort_day_earth_stood_still.py**: Iconic Gort robot from The Day the Earth Stood Still
- **b9_lost_in_space.py**: Friendly B-9 robot from Lost in Space TV series
- **r2d2_star_wars.py**: Iconic R2-D2 astromech droid from Star Wars
- **c3po_star_wars.py**: Protocol droid C-3PO from Star Wars
- **batmobile_1960s.py**: Iconic 1966 Batmobile from Batman TV series
- **kitoh_abomination.py**: Terrifying robotic abomination inspired by Mohiro Kitoh manga
- **iron_giant.py**: Beloved Iron Giant robot from the 1999 animated film
- Future: Unitree Go2, Boston Dynamics Spot, custom robot designs
### Architecture
- **hohensalzburg_fortress.py**: Medieval castle model of Hohensalzburg Fortress
- **fallingwater_house.py**: Frank Lloyd Wright's Fallingwater house (North by Northwest)
- **white_heron_castle.py**: UNESCO World Heritage Site - Himeji Castle (White Heron Castle)
- Future: More historical and modern architectural wonders
### Tools
- Modeling utilities, procedural generation scripts
### Environments
- Terrain generation, environmental models for simulation
## 🚀 Usage with Robotics MCP
### List Available Scripts
```python
# Via MCP tool
await list_blender_scripts()
# Returns: {"robots": ["moorebot_scout"], "architecture": [], ...}
```
### Execute Repository Script
```python
# Via MCP tool
await execute_repository_script(
category="robots",
script_name="moorebot_scout",
output_path="D:/models/scout.fbx",
parameters={"dimensions": {"length": 0.15, "width": 0.12}}
)
```
### Direct Script Execution
```python
# Load and execute script directly
script_path = "scripts/robots/moorebot_scout.py"
with open(script_path, 'r') as f:
script = f.read()
await robot_model(
operation="execute_script",
script=script,
output_path="D:/models/scout.fbx"
)
```
## 📝 Script Metadata Format
Each script includes metadata in the file header:
```python
"""
Script Name and Description
Generated by [AI Model]
[Full description of what the script creates]
Author: [AI Model or Human]
Category: [robots|architecture|tools|environments]
Tags: [comma-separated tags]
Dimensions: [physical dimensions if applicable]
Complexity: [simple|medium|complex]
"""
# Script code follows...
```
## 🤖 AI Script Generation
Scripts are primarily generated using AI models like Gemini. To contribute:
1. **Generate Script**: Ask AI to create Blender Python script for desired model
2. **Test Script**: Execute in Blender to verify it works
3. **Add Metadata**: Include proper docstring with all metadata fields
4. **Update Index**: Add entry to `index.json` with script information
5. **Document**: Update this README if adding new categories
## 🎯 Script Standards
### Naming Convention
- Use snake_case for filenames: `moorebot_scout.py`
- Use PascalCase for Blender object names: `Scout_Body`
### Documentation
- Include comprehensive docstring with all metadata
- Comment complex sections of code
- Include parameter descriptions
### Compatibility
- Target Blender 3.0+ (latest LTS)
- Use standard bpy.ops operations
- Include proper error handling where applicable
- Support parameterized dimensions when possible
### Categories and Tags
- **robots**: wheeled, legged, manipulators, drones
- **architecture**: medieval, modern, industrial, residential
- **tools**: utilities, generators, modifiers
- **environments**: terrain, vegetation, weather
## 🔧 Integration with MCP Tools
The repository integrates with existing MCP tools:
- `robot_model(operation="list_scripts")` - List all available scripts
- `robot_model(operation="execute_repository_script")` - Execute script from repository
- `create_moorebot_scout()` - Direct tool for Scout model creation
## 📊 Statistics
- **Total Scripts**: 13
- **Categories**: 4 (robots, architecture, tools, environments)
- **AI Models**: Gemini, Grok
- **Last Updated**: 2026-01-19
## 🤝 Contributing
1. Generate AI script for desired model
2. Test thoroughly in Blender
3. Add to appropriate category directory
4. Update `index.json` with metadata
5. Submit PR with script and index updates
The repository grows with each contribution, building a comprehensive library of AI-generated 3D modeling scripts!
