https://github.com/nimo94/netbreach
Welcome to Netbreach! An immersive cybersecurity hacking simulation game powered by AI behavioral profiling. Put your skills to the test and see if you can outsmart a predictive defense system that learns how you play.
https://github.com/nimo94/netbreach
game hacking simulation whitehead
Last synced: about 11 hours ago
JSON representation
Welcome to Netbreach! An immersive cybersecurity hacking simulation game powered by AI behavioral profiling. Put your skills to the test and see if you can outsmart a predictive defense system that learns how you play.
- Host: GitHub
- URL: https://github.com/nimo94/netbreach
- Owner: nimo94
- Created: 2026-06-05T09:32:45.000Z (28 days ago)
- Default Branch: main
- Last Pushed: 2026-06-20T19:51:23.000Z (12 days ago)
- Last Synced: 2026-06-20T21:21:27.462Z (12 days ago)
- Topics: game, hacking, simulation, whitehead
- Language: TypeScript
- Homepage: https://netbreach-game.web.app
- Size: 604 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Netbreach
Welcome to **Netbreach**! An immersive cybersecurity hacking simulation game powered by AI behavioral profiling. Put your skills to the test and see if you can outsmart a predictive defense system that learns how you play.
**Play the game online:** [https://netbreach-game.web.app](https://netbreach-game.web.app)
---
## 🎮 How to Play
1. **Reconnaissance:** Start by gathering intel on your target.
- Use `nslookup` to resolve domains to IP addresses.
- Run `nmap` (e.g., `nmap -sS -Pn `) to find open ports and discover CVE vulnerabilities.
- Use `gobuster` (e.g., `gobuster dir -u http:// -w common.txt`) to find hidden directories.
2. **Infiltration:** Exploit vulnerabilities to gain access.
- Use `./exploit.py --rhost --cve ` to execute payloads.
- Look for misconfigurations using `curl` to find `.env` files.
3. **Complete the Mission:** Accomplish the specific objective given in your dashboard.
- **Exfiltration:** Find backup files and download them (`wget` or `scp`).
- **Defacement:** Overwrite the main website index (`ftp` + `put index.html`).
- **Database Wipe:** Access the database (`mysql -u root -p`) and drop the target tables.
4. **Cover Your Tracks:** Do not disconnect until you clean your logs!
- Run `shred -u /var/log/auth.log && history -c` to erase your footprint before the AI traces you.
### 🧠 Evade the AI
The neural network learns your patterns! If you get locked out, use utilities like `macchanger -r eth0` or `proxychains bash` to rotate your identity and reset the threat level.
---
## 💻 Interface & Features
- **Deep Lore & Mechanics:** Read the in-game documentation to understand the tools and countermeasures.
- **Account Settings & Progression:** Customize your hacker alias and save your progress.
---
## 🛠️ Local Environment Setup
To run this project locally, you will need Node.js, Python 3, Docker, and Firebase CLI installed.
### 1. Clone the Repository
```bash
git clone https://github.com//netbreach.git
cd netbreach
```
### 2. Frontend Setup (React/Vite)
Navigate to the `frontend` directory and set up the environment:
```bash
cd frontend
cp .env.example .env
```
Fill in the `.env` file with your own Firebase configuration keys.
Install dependencies and run the development server:
```bash
npm install
npm run dev
```
### 3. Backend Setup (Node/Express/Prisma)
Navigate to the `backend` directory:
```bash
cd ../backend
cp .env.example .env
```
Start up PostgreSQL and Redis using Docker Compose:
```bash
docker-compose up -d
```
Install dependencies and run database migrations:
```bash
npm install
npx prisma migrate dev
npm run dev
```
### 4. AI Service Setup (Python/FastAPI)
Navigate to the `ai-service` directory:
```bash
cd ../ai-service
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
uvicorn main:app --reload --port 8000
```
---
## 📦 Deployment
The frontend is configured to be deployed via Firebase Hosting:
```bash
cd frontend
npm run build
firebase deploy --only hosting
```
---
*This project is for educational and simulation purposes only. Do not use these tools against systems you do not own or have explicit permission to test.*