EdVerse - Educational Metaverse A next-generation, photorealistic, interactive 3D campus experience for Princeton University, designed for educational, social, and immersive exploration. EdVerse uses cutting-edge AI, real-time avatars, and robust controls to deliver a seamless educational metaverse you can walk through and interact in—right from your browser.

🚀 Features Street-Level Walk Mode: By default, launch at street level with a 3D Princeton-clothed avatar. WASD keyboard controls allow you to walk, turn, and navigate the real campus with realistic, animated movement.

Third-Person Camera System: Smooth camera follows your avatar at street level for a highly immersive third-person experience.

Walk/Fly Toggle: Instantly switch between street-level walking and aerial bird’s eye view using a prominent toggle UI.

Real-Time Avatar Generation: Avatars are personalized using natural language prompts via Google Gemini AI. Features include customizable skin tone, hair, clothing, accessories, and Princeton branding.

Reliable Fallbacks: If AI fails, users instantly receive a default Princeton avatar—ensuring access for all, without blockers.

Visual Keyboard Guide: On-screen indicators display WASD controls in Walk Mode for ease of navigation.

Real-Time Social Features: Add, invite, and chat with friends (‘Princetonians’) using real-time multiplayer tools. Notifications and chat update instantly.

Figma: UI and design prototyping.

Three.js: High-performance 3D rendering and animation.

React (TypeScript, Vite): Component-driven interface, state management, and logic.

Google Gemini AI: Avatar generation and prompt enhancement (Gemini 2.0 Flash, JSON specifications).

Supabase: Real-time backend for chat, friend system, and multiplayer state sync.

Custom Components:

WASDWalkingControls: Keyboard navigation handler for avatar.

ThirdPersonCamera: Camera follow system.

CustomizableAvatar: Renders AI-generated avatar specs.

DefaultAvatar: Princeton-themed avatar fallback.

FriendRequest, PrincetoniansTab, Toaster: Real-time UI/social modules.

👩‍💻 Getting Started : Clone the repository.

Make sure your environment variables for Gemini and Supabase are set.

npm install npm run dev.

Sign up and describe your avatar—Gemini creates it instantly.

Explore Princeton, invite friends, and start chats in the campus metaverse!