MHDDoS Professional v1.2.1

A Modern, High-Performance Web & Desktop GUI for the renowned MHDDoS Script.
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Features
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Roadmap
5. Contributing
6. License
7. Contact
8. Acknowledgments

About The Project

MHDDoS-GUI is an advanced evolution of the original MatrixTM/MHDDoS script, now equipped with a stunning, highly optimized graphical user interface. Designed with premium dark mode aesthetics and built for absolute performance, this project provides both a Web Dashboard and a standalone Desktop Application to launch, monitor, and manage up to 59 distinct DDoS attack methods.

Features

• Deep TLS/JA3 Impersonation: Integrated curl-cffi to provide native-level browser fingerprinting. The engine mimics exact TLS handshakes (JA3) of specific browsers, bypassing advanced anti-bot mitigations.
• HTTP/3 (QUIC) Support: High-efficiency HTTP3 method utilizing the httpx and h3 libraries to bypass modern WAFs via QUIC-based traffic.
• True Distributed C2: Decentralized architecture that shares bypassed Cloudflare credentials (cf_clearance) across the entire fleet in real-time.
• Combat Impact Dashboard: Real-time visualization of "Actual Hits" (Fidelity) and target response distribution (2xx/4xx/5xx) using status code sampling.
• Precision Cloudflare Bypass: Advanced solve_cf engine utilizing nodriver, coordinate-based Turnstile clicking, and WebGL hardware masking.
• AsyncIO Core Engine: Completely asynchronous Layer 7 flooding engine (asyncio + aiohttp) with centralized session management via AsyncHTTPManager.
• Operations History & Analytics: Persistent SQLite-backed history tracking with interactive time-series charts (PPS/BPS/Latency).
• AI Smart Bypass (Machine Learning): Adaptive heuristic feedback loop that analyzes WAF responses and dynamically tweaks User-Agents and headers.
• Enterprise-Grade UI: Fully responsive, data-dense dark mode GUI with full ARIA-compliant accessibility and "Glassmorphism 2.0" aesthetics.

(back to top)

Built With

• 
• 
• 
• 
• 

(back to top)

Getting Started

To get a local copy up and running, follow these simple steps.

Prerequisites

Ensure you have Python 3.11+ installed on your system.

• Python 3

  python --version

Installation

1. Clone the repo

   git clone https://github.com/naravid19/MHDDoS-GUI.git

2. Install required Python packages

   pip install -r requirements.txt

3. Install advanced browser engines

   playwright install chromium

(back to top)

Usage

1. Web Dashboard Mode (Recommended)

Launch the backend server and access the tactical interface via browser (port 8000).

python web_gui.py --force

2. Desktop Application Mode

Start the GUI in a standalone application window.

python desktop_gui.py

3. Distributed Worker Mode

Connect multiple nodes to your master API for collective operations.

python worker.py --master http://YOUR_MASTER_IP:8000 --token SECRET_TOKEN

Supported Methods

Layer 7: GET, POST, IMPERSONATE, HTTP3, CFB, CFBUAM, BYPASS, BOMB, KILLER, TOR, etc. (Total 26)
Layer 4: TCP, UDP, SYN, MCPE, DNS, VSE, MCBOT, etc. (Total 21)

(back to top)

Roadmap

• True Distributed Bypass Token Sync
• Real-time Combat Impact (Fidelity) Analysis
• Deep TLS/JA3 Fingerprinting (IMPERSONATE)
• HTTP/3 (QUIC) Protocol Support
• Automated Infrastructure Recon (Asset Discovery)
• Distributed Load Balancing across Global Fleet

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

License

Distributed under the Unlicense License. See LICENSE for more information.

Caution

This tool is meant for educational purposes and authorized network stress testing ONLY. Testing infrastructure without full legal authorization is a cybercrime.

(back to top)

Contact

Project Link: https://github.com/naravid19/MHDDoS-GUI

(back to top)

Acknowledgments

• MatrixTM / MHDDoS - Core engine foundation.
• Othneil Drew / Best-README-Template - Structural template.
• curl-cffi - TLS impersonation capabilities.

(back to top)