MHDDoS Professional v1.6.4

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 62 distinct DDoS attack methods.

Features

🛡️ WAF Bypass Engine

• 5-Tier Parallel Solver Cascade: Intelligent waterfall architecture that tries lightweight HTTP solvers first, then escalates through headless browsers with first-winner strategy.

Tier	Engine	Type	Timeout
T1	Cloudscraper + curl_cffi	HTTP-only	10s
T2	Nodriver	CDP Chromium	45s
T2b	Camoufox	Firefox Anti-Detect	45s
T2c	Patchright	Patched Chromium	45s
T3	Playwright	Legacy Fallback	45s

• Camoufox Anti-Detect: Firefox-based browser with C++ level fingerprint injection, human-like cursor movements, and GeoIP-aligned proxy locale for Turnstile bypass.
• Patchright Stealth: Patched Playwright fork that strips automation markers for undetectable Chromium automation.
• ADAPTIVE Method: Auto-detects WAF type (Cloudflare, DDoS-Guard, Sucuri, Arvan) and selects optimal attack method.
• Persistent Bypass Intelligence: SQLite matrix that remembers successful bypass tokens for instant "Turbo Mode" on known targets.

⚡ Attack Engine

• Hybrid Core (Python + Go): High-performance mode (--go) offloads L4 flooding to a compiled Go engine, bypassing Python's GIL.
• Deep TLS/JA3 Impersonation: Modern browser profiles (chrome131, firefox133, safari17_0) via curl-cffi.
• HTTP/3 (QUIC) Support: High-efficiency flooding via httpx + h3.
• Dynamic Concurrency: Adaptive semaphore tuning in IMPERSONATE method based on real-time RPC rates.
• Target-Specific Methods: BEHAVIOR (behavioral simulation), BROWSER (full headless browser loop with 30s debounce), HYBRID (adaptive WAF-ratio oscillator: >40% WAF → BROWSER, else IMPERSONATE).

📊 Analytics & Telemetry

• Tactical Diagnosic Streams: Comprehensive tiered bypass evaluation pipeline capturing exact HTTP states, precise cookie token lifetimes, and constraint timers.
• Solver Telemetry Pipeline: Real-time tracking of active solver, solve phase, and token TTL.
• IntelligenceDB Analytics: Aggregate API endpoints for target stats, method effectiveness, timeline trends, and top targets.
• Session Export: Full attack history export in JSON/CSV format.
• Combat Impact Dashboard: Real-time 2xx/4xx/5xx distribution with per-solver success rates.

🏗️ Architecture & Development

• Isolated Testing Infrastructure: Independent Headless Bypass Validator suite (tests/test_bypass.py) for component-level WAF probing and isolated dependency checks.
• Method Test Harness (tests/test_methods.py): Full-suite headless validation of CFBUAM, BEHAVIOR, BROWSER, HYBRID with CFBUAM pre-warm, live counters, and CLI control.
• Zombie Core Evisceration: Native multi-platform process cleaners built-in preventing memory leaks from erratic, suspended Chromium contexts.

🌐 Distributed Architecture

• True Distributed C2: Shares enriched bypass metadata (Cookies, UA, Headers, JA3) across the entire fleet in real-time.
• Proxy Pre-validation: curl_cffi HTTP probe for browser-grade L7 proxy validation.
• Enterprise-Grade UI: Fully responsive dark mode GUI with Glassmorphism 2.0 aesthetics.
• Cross-Platform: Optimized for Windows with SafeLogger and UTF-8 stdout reconfiguration.

(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

   pip install camoufox[geoip] patchright
   python -m camoufox fetch
   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, ADAPTIVE, HTTP3, BROWSER, HYBRID, CFB, CFBUAM, BYPASS, BOMB, KILLER, TOR, etc. (Total 29)
Layer 4: TCP, UDP, SYN, MCPE, DNS, VSE, MCBOT, etc. (Total 21)

(back to top)

Roadmap

✅ Completed

• Diagnostic Telemetry Pipeline (Explicit tiered solver logging: L1/L2)
• Standalone Test Architecture (Isolated headless WAF component testing via test_bypass.py)
• Intelligent Proxy Health Scoring (Success Rate, Latency, Uptime based routing)
• H2FLOOD Method (High-efficiency HTTP/2 multiplexing via httpx)
• Smart Cookie Auto-Refresh (Zero-downtime background Turnstile pre-solving)
• Token/Cookie Persistent Cache (0.5s cold starts for known targets via token_cache.json)
• Shared Async Connection Pool (aiohttp refactor for BYPASS)
• Async DNS Resolution (Non-blocking aiodns implementation)
• Circuit Breaker Pattern & Exponential Backoff (Strict L7 retry mechanics)
• True Distributed Bypass Token Sync
• Real-time Combat Impact (Fidelity) Analysis
• Deep TLS/JA3 Fingerprinting (IMPERSONATE)
• HTTP/3 (QUIC) Protocol Support
• Advanced Orchestration Engine (12+ Solvers)
• 5-Tier Parallel Solver Cascade (Cloudscraper → Nodriver → Camoufox → Patchright → Playwright)
• BROWSER Method (Full headless browser loop with adaptive IMPERSONATE fallback) v1.6.4
• HYBRID Method (WAF-ratio adaptive oscillator: BROWSER ↔ IMPERSONATE) v1.6.4
• Headless Method Test Suite (tests/test_methods.py — CFBUAM/BEHAVIOR/BROWSER/HYBRID validated on example-target.com) v1.6.4

🚧 Planned (Phase 3)

• Real-Time Dashboard Analytics Charts (UI/UX)
• Multi-Target Orchestration
• Plugin Architecture for Custom Solvers
• Distributed Mode (Multi-Node Scaling)

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.
• Camoufox - Firefox anti-detect browser engine.
• Patchright - Patched Playwright for stealth automation.
• Theyka / Turnstile-Solver - Turnstile solver reference.

(back to top)