mcnexus 1.1.0

A high-performance, asynchronous Python library for Minecraft server management (RCON, Status, SLP).

mcnexus

Production-ready, high-performance asynchronous Minecraft library for Python.

---

🚀 Overview

mcnexus is a modern Python library built from the ground up to provide reliable, asynchronous tools for interacting with Minecraft servers. Whether you are building a monitoring dashboard, a cross-server chat system, or a complex management bot, mcnexus has you covered.

Key Features

• ✅ Robust RCON: Handles multi-packet responses (up to 4KB+) and automatic reconnection.
• 🌍 Server Status (SLP): Full support for Modern (1.7+) and Legacy (pre-1.7) protocols.
• 📡 DNS & SRV Support: Automatically resolves records like mc.hypixel.net to the correct IP and port.
• ⚡ Async-First: Built on top of asyncio for high-concurrency environments.
• 💎 Clean API: Beautiful, documented models and developer-friendly error messages.

---

📦 Installation

pip install mcnexus

---

📖 Documentation

For full documentation and API reference, visit:
👉 https://bogdan11212.github.io/mcnexus/

---

⚡ Quick Start

Get Server Status

import asyncio
from mcnexus import status

async def main():
    info = await status("mc.hypixel.net")
    if info.online:
        print(f"[{info.ping:.1f}ms] {info.players_online}/{info.players_max} players online.")
        print(f"MOTD: {info.motd_clean}")

asyncio.run(main())

Run RCON Commands

from mcnexus import RCONClient

async def run_rcon():
    async with RCONClient("127.0.0.1", 25575, "secret_password") as rcon:
        response = await rcon.command("list")
        print(response.clean)

---

🤝 Contributing

Contributions are welcome! Please check out our Contributing Guidelines and Code of Conduct.

📄 License

mcnexus is released under the MIT License. See LICENSE for details.