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

# 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"