Skip to content

README.md

Latest commit

 

History

History
222 lines (153 loc) · 5.39 KB

README.md

File metadata and controls

222 lines (153 loc) · 5.39 KB

ZeroTrace ZeroTrace CI

Status Platform Backend Frontend
Upload TerminalUI MIT Version License
ZerroTrace_github
image

  • ZeroTrace ist ein webbasiertes Hacker-Simulationsspiel mit:

  • Terminaloberfläche

  • Missionssystem

  • Toolfreischaltungen

  • Datei-Upload



🔧 Features

  • 🎮 Terminalbasierte Interaktion
  • 🧠 Missionslogik & Toolfreischaltung mit Levelsystem
  • 📦 Echter Datei-Upload via Node.js + Multer (inkl. Speichern)
  • 🕵️‍♂️ Tools wie ddosSim, passCrack, logParse, stegoFind
  • ⚡ Reputation- & Level-Anzeige
  • 🌐 Browserbasiert – keine Installation nötig (nur einmaliger Setup)
  • 🧩 Erweiterbar durch externe Missionen (missions.js)


📁 Projektstruktur

ZeroTrace/
├── assets/sounds
│          ├── altert.wav
│
├── data/sites
│   │    ├── darknet.html.html
│   │    ├── gov-portal.html
│   │    ├── nexuscorp.html
│   │
│   ├── coreEngine.js
│   ├── server.js
│   ├── missions.js
│
├── js
│   ├── coreEngine.js
│
├── node_modules
│
├── style/
│   └── terminal.css
│
├── uploads/
│   ├── ──<             < ┐
│                         │
├── index.html            │
├── package.json          │
├── server.js             │
├── ServerStart.bat       │
└── upload.log ── ── ── ─ ┘
    └──(Automatic process - Tools </> uploadFile)


⚙️ Systemvoraussetzungen

  • Node.js (empfohlen: ≥ 18.x)
  • Python (für lokalen Webserver – optional über Batch)
  • npm für Paketverwaltung


📦 Abhängigkeiten

Installiere die Server-Komponenten im Projektverzeichnis:

npm install express multer cors
Paket Zweck
express Webserver-Framework
multer Datei-Upload-Verarbeitung
cors Cross-Origin-Kommunikation


🚀 Startanleitung

  • Projekt klonen:
git clone https://github.com/DEIN-GITHUB-NAME/ZeroTrace.git
cd ZeroTrace

Abhängigkeiten installieren:

npm install

Frontend & Backend starten:

  • Variante A: Über Batch-Datei
    • (Doppelklick auf ServerStart.bat)

Variante B: Manuell

  • Starte Frontend (Port 8000)

    • python -m http.server 8000

  • Starte Backend (Port 8080)

    • node server.js

Spiel öffnen im Browser:

http://localhost:8000


🧪 Spielstart & Befehle

  • Nach dem Öffnen der Seite, nutze folgende Kommandos im Terminal:
Befehl Funktion
run Startet das Spiel + zeigt die Netzwerk-Map
help Zeigt alle verfügbaren Befehle
clear Leert die Terminal-Ausgabe
unlock [tool] Schaltet ein Tool frei (nach Passwortabfrage)
uploadFile Startet den Datei-Upload (nach Freischaltung)
ddosSim Simuliert einen DDoS-Angriff
passCrack Simuliert das Knacken eines Passworts
logParse Analysiert Logdateien nach Sicherheitsereignissen
stegoFind Führt eine Steganografie-Analyse auf Bildern aus
showMap Zeigt das Netzwerk-Overlay (Quickref) 
bylickilabs


🎨 Optional: Branding

  • favicon.ico im Hauptverzeichnis platzieren (optional)
    • Alternativ: Neon-Hacker-Logo verwenden


🔐 Sicherheitshinweis Dieses Projekt ist rein simulativ und dient ausschließlich der Visualisierung von IT-Szenarien. Es enthält keine echten Hacking-Funktionen, sondern ist ein didaktisches Tool zur Veranschaulichung.



📜 Lizenz MIT License LICENSE



Entwickelt von Thorsten Bylicki powered by ✨BylickiLabs