Skip to content

Latest commit

 

History

History
104 lines (79 loc) · 3.42 KB

README.md

File metadata and controls

104 lines (79 loc) · 3.42 KB

HackMan 🚀

Welcome to HackMan, a challenging and engaging platform designed for users to solve math problems and unlock access codes. Perfect for those who enjoy puzzles, learning, and a touch of hacker-style aesthetics!

Features

  • Dynamic IP Display: Displays the user's current IP address in the header.
  • Math Problem Solver: Users are prompted with a math problem to solve.
  • Access Code Verification: Users can unlock advanced features by entering the correct access code.
  • Hacker Theme: Sleek black-and-green aesthetic inspired by terminal UIs.
  • Falling Numbers Background: Adds a dynamic, hacker-like ambiance with cascading green numbers.

Installation and Setup

  1. Clone the repository: 
    git clone https://github.com/Griffin71/HackMan
  2. Navigate to the project directory:
cd HackMan
  1. Install an HTTP server (if not installed):
npm install -g http-server
  1. Start the server:
http-server
  1. Open your browser and navigate to:
http://127.0.0.1:8080

🚧 Usage

  1. 🧠 Solve the Math Problem:
    A problem will appear on your screen—calculate the correct answer!
  2. ✏️ Submit Your Answer:
    Enter your solution in the first form and press Submit.
  3. 🔓 Unlock Features:
    Once the problem is solved, input the access code in the second form to proceed.

🏷️ Current Version

HackMan v1.0.0
This is the initial release with core functionalities:

  • 🌐 Fetch and display your IP address.
  • 🧮 Math problem-solving game mechanics.
  • 💻 Immersive hacker-themed interface with falling numbers animation.

📂 File Structure

HackMan/
├── assets/
│   └── hack_ZYO_icon.ico  # Favicon for the project
├── CSS/
|   ├── styles.css
│   └── index.css          # Styling for the project
├── JS/
│   ├── IP.js              # Handles IP fetching
│   ├── index.js           # Handles form interactions
│   └── mathProblem.js     # Generates and validates math problems
├── index.html             # Main HTML file
└── README.md              # Project documentation

💡 Features

Hacker-Style Design

Immerse yourself in a sleek, black-and-green hacker-themed interface, complete with cascading numbers animation and a terminal-style aesthetic.

Interactive Challenges

Engage in solving dynamic math problems to unlock new features and levels.

Dynamic IP Display

Your IP address is fetched and displayed in real-time, adding a technical touch to the experience.

✨ Future Enhancements

  • 🌟 Expand Puzzle Categories: Incorporate new types of challenges beyond math.
  • 🏆 Leaderboard Integration: Introduce competitive scoring to track your progress.
  • 📱 Mobile Optimization: Make the game more touch-friendly and responsive for all devices.

👨‍💻 Developed By

Kabelo Samkelo Kgosana

Feel free to contribute, report issues, or share your thoughts. If you encounter any problems, you can contact me directly on:

📜 License

This project is open-source and available under the MIT License.