cswimr

Overview Repositories

39

Projects Packages

9

Public activity Starred repositories

26

pymcsrvstatus (1.1.2)

Published 2025-06-29 09:03:54 -04:00 by cswimr in cswimr/pymcsrvstatus

Installation

To install the package using pip, run the following command:

pip install --index-url  pymcsrvstatus

For more information on the PyPI registry, see the documentation.

About this package

An async API wrapper for the mcsrvstat.us API.

pymcsrvstatus

A simple async API wrapper for the mcsrvstat.us API.

Usage

from pymcsrvstatus import check_if_online, fetch, get_icon_url
import asyncio

async def example(address: str) -> None:
    if await check_if_online(address, extra_user_agent="pymcsrvstatus example"):
        print("Hypixel is online!")
    else:
        print("Hypixel is offline!")

    status = await fetch(address, extra_user_agent="pymcsrvstatus example")
    assert status.online is True
    print(status.protocol) # Protocol(version=47, name="1.8.9")
    print(status.version) # "Requires MC 1.8 / 1.21"
    print(status.players) # Players(online=33812, max=200000, players=None)

    print(get_icon_url(address)) # https://api.mcsrvstat.us/icon/hypixel.net

asyncio.run(example(address="hypixel.net"))

Requirements

Requires Python: >=3.9

Details

PyPI

cswimr/pymcsrvstatus

2025-06-29 09:03:54 -04:00

292

Project website

20 KiB

Assets (2)

pymcsrvstatus-1.1.2-py3-none-any.whl 11 KiB

pymcsrvstatus-1.1.2.tar.gz 9.2 KiB

Versions (9) View all

2.0.1 2026-09-09

2.0.0 2026-09-09

1.1.3 2025-06-29

1.1.2 2025-06-29

1.1.1 2025-06-29

Issues