⚡ CyberQuest — 3D Cybersecurity Awareness Platform

A fully offline, browser-based 3D cybersecurity awareness gaming website for students. Learn real-world cyber defense skills through immersive gameplay, quizzes and simulations.

---

🚀 How to Run (No Server Needed!)

1. Download / Extract the CyberQuest folder anywhere on your computer
2. Open index.html in any modern browser (Chrome, Edge, Firefox)
3. Register a new account and enter the 3D CyberCity!

✅ Works 100% offline — no internet, no server, no installation required. ✅ All progress saved locally in your browser (localStorage).

---

📁 File Structure

CyberQuest/
├── index.html          ← Landing & Login page
├── world.html          ← 3D CyberCity (main game world)
├── dashboard.html      ← Player profile, badges & leaderboard
├── css/
│   ├── style.css       ← Global design system
│   ├── world.css       ← 3D world HUD styles
│   └── games.css       ← All game module styles
├── js/
│   ├── utils.js        ← Shared utilities (toast, modal, confetti)
│   ├── auth.js         ← Login/register (localStorage)
│   ├── rewards.js      ← XP, levels, badges, streaks
│   ├── world.js        ← Three.js 3D engine
│   ├── game-alex.js    ← 📖 Alex's Story (Story simulation)
│   ├── game-password.js← 🔐 Password Fortress
│   ├── game-phishing.js← 🎣 Phishing Lake
│   ├── game-malware.js ← 🌀 Malware Maze
│   ├── game-social.js  ← 🔒 Social Media Shield
│   └── game-hero.js    ← 🦸 CyberHero HQ (Final Challenge)
└── README.md

---

🎮 Game Modules

Module	Topic	XP	Skills Taught
📖 Alex's Story	Social Engineering	+50 XP	Overconfidence, phishing awareness, consequences
🔐 Password Fortress	Password Security	+75 XP	Strong passwords, unique passwords, 2FA
🎣 Phishing Lake	Phishing Detection	+75 XP	Email analysis, fake domains, urgency tactics
🌀 Malware Maze	Safe Browsing	+75 XP	Public WiFi, malware, pop-up scams
🔒 Social Shield	Privacy	+75 XP	Personal info, privacy settings, catfishing
🦸 CyberHero HQ	Final Challenge	+150 XP	15 questions across all topics

---

🏆 Reward System

Levels

Level	XP Required	Title
🐣	0–199 XP	Noob
👀	200–499 XP	Aware
🛡️	500–999 XP	Guardian
⚔️	1000–1999 XP	Defender
🦸	2000+ XP	CyberHero

Badges

• 👣 First Step — First login
• 👁️ Awakened — Completed Alex's Story
• 🔐 Password Pro — Aced Password Fortress
• 🎣 Phish Detector — Caught all phishing emails
• 🦅 Eagle Eye — Perfect score on Phishing Lake
• 🌀 Maze Runner — Escaped Malware Maze
• 🔒 Privacy Guard — Secured social media profile
• 🦸 CyberHero — Completed ALL modules!
• 🔥 On Fire! — 3-day login streak
• ⚡ Week Warrior — 7-day login streak
• 🧘 Cyber Monk — 30-day login streak

---

🌍 3D World Controls

Control	Action
🖱️ Drag	Rotate camera around CyberCity
🖱️ Scroll	Zoom in / out
🖱️ Click Building	Enter that game module
📱 Touch drag	Rotate on mobile

---

🛡️ Key Cybersecurity Topics Covered

1. Password Security — Strength, uniqueness, password managers, 2FA
2. Phishing — Email analysis, fake domains, urgency manipulation
3. Social Engineering — Overconfidence, psychological manipulation
4. Public WiFi Risks — Man-in-the-middle attacks, VPN usage
5. Malware & Safe Downloads — Official sources, file scanning, pop-up scams
6. Social Media Privacy — Personal info exposure, catfishing, oversharing
7. OTP & 2FA — Never share OTPs, SIM swapping awareness
8. Cybercrime Reporting — cybercrime.gov.in, helpline 1930

---

🔧 Technology Stack

• HTML5 — Structure
• CSS3 — Glassmorphism design, animations
• JavaScript (ES6+) — All game logic
• Three.js r128 — 3D world rendering (loaded from CDN)
• localStorage — User data, progress, streaks

---

📞 Cybercrime Help (India)

• 🌐 Portal: cybercrime.gov.in
• 📞 Helpline: 1930
• 🚔 For emergencies: Contact local police station

---

Built for cybersecurity awareness education. Share with students, schools, and colleges!