minecraft-server-admin

# Minecraft Server Admin

**Scope**: This skill is your **in-game remote control** for a Minecraft Java server.
It sends commands through the RCON protocol to manage players, world state, and
server communication in real time. It intentionally excludes server-infrastructure
operations such as process lifecycle management, filesystem backups, plugin jar
installation, and continuous uptime monitoring; use a dedicated PaperMC ops skill
for those. This skill does NOT require minecraft-bridge — it communicates directly
with the server's admin console over a separate TCP connection.

**Architecture**:
```
OpenClaw → RCON TCP (port 25575) → Minecraft Server Console
```

---

## Prerequisites

### Enable RCON on the Server

Edit `server.properties`:
```properties
enable-rcon=true
rcon.port=25575
rcon.password=STRONG_PASSWORD_HERE
broadcast-rcon-to-ops=false
```
Restart server after changing these values.

### Environment Variables

```
MC_RCON_HOST=localhost        # Server IP or hostname
MC_RCON_PORT=25575            # RCON port (must match server.properties)
MC_RCON_PASSWORD=yourpassword # RCON password (must match server.properties)
MC_SERVER_LOG=/path/to/server/logs/latest.log  # optional, for log analysis
```

### Verify Connection

```bash
node ~/.openclaw/skills/minecraft-server-admin/scripts/rcon.js "list"
# Expected: "There are N of a max of M players online: ..."
```

---

## Operation Categories

### PLAYER MANAGEMENT
For any player-related command, use: `scripts/rcon.js "<command>"`

**Listing & Checking**
- "who is online" → `/list` → parse player count and names
- "is [player] online" → `/list` then check if name appears

**Access Control** ⚠️ Requires confirmation before executing:
- kick: `/kick <player> [reason]`
- temp ban: `/ban <player> [reason]` + calendar note
- permanent ban: `/ban <player> [reason]`
- ban IP: `/ban-ip <player|ip> [reason]`
- unban: `/pardon <player>` or `/pardon-ip <ip>`
- whitelist add: `/whitelist add <player>`
- whitelist remove:...