mcping is a headless Minecraft Java latency checker. Each probe opens a real TCP connection, collects ICMP echo latency for the same resolved/connected IP, and speaks the Minecraft Java status protocol, which makes the result closer to what a player, proxy, or monitoring system experiences when reaching a server. Optional probes can also collect best-effort login/play latency. Route mode runs a standalone Minecraft TCP route trace through .
mcping is a headless Minecraft Java latency checker. It does not use ICMP. Instead, it opens a real TCP connection and speaks the Minecraft Java status protocol, which makes the result closer to what a player, proxy, or monitoring system experiences when reaching a server.
Sterne
2
Tools
—
Uptime
—
nexttrace
Probe path:
SRV lookup -> A/AAAA lookup -> TCP connect -> Minecraft handshake/status -> Minecraft ping/pong -> ICMP echo to the same IP
optional: login/play probe
route mode: SRV/default/explicit port resolution -> nexttrace TCP route trace to the Minecraft port
Each probe prints realtime segmented timings. The final summary reports min / avg / max / median / p95 for every metric.
Features
Minecraft Java status/ping protocol probing
MOTD rendering with Minecraft text colors and favicon preview
ICMP echo probing through the system ping command
Best-effort Minecraft login/play latency probing
Minecraft handshake domain override for IP/proxy targets
Standalone nexttrace route detection using TCP to the Minecraft port
_minecraft._tcp SRV lookup support
Custom DNS server selection for SRV and A/AAAA lookups
Domain, IPv4, IPv6, host:port, and host port target formats
CLI style inspired by ping and tcping
Continuous probing with Ctrl+C summary
IPv4-only and IPv6-only modes
JSON output for monitoring integrations
Cross-platform release build matrix
Static Go binary with no third-party dependencies
Options
Usage:
mcping [options] host [port]
Target:
host Server domain, IPv4, or IPv6
port Optional port. If omitted, SRV is tried first, then 25565.
Count:
-n count Number of probes, tcping-style
-c count Number of probes, ping-style; 0 means infinite
-t Probe until stopped
Timing:
-i seconds Interval between probes
-w ms Timeout per probe in milliseconds
--timeout seconds Timeout per probe in seconds; overrides -w
Network:
-4 IPv4 only
-6 IPv6 only
-dns server DNS server for SRV and A/AAAA lookup, for example 1.1.1.1 or 1.1.1.1:53
--no-srv Disable _minecraft._tcp SRV lookup
Minecraft:
--protocol n Minecraft protocol version used in the handshake, default 765
--play Also attempt a login/play latency probe
--play-name name Username for --play probes, default mcping
--domain name Override Minecraft handshake serverAddress/domain
--server-address name Same as --domain
-motd Fetch and render MOTD, favicon, version, and players once
--save-ico path Save MOTD favicon PNG to path; requires -motd
--ico-size pixels CLI favicon preview size, 1-128, default 64
--icon-size pixels Same as --ico-size
Route:
--route Run only nexttrace TCP route detection to the Minecraft port
--route-timeout sec Timeout for --route, default 60
MCPING_NEXTTRACE nexttrace executable path, fallback when PATH lookup fails
Output:
--json Print JSON
--version Print version information
Output
Realtime output example:
Target: mc.hypixel.net -> mc.hypixel.net:25565 (default-port, serverAddress=mc.hypixel.net)
2026-06-26 03:22:47.891 #001 ip=mc.hypixel.net:25565(172.65.197.160:25565) icmp=203.00 ms tcp=205.31 ms status=358.43 ms pong=270.49 ms play=fail(online-mode encryption requested; authenticated/encrypted play probing is not supported)
Field meanings:
Target Final target used for probing
serverAddress Address sent inside the Minecraft handshake; can be overridden with --domain
ip Display target and actual remote address as host:port(ip:port)
icmp ICMP echo latency to the same IP used by this probe
tcp TCP connect time
status Minecraft handshake + status request/response time
pong Minecraft ping/pong round-trip time
play Best-effort login/play latency, only with --play
status, pong, and play:
status = Minecraft handshake + status request/response phase
pong = Minecraft ping/pong RTT after status has completed
play = login/play probe time until login success when the server allows it
--play is intentionally conservative. Online-mode servers request encrypted authenticated login, which this tool does not perform. In that case the status/pong metrics can still succeed, while play reports a failure reason.
MOTD Rendering
Use -motd to fetch the Minecraft status response once and render the server list information directly in the terminal:
./mcping-linux-amd64-v1 mc.example.net -motd
MOTD mode prints the target, resolved connection address, ICMP/TCP/status/pong timing, server version, protocol number, online/max players, sample player names, and the server description. Minecraft legacy color codes such as §a and JSON chat component colors are rendered with ANSI colors when possible.
If the server status includes a favicon, mcping decodes the Minecraft favicon PNG and previews it in the CLI as a 64x64 ANSI true-color image by default. Change only the CLI preview size with --ico-size (or --icon-size):
The option name uses ico because Minecraft users often call it a server icon, but the Minecraft status protocol provides PNG image data.
The saved PNG always contains the original server response and is not resized by --ico-size.
Domain Override
Some Minecraft servers and proxies check the hostname inside the Minecraft handshake. If you connect directly to an IP address, the TCP connection can succeed while the server rejects or misroutes the Minecraft protocol because it expected a domain.
Use --domain to connect to one host/IP while sending a different Minecraft serverAddress:
When no explicit port is provided, --domain also supports Minecraft SRV lookup. In that case _minecraft._tcp.<domain> can provide the Minecraft port, while the TCP connection host remains the target you typed:
If play.example.com has an SRV record pointing to port 25566, mcping connects to 203.0.113.10:25566 and sends play.example.com in the Minecraft handshake.
This affects Minecraft status/pong and --play handshakes. It does not change the TCP connection host, ICMP target, or --route target. It can change the port when --domain has an SRV record and no explicit port was supplied.
Custom DNS
Use -dns to force SRV and A/AAAA lookup through a specific DNS server:
The custom DNS resolver is used for Minecraft SRV lookup, normal address lookup, MOTD mode, regular probes, and route target selection. IP literal targets do not need DNS.
Route Detection
--route is route-only mode. It does not run ICMP ping, TCP latency probes, Minecraft status, Minecraft pong, or play probing. It resolves the Minecraft target and then runs nexttrace once:
./mcping-linux-amd64-v1 mc.example.net --route
The route trace is Minecraft-aware in target selection:
SRV/default/explicit port resolution -> first resolved A/AAAA candidate -> nexttrace --tcp --port <minecraft-port>
This means the route trace follows the TCP path to the Minecraft service port instead of a generic ICMP traceroute. For Cloudflare Anycast and other proxy/edge deployments, the traced destination is the player-facing edge IP selected by normal DNS/SRV resolution, not the hidden origin.
Important limits:
nexttrace traces the network path with TCP packets to the Minecraft port.
It cannot make every intermediate router answer a Minecraft status/pong packet.
Use normal mcping output for tcp/status/pong latency, and use --route separately for path visibility.
nexttrace is not bundled into mcping. Route lookup order is:
nexttrace in system PATH -> MCPING_NEXTTRACE environment variable -> install command
Point mcping to a custom nexttrace executable with an environment variable:
If nexttrace is not in system PATH and MCPING_NEXTTRACE is not set, --route prints the official install command:
curl -sL nxtrace.org/nt | bash
On Linux, TCP route tracing can still require raw socket permissions because traceroute receives ICMP TTL-exceeded replies while sending TCP probes. If nexttrace reports operation not permitted, grant the executable the required capabilities:
On Windows, TCP route tracing with nexttrace may require Administrator privileges because raw packet capture/injection is commonly needed.
Summary
Final summary example:
Summary: sent=2 received=2 lost=0 loss=0.0%
ICMP: min=200.00 ms avg=201.50 ms max=203.00 ms median=201.50 ms p95=202.85 ms
TCP: min=202.42 ms avg=203.87 ms max=205.31 ms median=203.87 ms p95=205.17 ms
Status: min=358.43 ms avg=363.09 ms max=367.75 ms median=363.09 ms p95=367.29 ms
Pong: min=261.90 ms avg=266.20 ms max=270.49 ms median=266.20 ms p95=270.06 ms
Play: min=421.33 ms avg=424.10 ms max=426.87 ms median=424.10 ms p95=426.59 ms
Summary fields:
sent Number of probes started
received Number of successful pong responses
lost Number of failed probes
loss Failure percentage
min Minimum value
avg Average value
max Maximum value
median Median value
p95 95th percentile; 95% of successful probes are <= this value
p95 is useful for understanding stability. Averages can look fine while rare spikes are still bad; p95 makes those tail-latency problems easier to see.
The JSON summary includes grouped stats for icmp, tcp, status, pong, and play when samples exist for those metrics. Route-only JSON contains an empty samples array, a zeroed summary object, and a route object with the nexttrace command, selected target, duration, raw output, and any error or exit code.
SRV Lookup
When no explicit port is provided, mcping tries:
_minecraft._tcp.<host>
If an SRV record exists:
connect address = SRV target and port
serverAddress = original host provided by the user
System ping usually uses ICMP. Minecraft Java clients use TCP and the Minecraft protocol. A server, proxy, or firewall may block ICMP while TCP 25565 works, or ICMP may be fast while Minecraft status is slow. mcping reports both ICMP and Minecraft protocol timings so you can compare the layers.
What does ICMP measure?
icmp runs the operating system ping command once per probe and parses its time=... ms result. When TCP connects successfully, ICMP is sent to the same remote IP used by that TCP connection after the Minecraft protocol timings have been collected. If TCP cannot connect, ICMP is sent to the first resolved candidate IP. ICMP may be blocked or deprioritized independently from TCP 25565.
What about Cloudflare Anycast?
When a server uses Cloudflare Anycast or another TCP proxy, mcping measures the player-facing edge/proxy path, not the hidden origin behind it. This is usually the correct latency from the player's point of view.
To avoid measuring a different Anycast edge, ICMP is aligned to the same IP used by the probe's TCP connection. ICMP is collected after the Minecraft protocol timings, so an ICMP timeout does not inflate status or pong. Still, ICMP and TCP/Minecraft traffic can be handled differently by Cloudflare, so use tcp, status, and especially pong as the authoritative Minecraft latency metrics. Treat icmp as a comparison signal.
When --route is enabled, route detection is standalone. It resolves the Minecraft target, selects the first resolved A/AAAA candidate allowed by -4 or -6, and runs a TCP trace to the Minecraft port. This is the closest route-level view of the path a Minecraft client uses, but it still cannot reveal a hidden origin behind Cloudflare or another proxy.
What does --play measure?
--play opens a separate Minecraft login connection and measures how long it takes to reach login success when the server allows an unauthenticated best-effort probe. Online-mode servers request encrypted authenticated login; when that happens, play reports an error instead of pretending to measure gameplay latency.
play is closer to player entry behavior than server-list pong, but it is not a full replacement for a real authenticated client session with Play-state keepalive handling.
Why does an explicit port skip SRV?
This follows common Minecraft client behavior. If a port is provided, the tool connects to that exact host and port instead of querying _minecraft._tcp.
M
Mcping
Codfish789·2 Sterne·
mcping is a headless Minecraft Java latency checker. It does not use ICMP. Instead, it opens a real TCP connection and speaks the Minecraft Java status protocol, which makes the result closer to what
mcping is a headless Minecraft Java latency checker. It does not use ICMP. Instead, it opens a real TCP connection and speaks the Minecraft Java status protocol, which makes the result closer to what a player, proxy, or monitoring system experiences when reaching a server.
Tools
Tools
Noch keine Tool-Liste. Remote-Server erhalten eine nach dem ersten Health-Check.
FAQ
Fragen
Wie installiere ich Mcping?
Kopieren Sie auf dieser Seite die stdio-Konfiguration für Cursor, Claude Desktop, Claude Code oder VS Code. Sie nutzt die Installation des Herausgebers, keinen PlugMCP-Proxy.
In diesem Eintrag ist keine erforderliche Umgebungsvariable aufgeführt.
Welchen Transport verwendet Mcping?
Mcping läuft lokal über stdio.
Wann wurde Mcping zuletzt geprüft?
Zuletzt geprüft: 2026-11-05. mcping is a headless Minecraft Java latency checker. It does not use ICMP. Instead, it opens a real TCP connection and speaks the Minecraft Java status protocol, which makes the result closer to what a player, proxy, or monitoring system experiences when reaching a server.