# Magic Building - Fantasy Universe Visual Generation

A comprehensive fantasy universe project designed for consistent visual generation using Gemini Flash Image (Nano Banana) through Claude Code and Nano-Banana-MCP integration.

## Project Status

### ✅ Completed Setup
- **Framework Files**: CLAUDE.md, PROJECT_STANDARDS.md
- **World Structure**: 7 worlds with descriptions and style guides
- **Core Locations**: 6 key locations with descriptions
- **Key Characters**: Main protagonists and antagonists
- **Essential Items**: Magical staffs and artifacts
- **Dangerous Creatures**: Boss-level threats

### 📋 Entities Created

#### Worlds (7/7)
- Modern World
- Winter World  
- Giant Snails World
- Kurnog World
- Skeleton World
- Twilight World
- Camelot World

#### Locations (6/6)
- Gronin (modern city)
- Source Castle
- Guardian Library
- Abandoned Building
- Quantum Lab Geneva
- Academy Town Geneva

#### Sample Heroes (4/16)
- Dan (13 yo boy)
- Nick (14 yo boy)
- Camelot (54 yo, Chief Mage)
- Eliot (18 yo, mage, son of Camelot)
- Konstantin (54 yo, quantum physicist)

#### Sample Items (2/9)
- Camelot Staff (high mage staff with green crystal)
- Mystical Staff (ultimate power, minimalist design)

#### Sample Creatures (2/11)
- Skeleton Spider (10m height, extremely dangerous)
- Ice Dragon (ice plasma breath)

## Quick Start Guide

### 1. Installation
Ensure you have:
- Claude Code installed
- Nano-Banana-MCP configured: https://github.com/ConechoAI/Nano-Banana-MCP
- Access to Gemini Flash Image API

### 2. Usage Examples

Generate a character in a location:
```
Generate Archmage Camelot standing in the Central Square of Grenoble
```

Create character with item:
```
Show Eliot wielding the Mystical Staff in the Guardian Library
```

Battle scene:
```
Create Camelot fighting the Skeleton Spider in the Abandoned Building
```

### 3. How It Works

1. **Claude Code parses** your request for entities
2. **Auto-gathers context** from description files and cross-references  
3. **Builds comprehensive prompt** following Nano Banana best practices
4. **Generates 3-4 variants** using optimized prompting
5. **Filters and presents** 2 best options
6. **Iterates until approval** with prompt refinement
7. **Archives successful** prompts and images

### 4. Entity Relationship System

Entities are linked using standardized syntax:
- `[Character:name]` - Links to characters
- `[Location:name]` - Links to locations  
- `[World:name]` - Links to worlds
- `[Item:name]` - Links to items
- `[Creature:name]` - Links to creatures

Examples:
- `[Character:camelot] (father of this character)`
- `[Item:mystical-staff] (can be wielded by this character)`
- `[Creature:ice-dragon] (defeated by this character)`

## Completion Instructions

### Remaining Work
See `ENTITIES_CHECKLIST.md` for complete list of entities to create.

### Quick Creation Commands
```bash
# Create remaining heroes (12 more)
# Create remaining items (7 more)  
# Create remaining creatures (9 more)
```

### File Templates
Use the templates in `ENTITIES_CHECKLIST.md` for consistent entity creation.

## Visual Style Guidelines

### Core Principles
- **Photorealistic fantasy** with cinematic quality
- **Rich, saturated colors** with dramatic lighting
- **Professional composition** following photography principles
- **World-specific consistency** in style and palette

### Image Specifications
- **Resolution**: 1024x1024 minimum
- **Formats**: PNG for finals, JPEG for iterations
- **Aspect Ratios**: 3:4 portraits, 16:9 landscapes, 2:1 cinematic

## Advanced Features

### Cross-Reference Resolution
- Automatic loading of linked entities
- Relationship context in prompts  
- Combat history integration
- Item-character compatibility checks

### Iterative Improvement
- Quality filtering based on consistency
- Failure analysis and prompt refinement
- Pattern recognition from successful generations
- Archived prompt reuse

### Batch Processing
- Multiple related generations
- Context continuity across images
- Metadata updates in batches

## Support

### Framework Files
- `CLAUDE.md` - Complete usage framework
- `PROJECT_STANDARDS.md` - Quality and style requirements
- `ENTITIES_CHECKLIST.md` - Remaining work and templates

### Troubleshooting
- Check entity file existence before generation
- Verify cross-references resolve correctly
- Ensure world style guides are properly linked
- Review archived prompts for pattern guidance

---

**Ready to create stunning, consistent fantasy visuals!** 🎨✨

Start with: `"Generate Camelot casting a spell in the Central Square of Grenoble"`