HackerSim: A Retro Hacking Terminal Game

Live Demo: https://your-hackersim-url.netlify.app ## Overview 🕹️

HackerSim is an interactive, browser-based game that drops you into a retro hacking terminal. You'll take on the role of a hacker, running network scans, infiltrating secure systems, reading files, and completing a series of story-driven missions.

The entire game is a self-contained single-page application built with React and styled with Tailwind CSS. It features a persistent game state that saves your progress, a leveling and XP system, and dynamic visual elements drawn with the HTML Canvas API.

Key Features ✨

• Interactive Terminal: A realistic terminal interface that accepts a wide range of commands, maintains a command history, and provides immersive, animated feedback.
• Stateful Mission System: Progress through a multi-step mission storyline, from initial network reconnaissance to finding hidden servers. Your progress is automatically saved to LocalStorage.
• XP & Leveling System: Gain experience points (XP) for completing actions like scanning networks and logging into systems. Level up to earn new hacker titles.
• Dynamic "Hacker Badge": See your stats on a dynamic badge that is generated on-the-fly using HTML Canvas and can be downloaded as a PNG image.
• Immersive Visuals: Features a classic "Matrix" digital rain background and a helpful AI Agent companion to guide you on your missions.
• Fun Easter Eggs: Includes a variety of meme commands and fun references tailored for an Indian audience (check out cat weird_lunch_orders.txt!).

Core Tech Stack 🛠️

• Frontend: React, Vite
• Styling: Tailwind CSS
• Visual Effects: HTML Canvas API for the Matrix Rain background and the Hacker Badge generator.

Available Commands ⌨️

The terminal accepts a variety of commands to interact with the game world.

Core Gameplay Commands

Command	Description
network_scan	Scans the network for available hosts.
connect <ip>	Connects to a specific IP address.
login <password>	Logs into a connected host.
ls	Lists files and directories on the logged-in host.
cat <file>	Displays the contents of a file.
cd <dir>	Changes the current directory.
install_tool <name>	Installs a required tool (e.g., nmap).
whoami	Displays your current hacker profile and stats.
mission_status	Shows your current mission objective.
reset	Resets all game progress.
clear	Clears the terminal screen.
help	Displays this list of commands.

Fun & Meme Commands

Try these for fun: decrypt_file, rickroll, sudo rm -rf /, init matrix, binod, bhai kya kar raha hai tu, pawri ho rahi hai, so beautiful so elegant, and more!

How to Run Locally

This project was bootstrapped with Vite. To run it on your local machine:

1. Clone the repository:

   git clone https://github.com/VertexCodeStudio/hackersim.git

2. Navigate to the project directory:

   cd hackersim

3. Install the necessary dependencies:

   npm install

4. Start the local development server:

   npm run dev

The application will then be running on your localhost.