mcstatusio 1.0.0

A Python wrapper for the mcstatus.io API.

MCStatusio

A Python wrapper for mcstatus API.

Installation

You can install the package via pip:

pip install mcstatusio

Usage

Bedrock Server Status

from mcstatusio import BedrockServer

server = BedrockServer("play.example.com", 19132)
status = server.status()

if not status.online:
    print("The server is offline.")
else:
    print(f"The server has {status.players.online} players online.")

Java Server Status

from mcstatusio import JavaServer

server = JavaServer("play.example.com", 25565)
status = server.status()

if not status.online:
    print("The server is offline.")
else:
    print(f"The server has {status.players.online} players online.")

Async Usage

Bedrock Server Status

import asyncio
from mcstatusio import BedrockServer

server = BedrockServer("play.example.com", 19132)
status = asyncio.run(server.async_status())

if not status.online:
    print("The server is offline.")
else:
    print(f"The server has {status.players.online} players online.")

Java Server Status

import asyncio
from mcstatusio import JavaServer

server = JavaServer("play.example.com", 25565)
status = asyncio.run(server.async_status())

if not status.online:
    print("The server is offline.")
else:
    print(f"The server has {status.players.online} players online.")

License

This project is licensed under the MIT License. See the LICENSE file for details

Contributing

Contributions are welcome! Please open an issue or submit a pull request on GitHub.