{"id":51355510,"url":"https://github.com/nimo94/netbreach","last_synced_at":"2026-07-02T19:34:43.981Z","repository":{"id":366224152,"uuid":"1260236626","full_name":"nimo94/netbreach","owner":"nimo94","description":"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.","archived":false,"fork":false,"pushed_at":"2026-06-20T19:51:23.000Z","size":619,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-20T21:21:27.462Z","etag":null,"topics":["game","hacking","simulation","whitehead"],"latest_commit_sha":null,"homepage":"https://netbreach-game.web.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nimo94.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-05T09:32:45.000Z","updated_at":"2026-06-20T19:56:06.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/nimo94/netbreach","commit_stats":null,"previous_names":["nimo94/netbreach"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/nimo94/netbreach","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nimo94%2Fnetbreach","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nimo94%2Fnetbreach/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nimo94%2Fnetbreach/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nimo94%2Fnetbreach/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nimo94","download_url":"https://codeload.github.com/nimo94/netbreach/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nimo94%2Fnetbreach/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35060908,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-02T02:00:06.368Z","response_time":173,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["game","hacking","simulation","whitehead"],"created_at":"2026-07-02T19:34:42.912Z","updated_at":"2026-07-02T19:34:43.968Z","avatar_url":"https://github.com/nimo94.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Netbreach\n\nWelcome 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.\n\n**Play the game online:** [https://netbreach-game.web.app](https://netbreach-game.web.app)\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"Screenshots/homepage.png\" alt=\"Netbreach Homepage\" width=\"800\"\u003e\n\u003c/p\u003e\n\n---\n\n## 🎮 How to Play\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"Screenshots/level.png\" alt=\"Target Level Selection\" width=\"800\"\u003e\n\u003c/p\u003e\n\n1. **Reconnaissance:** Start by gathering intel on your target.\n   - Use `nslookup` to resolve domains to IP addresses.\n   - Run `nmap` (e.g., `nmap -sS -Pn \u003cip\u003e`) to find open ports and discover CVE vulnerabilities.\n   - Use `gobuster` (e.g., `gobuster dir -u http://\u003cip\u003e -w common.txt`) to find hidden directories.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"Screenshots/inventory.png\" alt=\"Tools Inventory\" width=\"600\"\u003e\n\u003c/p\u003e\n\n2. **Infiltration:** Exploit vulnerabilities to gain access.\n   - Use `./exploit.py --rhost \u003cip\u003e --cve \u003ccve-id\u003e` to execute payloads.\n   - Look for misconfigurations using `curl` to find `.env` files.\n3. **Complete the Mission:** Accomplish the specific objective given in your dashboard.\n   - **Exfiltration:** Find backup files and download them (`wget` or `scp`).\n   - **Defacement:** Overwrite the main website index (`ftp` + `put index.html`).\n   - **Database Wipe:** Access the database (`mysql -u root -p`) and drop the target tables.\n4. **Cover Your Tracks:** Do not disconnect until you clean your logs!\n   - Run `shred -u /var/log/auth.log \u0026\u0026 history -c` to erase your footprint before the AI traces you.\n\n### 🧠 Evade the AI\nThe 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.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"Screenshots/aimetrics.png\" alt=\"AI Neural Matrix\" width=\"800\"\u003e\n\u003c/p\u003e\n\n---\n\n## 💻 Interface \u0026 Features\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"Screenshots/store.png\" alt=\"Upgrades Store\" width=\"400\"\u003e\n  \u003cimg src=\"Screenshots/documentation.png\" alt=\"In-Game Documentation\" width=\"400\"\u003e\n\u003c/p\u003e\n\n- **Deep Lore \u0026 Mechanics:** Read the in-game documentation to understand the tools and countermeasures.\n- **Account Settings \u0026 Progression:** Customize your hacker alias and save your progress.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"Screenshots/settings.png\" alt=\"Account Settings\" width=\"400\"\u003e\n  \u003cimg src=\"Screenshots/signin_netbreach.png\" alt=\"Sign In Screen\" width=\"400\"\u003e\n\u003c/p\u003e\n\n---\n\n## 🛠️ Local Environment Setup\n\nTo run this project locally, you will need Node.js, Python 3, Docker, and Firebase CLI installed.\n\n### 1. Clone the Repository\n```bash\ngit clone https://github.com/\u003cyour-username\u003e/netbreach.git\ncd netbreach\n```\n\n### 2. Frontend Setup (React/Vite)\nNavigate to the `frontend` directory and set up the environment:\n```bash\ncd frontend\ncp .env.example .env\n```\nFill in the `.env` file with your own Firebase configuration keys.\nInstall dependencies and run the development server:\n```bash\nnpm install\nnpm run dev\n```\n\n### 3. Backend Setup (Node/Express/Prisma)\nNavigate to the `backend` directory:\n```bash\ncd ../backend\ncp .env.example .env\n```\nStart up PostgreSQL and Redis using Docker Compose:\n```bash\ndocker-compose up -d\n```\nInstall dependencies and run database migrations:\n```bash\nnpm install\nnpx prisma migrate dev\nnpm run dev\n```\n\n### 4. AI Service Setup (Python/FastAPI)\nNavigate to the `ai-service` directory:\n```bash\ncd ../ai-service\npython3 -m venv venv\nsource venv/bin/activate\npip install -r requirements.txt\nuvicorn main:app --reload --port 8000\n```\n\n---\n\n## 📦 Deployment\n\nThe frontend is configured to be deployed via Firebase Hosting:\n```bash\ncd frontend\nnpm run build\nfirebase deploy --only hosting\n```\n\n---\n\n*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.*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnimo94%2Fnetbreach","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnimo94%2Fnetbreach","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnimo94%2Fnetbreach/lists"}