Block-Suite

Minecraft Server Security Assessment Toolkit
Test, intercept, analyze — from a single desktop application.

What is Block-Suite?

Block-Suite is a modular desktop application built for authorized Minecraft server security assessments. It provides a collection of tools — each focused on a specific testing scenario — all managed through a JavaFX interface with built-in themes, auto-updates, and cross-version support.

Features

Feature	Status
Server Cloning — Transparent MITM proxy that mirrors any MC server	✅ Available
Data Interception — Capture logins, credentials, UUIDs, IPs, skins	✅ Available
Player Intelligence — Geolocation, interactive map, skin viewer, history	✅ Available
Playit.gg Tunneling — Built-in tunnel, no port forwarding needed	✅ Available
Advanced Proxy Config — Forwarding modes, HAProxy, BungeeGuard, compression	✅ Available
ViaVersion Support — Cross-version protocol translation	✅ Available
5 Themes — Dark Blue, Green Suite, Black Green, Purple Suite, Black Purple	✅ Available
Auto-Updates — One-click updates from GitHub Releases	✅ Available
CSV Export — Export all intercepted data	✅ Available
More modules	🔜 Planned

Screenshots

Main window — Server Cloning tab

Player intelligence overlay with geolocation and skin viewer

Quick Start

Requirements

Windows 10/11 (64-bit)
Java 17+ (Adoptium recommended)
Internet connection

Install & Run

Download the latest release from Releases
Extract the ZIP to any folder
Run Block-Suite.exe

First Clone

Enter a target server IP and port in the Server Cloning tab
Click Setup Environment — Block-Suite downloads and configures everything
Click Start Velocity to launch the proxy
Click Start Playit.gg to create a public tunnel
Share the public address — all data is intercepted in real-time

📖 Full documentation at block-suite.net

Architecture

Player's Minecraft Client
        │
        ▼
┌─────────────────────┐
│   Playit.gg Tunnel  │  ← Public address (no port-forwarding)
└─────────┬───────────┘
          │
          ▼
┌─────────────────────┐
│   Velocity Proxy    │  ← Runs locally, managed by Block-Suite
│  ┌───────────────┐  │
│  │ BlockSuite    │  │  ← Intercepts /login, /register, connections
│  │ Plugin        │──┼──→ TCP JSON → Block-Suite GUI
│  └───────────────┘  │
└─────────┬───────────┘
          │
          ▼
┌─────────────────────┐
│  Target MC Server   │  ← The real server being assessed
└─────────────────────┘