# TwinCity

**Mixed Reality Digital Twin city simulation**  
Developed as part of the course *Design for Complex and Dynamic Contexts (DCDC)* at Stockholm University (SU), Spring 2025.

---

## 📍 Overview

**TwinCity** is an experimental Mixed Reality (MR) platform that overlays a real-time 3D model of a city using Unity, Cesium for Unity, and Google Photorealistic 3D Tiles. The system serves as a collaborative emergency response environment, enabling users to explore, simulate disasters, and coordinate interventions inside a Digital Twin of a real-world location.

This project was developed by a four-person team at SU to explore concepts of:
- Mixed Reality spatial interfaces
- Collaborative interaction and role-based interdependence
- Digital Twins as real-time responsive environments

---

## 🔧 Technologies Used

- **Unity 6 LTS**
- **Cesium for Unity**
- **Google Maps 3D Tiles API**
- **Meta XR SDK** (Passthrough + Hand Tracking)
- **Photon Fusion** (Multiplayer Framework)
- **Visual Studio Code + GitHub**

---

## 🧪 Features (in development)

- ✅ 3D photorealistic Digital Twin city rendered in Unity  
- ✅ Flood simulation using water plane or visual overlays  
- ✅ MR interface with gesture-based navigation  
- 🔄 Multiplayer interaction for emergency response roles  
- 🔄 Visual indicators and alerts for dynamic events  
- 🔄 Subscene placement and collision-aware environment

---

## 🎮 How to Run

> Requires Unity 6 LTS and Cesium for Unity setup.

1. Clone the repo: ```git clone https://github.com/<your-username>/twincity.git```
2. Open in **Unity 6**
3. Sign in to your **Cesium account**
4. Enter your **Google Maps API key** to load 3D tiles
5. Enter Play Mode

---

## 👥 Team

- **Andreas** – Backend, Unity architecture, repo management  
- **Eman** – UI/UX design, Figma mockups, portfolio materials
- **Florian** – Lead Unity implementation, Cesium integration  
- **Minhui** – Interaction design, XR design, Documentation, Testing, and Research

---

## 📁 License

This project is open source under the [MIT License](LICENSE).

---

## 💡 Acknowledgments

- Cesium for Unity: [https://cesium.com/unity](https://cesium.com/unity)  
- Google Maps Photorealistic Tiles  
- Original concept inspiration: [YouTube Video](https://www.youtube.com/watch?v=lLw5hCqSv5Y)