Nova
87a9013ffb
- Basic server status checking (online/offline) - Player counts, latency, version info - Example: corejourney.org - No external dependencies required
2.7 KiB
2.7 KiB
name, description
| name | description |
|---|---|
| minecraft-monitor | Monitor 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 monitoring. Example servers include corejourney.org. |
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