KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #dsh #dsh-plugin #ai-agent #codex #ai-agents #deepseek-harness #claude-code #cli #react #mcp

FastDex-UniversalMC

★ 34 Open GitHub ↗

Minecraft pentesting educational tool.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# FastDex - UniversalMC

A multi-tool desktop application for Minecraft server pentesting, built with C# and Windows Forms (.NET Framework 4.7.2).

---

## Table of Contents

- [Overview](#overview)
- [Features](#features)
- [Requirements](#requirements)
- [Installation](#installation)
- [Project Structure](#project-structure)
- [Modules](#modules)
  - [Session and License](#session-and-license)
  - [Port Scanner](#port-scanner)
  - [Server Info](#server-info)
  - [User Info](#user-info)
  - [FakeProxy](#fakeproxy)
  - [Deasher](#deasher)
  - [Finder](#finder)
- [Dependencies](#dependencies)
- [Build](#build)
- [Discord](#discord)

---

## Overview

FastDex UniversalMC is a Windows desktop application that bundles multiple Minecraft-related pentesting utilities into a single interface. It uses a license-based authentication system backed by a remote API, and integrates Discord Rich Presence to display activity status.

---

## Features

- **Port Scanner** - Scan any IP or domain for open TCP ports using Nmap with configurable port ranges.
- **Server Info** - Query Minecraft server details including IP, port, version, protocol, player count, server type (Java/Bedrock), MOTD description, online status, and DDoS protection detection (Cloudflare, TCPShield, NeoProtect).
- **User Info** - Look up Minecraft player profiles: premium status, online UUID, offline UUID (v3), player skin render, and name history via Laby.net API.
- **FakeProxy** - Launch a Minecraft proxy server through a Python backend with Pinggy TCP tunneling. Supports 4 operation modes and real-time logging of connections, disconnections, commands, and messages.
- **Deasher** - Hash cracking tool that supports SHA512, SHA256, SHA1, and MD5 hashes with salt detection. Uses a custom Python script with user-provided wordlists.
- **License System** - Validates user licenses against a remote API with automatic periodic re-validation every 30 seconds.
- **Discord Rich Presence** - Shows FastDex activity status on the user's Discord profile.

---

## Requirements

- **OS**: Windows 7 or later
- **.NET Framework**: 4.7.2
- **Nmap**: Required for the Port Scanner module. Must be installed and available in the system PATH.
- **Python 3.11+**: Required for the FakeProxy and Deasher modules.
- **Pinggy Account**: Required for the FakeProxy module to create TCP tunnels.
- **Valid License**: Required to access the tool after launch.

---

## Installation

1. Clone or download this repository.
2. Open `FastDexTool.sln` in Visual Studio 2022 or later.
3. Restore NuGet packages (they are included in the `packages/` folder).
4. Build the solution in Debug or Release configuration.
5. Run the generated executable from `FastDexTool/bin/Debug/` or `FastDexTool/bin/Release/`.

---

## Project Structure

```
FastDex-UniversalMC-main/
    FastDexTool.sln              Solution file
    packages/                    NuGet packages
    FastDexTool/
        Program.cs               Application entry point
        Form1.cs                 Main form (navigation, Discord RPC)
        Form1.Designer.cs        Main form designer layout
        session.cs               License validation and session management
        scanner.cs               Port scanner using Nmap
        serverinfo.cs            Minecraft server information lookup
        userinfo.cs              Minecraft player profile lookup
        fakeproxy.cs             Proxy server launcher with live logging
        deasher.cs               Hash cracking interface
        finder.cs                Placeholder module (not yet implemented)
        initial.cs               Home screen
        DiscordRpcDemo/
            DiscordRpc.cs        Discord Rich Presence native interop
        Properties/              Assembly info, resources, settings, manifest
        Resources/               Image assets for the UI
        App.config               Runtime configuration
        packages.config          NuGet package references
        icon.ico                 Application icon
        FastDex.pfx              Code signing certificate
        FastDexTool.csproj       MSBuild project file
```

---

## Modules

### Session and License

Handles user authentication. On startup, the application checks the current version against the remote API at `fastdexapi.vercel.app`. It validates the license key provided by the user and stores the session data (license and IP). The license is re-checked every 30 seconds; if it becomes invalid, the session panel reappears.

States:
- **Maintenance** - The tool is temporarily disabled server-side.
- **Outdated** - A newer version is available.
- **Warning** - A server-side warning is active.
- **Normal** - The license input panel is shown.

### Port Scanner

Wraps Nmap to scan TCP ports on a target IP or domain. The user can specify a custom port range (default: 65501-65535). The scan uses Nmap flags `-T4 -sS -Pn` for fast SYN scanning without host discovery. Open ports are displayed in real time and can be copied to the clipboard by clicking the results panel.

### Server Info

Queries the [mcsrvstat.us](https://api.mcsrvstat.us/) API to retrieve Minecraft server details:

- **IP and Port**
- **Protocol version and version name**
- **Server type** (Java or Bedrock)
- **Player count** (online/max)
- **Online status**
- **MOTD description**
- **Server banner image** via mclive.eu

Also performs a DNS lookup via networkcalc.com to detect DDoS protection services (Cloudflare, TCPShield, NeoProtect).

### User Info

Queries the Mojang API to determine if a player is premium. For premium accounts, it retrieves:

- **Online UUID** (formatted with dashes, click to copy)
- **Offline UUID** (computed using MD5-based v3 UUID from `OfflinePlayer:<nick>`, click to copy)
- **Player skin render** from Crafatar
- **Name history** from the Laby.net API, showing previous usernames with timestamps

### FakeProxy

Launches a Python-based Minecraft proxy server. The workflow:

1. Enter the target server IP:PORT or domain.
2. Select an operation mode (1-4).
3. Set up a Pinggy TCP tunnel by running the SSH command (auto-copied to clipboard) and pasting the resulting `tcp://` URL.
4. Start the proxy.

The proxy outputs are parsed in real time:
- **Proxy IP** and **Admin Key** are displayed in the info panel.
- **Connect/Disconnect/Command/Message** events appear in the log panel.

When stopped, only the specific proxy process is terminated (not all Java processes).

### Deasher

A hash cracking tool that:

1. Parses the input to detect the hash algorithm, hash value, and salt. Supports the `$ALGORITHM$HASH$SALT` format as well as `HASH$SALT` and plain hash strings.
2. Requires a wordlist file (`.txt`).
3. Runs a Python script (`Deash.py`) located in `%APPDATA%/FastDexData/Utils/` to perform the cracking.
4. Displays the result or an appropriate error message.

### Finder

Not yet implemented. Displays a placeholder message.

---

## Dependencies

| Package | Version | Purpose |
|---|---|---|
| Guna.UI2.WinForms | 2.0.4.7 | Modern UI controls for WinForms |
| Newtonsoft.Json | 13.0.3 | JSON parsing for API responses |
| FontAwesome.Sharp | 6.6.0 | Icon support in the UI |
| System.IO.Compression.ZipFile | 4.3.0 | ZIP file handling |

---

## Build

```
Open FastDexTool.sln in Visual Studio
Build > Build Solution (Ctrl+Shift+B)
```

Target framework: .NET Framework 4.7.2
Output type: Windows Application (WinExe)
The assembly is signed with `FastDex.pfx`.

---

## Discord

Join the community Discord server for support, updates, and license keys:

[discord.gg/6ZCdV29w6n](https://discord.gg/6ZCdV29w6n)

FastDex-UniversalMC

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README