🎄 Ded Moroz Escape: Tel Aviv Lockdown

An interactive, dual-language mobile AR escape room where players must solve riddles, navigate their environment, and physically fight off viruses to save a kidnapped Santa.

🎮 Play the Game

Live Game: Ded Moroz Escape (Note: Works best on mobile)

Disclaimer: This was originally developed as a private project and New Year's game for family. The live link is open for anyone to play, but the physical presents at the end are no longer being restocked!

📖 Context & Story

The premise is simple: I (Danielle) have kidnapped Ded Moroz (Santa). To save him, the player is guided by a desperate, captive Santa-AI through a sequence of interactive, real-world puzzles. Success means freeing Santa and unlocking a pre-hidden present in the player's fridge (or automatically firing off an angry WhatsApp message demanding a coupon).

🗺️ Escape Room Workflow

The game utilizes a mix of cryptography, AR, geolocation, and computer vision. For every puzzle solved, the player receives a key. These keys must be decoded at the end to win.

1. The Kidnapping: The game opens with a video sequence establishing the kidnapping.
2. Sensory Riddle: A word puzzle associated with the scent of the New Year (Answer: Tangerine).
3. AR Snowflake Hunt: Players use their device's camera to collect augmented reality snowflakes scattered in their immediate environment.
4. Geolocation Navigation: A digital compass guides the player to a specific set of coordinates. The player must memorise their longitude and latitude.
5. Coordinate Math: A math puzzle requiring the user to sum up the values of their latitude.
6. The Dance of Warmth: Players record themselves doing a specific dance to "warm up." The app processes this and returns a video with a music overlay.
7. Snowfrost CVE (Camera Kickboxing): A physical combat challenge. A virus appears on screen, and the player must physically punch it 5 times. Particles track and follow the user's hand movements via the camera.
8. Decryption: The user plugs in all collected keys to decode the final lock.
9. The Sky Portal: Players point their camera at the sky to watch an AR Santa fly away, leaving presents in a "snow portal" (the player's physical fridge).
10. The Fallback: If the fridge is empty, the app triggers an automated WhatsApp message demanding their present.

🛠️ Technical Features

• Augmented Reality (AR): Environmental mapping for object collection (snowflakes) and sky-anchored animations.
• Computer Vision / Motion Tracking: Hand-tracking for the Snowfrost CVE kickboxing mini-game.
• Geolocation: Real-time compass and coordinate tracking.
• Media Processing: Audio/Video overlay generation for player recordings.
• Dual-Language Support: English and Russian.

🚀 Run Locally

Prerequisites: Node.js (v18+ recommended)

1. Clone the repository:

   git clone [https://github.com/ladyFaye1998/SOS-Santa-Is-Missing.git](https://github.com/ladyFaye1998/-SOS-Santa-Is-Missing.git)
   cd -SOS-Santa-Is-Missing

2. Install dependencies:

   npm install

3. Environment Setup: Create a .env.local file in the root directory and add your Gemini API key:

   GEMINI_API_KEY=your_gemini_api_key_here

4. Run the development server:

   npm run dev

🏆 Credits & Acknowledgements

• AR Santa: The augmented reality Santa model and animation utilized in the Sky Portal sequence is credited to Niantic 8th Wall.

---

🤝 Let's Build a Story Together

Have a unique idea for a gamified experience, a private AR event, or a narrative-driven marketing campaign? I'm open to collaborations, custom project orders, and creative partnerships.

• Concept Design: Custom AR scavenger hunts or interactive storytelling.
• Technical Execution: AR/VR, Computer Vision, and Geolocation-based apps.
• Pricing & Collabs: Open to discussing project-based rates or creative joint ventures.

Interested? Let's talk about building something immersive. Reach out via a GitHub issue or DM me to start a conversation!