Skip to main content

mcping

Minecraft server status query tool supporting both Java and Bedrock editions.

Installation

pip install 100-mcping

Usage

# Java Edition
mcping hypixel.net

# Specify port
mcping my.server.com -p 25565

# Bedrock Edition
mcping play.hydrogen.rip -p 19132 --bedrock

# Output JSON
mcping hypixel.net --json

# Other options
mcping my.server.com --player-limit 20   # Show more players
mcping my.server.com --no-players        # Hide player list
mcping my.server.com --no-srv           # Disable SRV resolution
mcping my.server.com --timeout 15        # Adjust timeout

As a Python Library

import asyncio
from mcping.java_ping import mcping as java_ping
from mcping.bedrock_ping import mcping_bedrock

async def main():
    # Java Edition
    result = await java_ping("hypixel.net")
    if result.success:
        print(f"Latency: {result.latency_ms}ms")
        print(f"Online: {result.players_online}/{result.players_max}")

    # Bedrock Edition
    result_bedrock = await mcping_bedrock("play.hydrogen.rip", 19132)
    if result_bedrock.success:
        print(f"Latency: {result_bedrock.latency_ms}ms")

asyncio.run(main())

Options

Option Description Default
host Server address Required
-p, --port Port Java: 25565 / Bedrock: 19132
-b, --bedrock Bedrock Edition
--timeout Timeout in seconds 10
--player-limit Max players to show 5
--no-players Hide player list
--no-srv Disable SRV resolution
--json JSON output

License

GPLv3

Release files for 100-mcping 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for 100-mcping 1.0.0
File Size Uploaded
100_mcping-1.0.0.tar.gz 8.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for 100-mcping 1.0.0
File Interpreter ABI Platform
100_mcping-1.0.0-py3-none-any.whl Python 3 none any Details

Total release size: 19.6 kB

Release files / 100_mcping-1.0.0.tar.gz

Download URL 100_mcping-1.0.0.tar.gz
Size 8.6 kB
Tags Source
SHA-256 checksum
How to use checksums
9ca2e62cb453537014308cbf1abce257fbf92b0f5ca32ab762b7552b6591aefc
BLAKE2b-256 checksum
How to use checksums
f95709178366ce6337f98c4d3d67a6f074b4506e2a53834106efa63621899339
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.12

Release files / 100_mcping-1.0.0-py3-none-any.whl

Download URL 100_mcping-1.0.0-py3-none-any.whl
Size 11.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
45a46f0c12e80ac5f1b9989333bf8efd5b5594e83b646a8119f40634656b3733
BLAKE2b-256 checksum
How to use checksums
5180ad8c025c9381fb371aa64917c7c1ba273a3005f975a3a65f004a1f1cead0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.12

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page