Skip to content

Home

Jump to bottom
darkboy0p edited this page Feb 7, 2026 · 3 revisions

🎮 Minecraft Server Utility - Complete Documentation

📖 Introduction & Features

What is Minecraft Server Utility?

Minecraft Server Utility is a comprehensive Python library for interacting with Minecraft servers. It provides a simple, consistent API for server monitoring, player lookups, and Mojang API integration.

PyPI Package: https://pypi.org/project/minecraft-server-utility/

✨ Key Features

🎯 Server Monitoring

  • ✅ Status Checking: Check if server is online/offline
  • ✅ Player Information: Get player count and list
  • ✅ Server MOTD: Retrieve Message of the Day
  • ✅ Version Info: Get server version and protocol
  • ✅ Latency: Measure ping time in milliseconds
  • ✅ Multi-Edition: Support for Java and Bedrock Edition
  • ✅ Cross-Platform: Works on Windows, macOS, Linux

👤 Player Management

  • ✅ UUID Lookup: Get player UUID from username
  • ✅ Skin Data: Retrieve player skin and cape URLs
  • ✅ Name History: Get player's name change history
  • ✅ Profile Data: Comprehensive player information
  • ✅ Search: Find specific players across servers

🔧 Technical Features

  • ✅ Async Support: Built-in async/await support
  • ✅ Error Handling: Comprehensive exception system
  • ✅ Type Hints: Full Python type annotations
  • ✅ Caching: Intelligent response caching
  • ✅ Logging: Configurable logging system

📦 Installation

Basic Installation

pip install minecraft-server-utility

With Optional Features

# With Discord bot support
pip install minecraft-server-utility[discord]

# With web API support
pip install minecraft-server-utility[web]

# With CLI tools
pip install minecraft-server-utility[cli]

# Development dependencies
pip install minecraft-server-utility[dev]

# Everything
pip install minecraft-server-utility[all]

Python Version Compatibility

Python Version Supported Notes
3.7+ ✅ Yes Full support
3.6 ⚠️ Limited Some features may not work
2.7 ❌ No Not supported

Clone this wiki locally