162 lines
4.5 KiB
Markdown
162 lines
4.5 KiB
Markdown
# 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"` |