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
npm install -g craftclose
Setup
# Copy example config
craftclose init
# Or manually create craftclose.yml
cp node_modules/craftclose/craftclose.example.yml ./craftclose.yml
Config (craftclose.yml)
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
# 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
| Feature | Description |
|---|---|
| Crash Detection | 20+ built-in patterns (OOM, plugin errors, world corruption, etc.) |
| Auto-Restart | Configurable restart on crash with rate limiting |
| AI Analysis | BYOK Gemini for deep crash analysis and optimization |
| 3 Connections | SSH, RCON, Pterodactyl — use any combo |
| Alerts | Telegram bot + Discord webhook notifications |
| History | TPS and player count stored in local SQLite |
| Security | 6-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.