Server Cloning

The Server Cloning tab is the core of Block-Suite. It lets you set up a transparent proxy that mirrors any Minecraft server, intercepting all player data in real-time.

Tab Overview

The Server Cloning tab is divided into several sections, from top to bottom:

Target Server Configuration

Original Server Status

The status card on the right side shows real-time information about the target server:

• Favicon — The server's icon (64×64), decoded from base64
• Address — The resolved IP and port
• Domain — The hostname you entered
• Version — The Minecraft version (e.g., "Paper 1.20.4")
• Players — Online / Max count
• Ping — Color-coded latency: < 50ms 50–150ms > 150ms
• MOTD — Full Minecraft color-code rendering (§ codes + JSON components)

Click the refresh icon to re-ping the server at any time.

Control Buttons

Setup Environment

Downloads and configures everything needed:

1. Downloads the latest Velocity proxy from PaperMC (first time only)
2. Generates velocity.toml config pointing at your target — with all settings from Advanced Cloning
3. Installs the BlockSuite interceptor plugin
4. Downloads ViaVersion + ViaBackwards if enabled in Settings
5. Downloads the playit.gg agent (first time only)
6. Auto-pings the target server to show its status

Start / Stop Velocity

Start Velocity launches the Velocity proxy and the interception server. The proxy binds to 0.0.0.0:<proxy-port> so players can connect.

Stop Velocity gracefully shuts down the proxy and interception server.

Start / Stop Playit.gg

Start Playit.gg creates a public tunnel. After a few seconds, the public address appears in the status bar.

Stop All

Emergency button — stops Velocity, Playit.gg, and the interception server simultaneously.

Status Bar

The status bar shows the health of each service:

The Public Address label shows the playit.gg address. Click Copy IP to copy it to your clipboard.

Intercepted Data Table

Every event intercepted by the plugin appears here in real-time, newest on top:

Event Types

Data Actions

• Clear Data — Removes all entries from the table (doesn't affect saved data until next save cycle)
• Export CSV — Exports all data to a timestamped CSV file in the runtime/ folder

Players Summary Panel

The tree view on the right groups all intercepted data by player name:

▼ PlayerName (5 events)
    UUID: 069a79f4-44e9-4726-a5be-fca90e38aaf5
    IP: 192.168.1.50
    [!] LOGIN: /login mypassword123
    Connections: 3
    Disconnections: 2

• Each player node shows their Minecraft head icon (loaded from Minotar, cached locally)
• Credential lines are prefixed with [!] for visibility
• Collapse All button collapses every player node

Right-Click Context Menu

Player More Info Overlay

A detailed modal overlay for any player, accessed via right-click → More Info.

Info Section

Rows with copy buttons for:

• Username — Minecraft name
• UUID — Mojang UUID
• IP — Player's IP address
• Password — Captured credential (if any)

Each row has a copy icon that swaps to a check mark for 1.2 seconds after copying.

Geolocation

Using the ip-api.com service, the overlay shows:

• City, Region, Country
• Latitude & Longitude
• ISP, Organization, AS Number

Interactive Map

An embedded OpenStreetMap viewer with:

• Draggable panning — click and drag to explore
• Zoom controls — + / − buttons, zoom range 3–16
• Recenter button — snaps back to the player's location
• Pin marker — red pin icon at the player's coordinates

Minecraft Skin

• Full body render (200px tall) from Minotar
• Download Skin button — opens a file chooser to save the original skin PNG

Activity Log

The log at the bottom records all system messages with timestamps ([HH:mm:ss]).

Log Actions

The separate log window includes a Word Wrap toggle button and a line count indicator.

Toast Notifications

Slide-in notifications appear from the top-right corner for important events:

Toasts automatically dismiss after 3 seconds with a slide-out animation.

Data Persistence

All intercepted data is automatically saved to runtime/player_data.json whenever new events arrive. When you relaunch Block-Suite, your previous data is restored into the table and player tree.