360 Secure SkillHub
360 安全技能中心

Minecraft Monitor

运行自带 Python 脚本,按 Server List Ping 协议查询指定 Minecraft 服务器的在线状态、延迟、版本、玩家数量、在线玩家列表与 MOTD,输出带颜色标记的文本结果,并以退出码区分在线与离线。文档强调无需服务器端插件或 RCON,并给出定时巡检、告警等集成建议。

wmantly
wmantly
热度 82.51
最近更新 2026-05-11 16:25:06
分类:自动化依赖:代码执行应用场景:自动化脚本 / 工作流

安装技能

复制下面的话术发给你的 Agent,它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill: npx secure-skills-cli add minecraft-monitor-skill
Metadata
name
minecraft-monitor
description
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