Oleg Proskurin
5e8f8c8a6d
|
||
|---|---|---|
| .claude/commands | ||
| cities | ||
| creatures | ||
| docs | ||
| generated_imgs | ||
| heroes | ||
| items | ||
| locations | ||
| logs | ||
| prepared_prompts | ||
| settings | ||
| src | ||
| worlds | ||
| .env | ||
| .gitignore | ||
| .mcp.json | ||
| CLAUDE.md | ||
| ENTITIES_CHECKLIST.md | ||
| PROJECT_STANDARDS.md | ||
| README.md | ||
| SETTINGS_GUIDE.md | ||
| package.json | ||
| pnpm-lock.yaml | ||
| test-api.sh | ||
| tsconfig.json | ||
README.md
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
- Claude Code parses your request for entities
- Auto-gathers context from description files and cross-references
- Builds comprehensive prompt following Nano Banana best practices
- Generates 3-4 variants using optimized prompting
- Filters and presents 2 best options
- Iterates until approval with prompt refinement
- 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
# 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 frameworkPROJECT_STANDARDS.md- Quality and style requirementsENTITIES_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"