Moincraft Research Lab — Architecture

LLM-powered autonomous Minecraft bot swarm · 4 agents · 5 services · real-time telemetry

👤 Operator Hermes / Human Browser / Discord ☁️ OpenRouter LLM API Gateway openrouter.ai/api/v1 ⚡ Groq Fast LLM Inference api.groq.com 🔄 GitHub CI Static checks .github/workflows 🔒 Debian Cloud Host (headless) · moincraft.de · PM2 supervised 🖥️ Svelte 5 Dashboard Vite dev server · TailwindCSS · :55666 Agent cards · POV viewer · Command palette · Settings Chart.js · xterm.js · Socket.IO client bots/dashboard/ 🔌 Dashboard Relay Express + Socket.IO · :55667 REST API · RCON bridge · Rate limiting · CORS SQLite stats · Redis optional history bots/dashboard.js 🧠 MindServer Express API · Agent registry · :55668 Profile CRUD · Settings hot-swap · WebSocket bots/src/mindcraft/mindserver.js 🤖 Groqqo Llama 3.3 70B · Explorer Groq API 🤖 Groqqi Llama 3.1 8B · Builder Groq API 🤖 Gemmiii Gemini 2.0 Pro · Diplomat OpenRouter 🤖 Gemmiij Gemini 2.0 Flash · Warrior OpenRouter 🤝 Cooperation Framework: L1 Broadcast → L5 Hivemind ⛏️ Paper MC Server 1.21.11 Java 21 · G1GC · :25565 TCP/UDP World spawn · RCON :25575 · Plugins: Spark, Dynmap, Chunky Fabric Tailor (skins) · offline-mode server/ 👁️ Prismarine Viewer Three.js + WebGL · :55669 HTTP Spectator bot · Version compat layer (1.21.11→1.21.4) Per-agent POV · Exponential backoff reconnect bots/viewer.js ⚙️ PM2 Process supervisor · ecosystem.config.cjs 4 services: spigot, dashboard, viewer, swarm pm2 start/restart/logs/save 💾 Redis Optional hot state docker-compose.redis.yml History store · Pub/Sub 🗃️ SQLite Stats history · JSONL events metrics.db · Daily rollups better-sqlite3 📚 Hugo Wiki Shadocs theme · :1313 16 pages · Architecture docs npm run wiki HTTPS WSS WS LLM API calls CI/CD iframe / proxy Legend Frontend (Svelte) Backend / Agents MC Server / Viewer Data / Infra External Message Bus Sync call Async / LLM API Security boundary Ports: 25565 (MC) · 55666 (Dashboard) · 55667 (Relay) · 55668 (MindServer) · 55669 (Viewer)

Frontend Layer

  • • Svelte 5 + Vite + TailwindCSS
  • • Real-time Socket.IO client
  • • Agent cards, POV viewer, command palette
  • • Chart.js metrics + xterm.js console
  • • Iframe-embedded Prismarine viewer

Agent Layer

  • • 4 LLM-driven Mineflayer bots
  • • Groqqo (70B Explorer) + Groqqi (8B Builder)
  • • Gemmiii (Pro Diplomat) + Gemmiij (Flash Warrior)
  • • 5-level cooperation framework
  • • RAG-enhanced code generation (SES sandbox)

Infrastructure

  • • Paper 1.21.11 + Java 21 + G1GC
  • • Prismarine Three.js WebGL viewer
  • • PM2 process supervisor (4 services)
  • • SQLite stats + optional Redis hot state
  • • nginx reverse proxy + TLS