minecraft-monitor-skill
v0.1.0Monitor Minecraft servers by checking online status, player counts, latency, and version info using the Server List Ping protocol. Use when the user asks to check Minecraft server status, monitor a Minecraft server, verify if a server is online, get player counts, or mentions Minecraft server monito...
Installation
Minecraft Server Monitoring
Quickly check Minecraft server status without installing any external dependencies.
Quick Check
Check if a server is online:
python3 ~/.openclaw/workspace/skills/public/minecraft-monitor/scripts/minecraft-status.py corejourney.org
🟢 corejourney.org:25565 - ONLINE (45ms)
Version: 1.20.4
Players: 3/20
Online: Steve, Alex, CreeperHunter
MOTD: Welcome to Core Journey!
Usage
python3 ~/.openclaw/workspace/skills/public/minecraft-monitor/scripts/minecraft-status.py <host[:port]> [timeout]
- host: Server hostname or IP address (e.g.,
corejourney.org,192.168.1.10) - port: Optional, defaults to
25565 - timeout: Optional connection timeout in seconds (default: 5)
Examples
# Check default port
python3 ~/.openclaw/workspace/skills/public/minecraft-monitor/scripts/minecraft-status.py corejourney.org
# Check custom port
python3 ~/.openclaw/workspace/skills/public/minecraft-monitor/scripts/minecraft-status.py corejourney.org:25566
# Check IP with longer timeout
python3 ~/.openclaw/workspace/skills/public/minecraft-monitor/scripts/minecraft-status.py 192.168.1.10 10
Output
Online server: - 🟢 Green (good ping) / 🟡 Yellow (moderate) / 🟠 Orange (slow) - Server address and port - Response time in milliseconds - Minecraft version - Current/maximum player count - List of online players (up to 5 shown) - Server MOTD (message of the day)
Offline server: - 🔴 Red indicator - Error message (timeout, connection refused, etc.)
What's Being Monitored
- ✅ Online/offline status
- ✅ Player count (current/max)
- ✅ Response time/latency
- ✅ Server version
- ✅ Online player list (if available)
- ✅ Server MOTD
Notes
- Uses Minecraft Server List Ping (SLP) protocol - works with all modern Minecraft servers
- No server-side plugins or RCON access required
- Exit code 0 if online, 1 if offline (useful for scripts/automation)
- SRV records are not automatically resolved - use the actual server address
Integration Ideas
- Add to a cron job for periodic health checks
- Wrap in a monitoring script that alerts if server goes offline
- Use in automation pipelines that depend on server availability
- Create a dashboard showing server status history