🖥️ ft_transcendance (Windows XPong) 🖥️

A nostalgic web-based multiplayer Pong game with modern features

🚀 Welcome to ft_transcendance!

This project is the culmination of the 42 school common core, a feature-rich multiplayer Pong game with real-time chat, user profiles, and tournament systems - all wrapped in a delightful Windows XP inspired interface.

---

📋 Table of Contents

• 🔍 Overview
• ✨ Features
• 💻 Installation
• 🎮 How to Play
• 🧩 Technologies
• 🛠️ Configuration
• 👥 Team
• ❓ FAQ

---

🔍 Overview

ft_transcendance transforms the classic Pong game into a modern web application. We've built it using NestJS for the backend, with a PostgreSQL database, and a responsive frontend - all containerized with Docker for easy deployment.

✨ Features

🪟 Windows XP Interface System

Our application recreates the nostalgic Windows XP experience with:

• Authentic Desktop Environment - Complete with start menu, taskbar, and desktop icons

• Window Management - Drag, resize, minimize, and close windows just like the classic OS

• Start Menu Navigation - Access all game features through the iconic Windows XP start menu

• System Notifications - Receive alerts through authentic XP-style notification bubbles

• Visual Authenticity - Carefully recreated XP visual elements including buttons, windows, and cursors

Windows XPong in action - Experience the nostalgic XP interface with modern web technologies

🎮 Game Features

• Real-time Pong Gameplay - Experience smooth, responsive gameplay
• Ranked Mode - Climb the competitive ladder with skill-based matchmaking
• AI Opponents - Challenge our neural network powered AI with adaptive difficulty

• Tournaments - Compete in organized tournaments

👤 User Features

• User Authentication - Secure login and registration, password and username changing

• Profile Customization - Customize your avatar and wallpaper

💬 Social Features

• Game Stats - Watch your games history with stats

• Friend System - Add friends and challenge them to matches

💻 Installation

# Clone the repository
git clone https://github.com/Axiaaa/ft_transcendance.git

# Navigate to project directory
cd ft_transcendance

# Copy the example file
cp .env_example .env

# Edit with your preferred text editor
nano .env

# Start the application using Docker Compose
make

Then visit https://localhost:443 in your browser!

🎮 How to Play

1. Create an Account - Sign up or login through OAuth
2. Find a Match - Use quick play or challenge a friend
3. Play the Game - Control your paddle with mouse or keyboard

🧩 Technologies

NodeJS Backend Runtime	TypeScript Frontend Language	BabylonJS 3D Game Engine
SQLite Database	Docker Containerization	Docker Compose Container Orchestration

Our tech stack is designed for performance and ease of deployment

🛠️ Configuration

The application can be configured through environment variables in the .env file:

1. Create your environment file:

   # Copy the example file
   cp .env_example .env
   
   # Edit with your preferred text editor
   nano .env

2. Customize your configuration: For security reasons, we strongly recommend changing the following values:

   • ELASTIC_PASSWORD and KIBANA_PASSWORD
   • ENCRYPTION_KEY
   • GRAFANA_USER and GRAFANA_PASSWORD
   • API_USERNAME and API_PASSWORD
   • DISCORD_WEBHOOK_URL (if you wish to receive notifications)

👥 Team

This project was created with love by:

Our Development Team

Jcuzin 🖥️ Windows XP UI/UX Designer	Lcamerly 🛠️ Backend & DevOps	Aammirat 🔒 Cybersecurity and API Integration
Mcourbon 🎮 Pong Game & Tournament Designer	Yallo 🤖 AI Opponent & Optimization

Our team worked together to bring this Windows XP nostalgia to life!

❓ FAQ

Q: Is my data secure?
A: Yes! We use industry-standard encryption for security.

Q: Can I play on mobile?
A: Absolutely! Our responsive design works on all devices.

Q: How is matchmaking determined?
A: Players are matched based on skill level determined by win/loss ratios.

---

© 2023 ft_transcendance Team | GitHub Repository

You've just experienced a blast from the past with our Windows XP-themed README!