Skip to main content

A terminal-based hacking simulator game

Project description

HackQuest 🕵️‍♂️💻

Version 📜 License Python Platform Build Status Contributions

HackQuest Logo

HackQuest is a terminal-based hacking simulator game designed to test your problem-solving and ethical hacking skills. Solve challenges, crack codes, and advance through increasingly difficult levels in this immersive, text-based environment.


🎮 Features

  • 🚀 Dynamic Welcome Screen: Animated ASCII art, hacker-themed quotes, and polished prompts.
  • 🖼️ Advanced UI Elements: Rich separators, typewriter effects, and dynamic text animations.
  • 🔓 Multiple Levels:
    • Level 1: Password Retrieval.
    • Level 2: File Decryption.
    • Level 3: Log Analysis.
  • 🎲 Mini-Game: Integrated 2048 terminal game for fun breaks.
  • 🔐 Encryption Challenges: Test your cryptography skills.
  • 🌟 Dynamic Commands: Simulated hacking tools like scan, decrypt, and more.

📸 Screenshots

Welcome Screen

Welcome Screen

Interactive Commands

Interactive Commands

Level Challenges

Level Challenges


📋 Requirements

  • Python 3.8+
  • Unix/Linux or Windows (with windows-curses)
  • Rust installed (if using Rust integration features)

Python Dependencies

All dependencies are listed in requirements.txt. Install them using:

pip install -r requirements.txt

⚙️ Setup & Installation

  1. Clone the repository:

    git clone https://github.com/SMTNDev/HackQuest.git
    cd HackQuest
    
  2. Install dependencies:

    pip install -r requirements.txt
    
  3. Run the game:

    python3 src/main.py
    
  4. For Windows users:
    Install windows-curses:

    pip install windows-curses
    

🎯 How to Play

  1. Launch the game:

    python3 src/main.py
    
  2. Use the following commands to navigate the game:

    • help - View all available commands.
    • level1, level2, level3 - Start levels.
    • scan, decrypt - Simulate hacking tools.
    • exit - Quit the game.
  3. Complete levels by solving challenges and advancing to the next!


✨ HackQuest Commands

Command Description
help Show the help menu
level1 Start Level 1 (Password Retrieval)
level2 Start Level 2 (File Decryption)
level3 Start Level 3 (Log Analysis)
scan Simulate a scanning tool
decrypt Simulate decryption process
exit Exit the game

🛠️ Contribution

Contributions are welcome! If you'd like to improve the game, follow these steps:

  1. Fork the repository.
  2. Create a new branch:
    git checkout -b feature-name
    
  3. Make your changes and commit:
    git commit -m "Add feature"
    
  4. Push to your branch:
    git push origin feature-name
    
  5. Submit a pull request.

❤️ Support

If you like the project, please consider supporting:

Buy Me a Coffee


📝 License

This project is licensed under the Apache-2.0 License.


🌟 Acknowledgments

  • Inspired by the spirit of ethical hacking and problem-solving.
  • Thanks to all contributors and supporters of open-source projects!

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

HackQuest-1.1.1-py3-none-any.whl (14.6 kB view details)

Uploaded Python 3

File details

Details for the file HackQuest-1.1.1-py3-none-any.whl.

File metadata

  • Download URL: HackQuest-1.1.1-py3-none-any.whl
  • Upload date:
  • Size: 14.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.12.7

File hashes

Hashes for HackQuest-1.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 df72123a26ad7ac9081f0720cdd2e89c9398c1a1684cb285b61f009b4290dc5a
MD5 808795f6f37f8ba2838f67088a5ab589
BLAKE2b-256 329f8c4294e8047900c2714c534bc5dc2467988c1018bd0b5df343521156c270

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page