Documentation

How It Works

A peek behind the curtain. Spoiler: it's a lot of pinging.

Process

The Scanning Process

01

Network Discovery

We blast through IP ranges looking for anything that responds on port 25565. It's not subtle, but it works.

02

Status Query

Found a server? Cool. We send it a polite handshake and ask for its life story: player count, version, description, mods, the works.

03

World Snapshot

When we can connect, we capture the nearby chunks the server sends our client and turn their block data into a 3D snapshot.

04

Data Indexing

Server responses get parsed, indexed, and made searchable within minutes. Raw responses go in; searchable servers come out.

05

Continuous Monitoring

We never stop checking. Servers get re-scanned regularly. Stale data is worse than no data.

Frequency

How Often We Pester Servers

Server TypeScan Frequency
Active serversevery 5–15 minutes
Offline servers3 times per day
Full network scanContinuous rotation

Capabilities

What We Can See

Protocol Support

Supports Minecraft Java Edition protocols from 1.7 through the latest versions

Mod Detection

Detects Forge mod installations and mod lists from supported server versions

Geolocation

Maps server locations by country for regional filtering and analysis

Player Tracking

Tracks online players, usernames, and player session history (30 days max)

Seen enough? Go explore.