🔒 Cypher Security Game

An immersive, mobile-first 3D educational game designed to teach cybersecurity concepts in a localized, engaging environment.

📖 Overview

Cypher Security Game is an engaging 3D mobile adventure built with Unity. Set in a stylized, low-poly city and port environment, the game combines exploration, storytelling, and puzzle-solving to educate players on cybersecurity principles.

The experience is localized explicitly for Arabic-speaking audiences, featuring fully supported RTL (Right-to-Left) text, custom Arabic scripts, and culturally tailored character assets such as traditional Saudi Arabian attire.

✨ Key Features

• 📱 Mobile-First First-Person Experience: Smooth, dynamic first-person mechanical controls designed specifically for touch screens with screen orientation adjustments and interactive raycasting.
• 🔐 Cybersecurity Mechanics: Features in-game computer interfaces (Emails, Vaults), challenging users to uncover clues and learn security practices.
• 🌍 Full Arabic Localization: Powered by RTLTMPro and ArabicSupport, offering right-to-left text rendering to create a native narrative experience for the MENA region.
• 👤 User Authentication: Built-in backend integration utilizing Firebase (Login & Sign Up) to track progress across multiple mobile devices.
• 🎨 Stylized Art Direction: Beautifully crafted low-poly environments including cartoon cities, ports, interactive doors, fences, and a customized stylized water shader for the Universal Render Pipeline (URP).
• 📝 Narrative System: An immersive UI typewriter effect for storytelling that delivers lore and objectives dynamically to the player.

🛠️ Technology Stack & Assets

• Game Engine: Unity (Using URP)
• Programming Language: C#
• Backend & Auth: Firebase & Google External Dependency Manager
• 3D Assets & Plugins:
  • Modular First Person Controller
  • Cartoon Low Poly City Lite
  • PolygonPi & BrokenVector Environment Packs
  • RTL Text Mesh Pro (for Arabic formatting)
  • Custom .glb character models and dynamic animations

⚙️ Repository Structure

• Assets/Scripts/: Contains the core logic (e.g., InteractionManager, FirebaseLogin, StoryTeller, Email_Manager).
• Assets/Scenes/: Holds the playable levels and the main menu.
• Assets/Models/ & Assets/Prefab/: Core 3D structural elements and environments.
• Assets/Firebase/: Essential dependencies for user auth.
• Assets/RTLTMPro/ & Assets/ArabicSupport/: Packages for correct Arabic text rendering.

🚀 Getting Started

To get a local copy up and running, follow these steps.

Prerequisites

• Unity Hub and a compatible Unity Editor version (recommended 2022.3 LTS or later).
• Android Build Support or iOS Build Support modules installed.

Installation

1. Clone the repository:

   git clone https://github.com/your-username/cypher-security-game.git

2. Open the project in Unity:
   • Open Unity Hub.
   • Click on Open -> Add project from disk.
   • Select the cloned cypher-security-game directory.
3. Configure Firebase (Optional but Recommended):
   • Link your Unity Project to a Firebase project using the Firebase Console.
   • Drop the google-services.json (Android) / GoogleService-Info.plist (iOS) into the Assets folder.
   • Let the ExternalDependencyManager resolve Firebase plugins.
4. Play:
   • Navigate to Assets/Scenes/ and double-click the MainMenu scene.
   • Press Play in the editor.

🤝 Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the issues page.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.