⛏️ McPorter Gateway

Contrôle de Jeu · Noyau RCON · Radar d'État

A smart agent gateway built specifically for Minecraft servers. Through it, LLMs can monitor server online dynamics 24/7, and even execute punishment mechanisms and world-level broadcast commands directly via RCON backend penetration.

Équipe OpenClaw

🚀 Installation Rapide

Exécutez la commande suivante dans votre terminal pour installer :

npx clawhub install mcporter

📊 Aperçu des Statistiques

⭐ Étoiles	☁️ Appels Totaux	👥 Utilisateurs Actifs	🎯 Version Stable
458	12.9k	680	v1.1.5

🎛️ Comment ça Marche

McPorter is a secure gateway bridging the real world and the virtual block world, composed of two core capabilities:

🟢 Zero-load Ping Query Protocol: When you need to check server status or player online lists, it won't burden the server's compute pool. McPorter uses the native Server List Ping protocol, returning MOTD, version, max capacity, and current online player UUID lists to AI within seconds as read-only parameters.
🔌 RCON High-privilege Command Channel: Supports bridging with RCON ports of all major frameworks including Bukkit / Spigot / Paper / Fabric. AI can construct legitimate command strings and send them directly (such as /weather clear, /give, or /ban), and feed the console return strings back into the LLM.
🛡️ Headless Daemon Mounting: No need to occupy the OS's graphical interface or dedicated AFK bots — the script runs purely at the Node.js layer.
🎮 Multi-version Protocol Backward Compatibility: Even if your server is still on ancient golden versions like 1.8 or 1.12.2, this plugin's cross-generation protocol layer guarantees perfect handshake connections.

🧭 Cas d'Usage Typiques

👮 Scénario 1: AI Moderation & Chat Monitoring

By hooking into chat, the LLM can become an omniscient server supervisor. When the Agent detects a player posting malicious or inappropriate content in game chat or community channels, it triggers judgment logic: immediately mounts mcporter's RCON channel, sends /kick <player> Warning: inappropriate language or triggers higher-level bans — all with zero human intervention.

📊 Scénario 2: Cross-channel Ecosystem Reports

For guild or community managers: use Cron scheduled tasks. Every evening during prime time, have the model call mcporter to collect the online player list and server TPS values, then craft a brief report in a warm, humorous tone to send to WeChat or Slack: "Tonight 30 legends are online battling, TPS running at full capacity — jump in and build together!"

💻 Référence des Commandes

Après l'installation, vous pouvez laisser l'IA les appeler de manière autonome via la conversation, ou déclencher manuellement des opérations depuis la CLI :

Probe mode — send harmless Ping packets to extract real-time world metadata:

clawhub execute mcporter action="status" \
  server="play.hypixel.net" port=25565

Command mode — log into the high-privilege RCON bridge to send execution strings:

clawhub execute mcporter action="rcon" \
  server="192.168.1.100" rcon_port=25575 \
  command="/broadcast &a[ServerAI] Weekend exp boost activated!"

🛡️ Prérequis et Configuration

🔓 Read-only No Auth: If only using action="status" for queries, the target server requires no additional configuration.
⚙️ Enable RCON: For AI to gain control (action="rcon"), you must go to the MC server's server.properties file, manually set enable-rcon=true, configure a strong rcon.password, and set corresponding environment variables when running the Agent to prevent password leaks.

🔗 Voir le Code sur GitHub