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:

enable-rcon=true
rcon.port=25575
rcon.password=STRONG_PASSWORD_HERE
broadcast-rcon-to-ops=false

Environment Variables

CODEBLOCK2

Verify Connection

CODEBLOCK3

Operation Categories

PLAYER MANAGEMENT

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: INLINECODE4
• temp ban: /ban <player> [reason] + calendar note
• permanent ban: INLINECODE6
• ban IP: INLINECODE7
• unban: /pardon <player> or INLINECODE9
• whitelist add: INLINECODE10
• whitelist remove: INLINECODE11
• op player: /op <player> ⚠️ HIGH PRIVILEGE — always confirm
• deop player: INLINECODE13

Item & State Management

• - give items: INLINECODE14
• clear inventory: INLINECODE15
• set gamemode: INLINECODE16
• teleport: /tp <player> <x> <y> <z> or INLINECODE18
• set health/hunger: INLINECODE19
• heal player: INLINECODE20

WORLD MANAGEMENT

Time & Weather

• - day: INLINECODE21
• night: INLINECODE22
• sunrise: INLINECODE23
• clear weather: INLINECODE24
• rain: INLINECODE25
• thunder: INLINECODE26

World State

• - save world: /save-all (always do before maintenance)
• save-off (for backup): /save-off then backup then INLINECODE29
• change difficulty: INLINECODE30
• set game rule: INLINECODE31

• - find structure: INLINECODE35
• fill area: /fill <x1 y1 z1> <x2 y2 z2> <block> ⚠️ Confirm range before running

Entity Management

• - kill all mobs: /kill @e[type=!player] ⚠️ Confirm — kills all non-players
• kill specific type: INLINECODE38
• remove dropped items: INLINECODE39

BROADCAST & COMMUNICATION

• - server message: /say <message> (prefixed with [Server])
• title on screen: INLINECODE41
• subtitle: INLINECODE42
• private message: INLINECODE43
• actionbar: INLINECODE44

PERFORMANCE MONITORING

When asked about server performance:

1. 1. Execute /list → check player count
2. Read MC_SERVER_LOG file (last 200 lines) if path set
3. Look for patterns in INLINECODE47
4. Report: TPS warnings, error frequency, player activity spikes

Safety Protocols

Confirmation required for all destructive/high-privilege commands:

CODEBLOCK4

Operations requiring confirmation:

• - ban, ban-ip — permanent account restriction
• INLINECODE50 — grants admin privileges
• INLINECODE51 — large area modification
• INLINECODE52 — entity mass-removal
• INLINECODE53 — server shutdown
• INLINECODE54 — pauses auto-save (dangerous if forgotten)

Audit logging: After each operation, append to OpenClaw Memory:

## Server Admin Log [ISO timestamp]
- Command: /ban PlayerX "repeated griefing"
- Executed by: [OpenClaw user]
- Result: success

Response Formatting

Player List (/list response)

Kicked/Banned confirmation

Error Responses

• - Connection refused → check RCON settings, server running?
• Authentication failure → wrong MCRCONPASSWORD
• Command returned empty → server may not have recognized command (check version)

Log Analysis

When user asks about server health or player history:

1. 1. Check MC_SERVER_LOG is set and file exists
2. Read the last N lines: INLINECODE57
3. Apply patterns from INLINECODE58
4. Summarize findings:

CODEBLOCK8

Additional Resources

• - references/commands.md — All vanilla commands with syntax and permission level
• INLINECODE60 — Common log patterns and what they mean
• INLINECODE61 — RCON client (used by all commands above)
• INLINECODE62 — Log parsing utilities