MCSManager Controller for Openclaw

A professional-grade controller for MCSManager-managed Minecraft instances, enabling seamless API-driven server operations, log tailing, and troubleshooting.

szabee13
v1.0.1
Mar 21, 2026
0
830
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install mcsmanager-controller

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install mcsmanager-controller using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is MCSManager Controller?

The MCSManager Controller is a specialized integration designed to bridge AI agents with the MCSManager panel. It provides a structured, safe, and efficient way to manage Minecraft servers without the need for manual panel navigation. This skill focuses on high-reliability operations, prioritizing API interactions over brittle browser automation to ensure consistent results.

As a core component of the Openclaw Skills ecosystem, it emphasizes security and host-side context. It allows developers and server administrators to automate routine tasks such as checking server health, managing whitelists via console commands, and diagnosing complex Java exceptions through automated log analysis.

MCSManager Controller Use Cases

  • Troubleshooting server crashes by automatically fetching and analyzing Java stack traces.
  • Performing graceful restarts or emergency kills on hung Minecraft instances.
  • Automating whitelist management and player moderation via direct console command injection.
  • Monitoring server reachability and instance state for self-healing server architectures.
  • Configuring local instance defaults for rapid multi-server management environments.

How MCSManager Controller Works

  1. Identity Verification: The skill identifies the target instance UUID and panel credentials from user-provided context or a local configuration file.
  2. Pre-flight Check: It performs read-only status checks to verify the MCSManager service reachability and current instance power state.
  3. Log Analysis: Before any state change, it tails or reads the most recent logs to identify existing issues like port bind errors or world corruption.
  4. Action Execution: It sends specific API requests to start, stop, restart, or send console commands based on the identified need.
  5. Validation & Reporting: After execution, it verifies the state change and reports the specific outcome, including relevant log excerpts or error symptoms.

MCSManager Controller Setup

To get started with this member of the Openclaw Skills library, follow these steps:

  1. Locate the skill directory in your agent workspace.
  2. Create your local configuration file by copying the example:
cp config.example.json config.json
  1. Edit config.json to include your MCSManager panel URL, API token, and default instance UUID.
  2. Ensure references/api-notes.md is present for fallback request patterns.

MCSManager Controller Data Schema & Taxonomy

The skill manages server interaction through a structured configuration and reference system:

File Purpose Access Level
config.json Stores local API credentials and instance defaults. User-managed
config.example.json Template for environment configuration. Read-only
references/api-notes.md Contains technical request patterns and version-specific notes. Internal Reference

Data processed includes instance power states, real-time log buffers, and console command strings.

MCSManager Controller Advanced Features

  • Graceful Shutdown Protocol: Prioritizes soft stop commands over process killing to prevent world data corruption.
  • Log Parsing Engine: Specifically identifies Java exceptions and plugin-related startup failures to provide actionable insights.
  • Multi-Server Config Support: Allows for switching between different server instances using specific local configuration keys.
  • Host-Side Fallback: If the API is unreachable, it can leverage host-side details to perform process-level health checks.
  • Batch Command Serialization: Prevents panel flooding by serializing multiple console commands into controlled execution streams.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*