CraftClose — AI Minecraft Server Monitor#

AI-powered Minecraft server monitoring — crash detection, auto-restart, and smart alerts.

When to Use#

✅ USE this skill when:

• Monitoring a Minecraft server's health (TPS, players, uptime)
• Diagnosing crashes or performance issues
• Setting up auto-restart on crash detection
• Configuring Telegram bot or Discord webhook alerts
• Analyzing server logs with AI (Gemini)
• Managing servers via Pterodactyl panel
• Checking plugin conflicts or config issues

When NOT to Use#

❌ DON'T use this skill when:

• Bedrock-only servers (Java/Paper servers only)
• Non-Minecraft game servers
• Web application monitoring
• Network diagnostics unrelated to Minecraft

Install#

bash

npm install -g craftclose

Setup#

bash

# Copy example config
craftclose init

# Or manually create craftclose.yml
cp node_modules/craftclose/craftclose.example.yml ./craftclose.yml

Config ( craftclose.yml)#

yaml

servers:
  - name: my-server
    host: 127.0.0.1
    connections:
      ssh:
        port: 22
        username: minecraft
        key_path: ~/.ssh/id_rsa
      rcon:
        port: 25575
        password: changeme
      pterodactyl:
        panel_url: https://panel.example.com
        api_key: ptlc_xxxxx
        server_id: abc123

monitoring:
  interval: 60
  auto_restart: true
  max_restarts: 3
  restart_window: 300

alerts:
  telegram:
    bot_token: "123456:ABC..."
    chat_id: "-100123456"
  discord:
    webhook_url: "https://discord.com/api/webhooks/..."

ai:
  provider: gemini
  api_key: ${GEMINI_API_KEY}

CLI Commands#

bash

# Test all connections
craftclose test

# Check server status
craftclose status

# Start continuous monitoring
craftclose monitor

# View crash/event history
craftclose history

# AI-powered crash analysis
craftclose analyze

# Config optimization suggestions
craftclose optimize

# Check plugin conflicts
craftclose conflicts

# Pterodactyl panel operations
craftclose panel status
craftclose panel restart
craftclose panel console "say Hello"

Key Features#

FeatureDescriptionCrash Detection20+ built-in patterns (OOM, plugin errors, world corruption, etc.)Auto-RestartConfigurable restart on crash with rate limitingAI AnalysisBYOK Gemini for deep crash analysis and optimization3 ConnectionsSSH, RCON, Pterodactyl — use any comboAlertsTelegram bot + Discord webhook notificationsHistoryTPS and player count stored in local SQLiteSecurity6-layer sandbox (path jail, RCON filter, input sanitizer, audit log, action allowlist, confirmation gate)

OpenClaw Integration#

CraftClose is also an OpenClaw skill. When installed globally, OpenClaw can use it to monitor and manage Minecraft servers through natural language.

Links#

• GitHub
• npm
• Discord