DoubleSnake Logo

DoubleSnake

Ein kooperatives Snake-Spiel für zwei Spieler, entwickelt mit Node.js, Express und Socket.IO.

📋 Projektübersicht

DoubleSnake ist eine moderne Interpretation des klassischen Snake-Spiels für zwei Spieler. Es ermöglicht Spielern, gemeinsam in Echtzeit zu spielen und Punkte zu sammeln. Das Spiel bietet ein Lobby-System zum Erstellen und Beitreten von Spielen sowie Benutzerkonten zur Spielerverwaltung.

🌟 Hauptfunktionen

  • Benutzerkonten-System: Registrierung, Anmeldung und Profilbearbeitung
  • Lobby-System: Erstellen und Beitreten von Spielen mit eindeutigen Codes
  • Echtzeit-Multiplayer: Simultanes Spielen mit einem Partner
  • Responsive Design: Optimiert für Desktop und mobile Geräte

🛠️ Technologien

  • Frontend: HTML, CSS, JavaScript
  • Backend: Node.js, Express
  • Echtzeit-Kommunikation: Socket.IO
  • Datenbank: MySQL2
  • Authentifizierung: Bcrypt, Express-Session

🚀 Installation

Voraussetzungen

  • Node.js (Version 18 oder höher)
  • MySQL Server

Schritte zur Installation

  1. Repository klonen

    git clone [https://github.com/yourusername/doubleSnake.git](https://github.com/yourusername/doubleSnake.git)
    cd doubleSnake
    
  2. Datenbank einrichten

    • Erstellen Sie eine MySQL-Datenbank mit dem Namen "doublesnake"
    • Importieren Sie die Datenbankstruktur aus der Datei doublesnake.sql
  3. Umgebungsvariablen konfigurieren Erstellen Sie eine .env-Datei im Backend-Verzeichnis mit folgenden Werten:

    SESSION_KEY=IhrGeheimesSessionKey
    PORT=3000
    DB_HOST=localhost
    DB_PORT=3306
    DB_PASSWORD=IhrDatenbankPasswort
    FRONTEND_PATH=../frontend
    
  4. Dependencies installieren

    cd backend
    npm install
    
  5. Server starten

    npm run dev
    # oder mit Nodemon
    npm run nm
    
  6. Anwendung öffnen Navigieren Sie zu http://localhost:3000 in Ihrem Browser

🐳 Docker-Installation

Das Projekt enthält eine Dockerfile für einfaches Deployment:

docker build -t doublesnake .
docker run -p 3000:3000 -e DB_HOST=your-db-host doublesnake

🎮 Spielablauf

  1. Registrieren Sie sich für ein Konto oder melden Sie sich an
  2. Navigieren Sie zum Dashboard und wählen Sie "Lobby"
  3. Erstellen Sie eine neue Lobby oder treten Sie einer bestehenden mit einem Code bei
  4. Teilen Sie den generierten Code mit einem Freund
  5. Sobald zwei Spieler verbunden sind, beginnt das Spiel automatisch
  6. Steuern Sie Ihre Schlange, sammeln Sie Punkte und vermeiden Sie Kollisionen

👨‍💻 Entwicklung

Das Projekt ist in folgende Hauptkomponenten unterteilt:

  • Server: Express und Socket.IO für HTTP- und Websocket-Kommunikation
  • Datenbank: Benutzerkonten und -daten
  • Lobby-System: Verwaltung von Spielräumen und Spielerzuordnung
  • Game-Engine: Kernspielfunktionalität und -logik

📄 Lizenz

Dieses Projekt steht unter der MIT-Lizenz. Weitere Details finden Sie in der LICENSE-Datei.

Description
Snake aber zu zweit!
Readme 74 MiB
Languages
JavaScript 66.1%
HTML 24.2%
CSS 9%
Dockerfile 0.7%