Moincraft Research Lab

🧪 Moincraft Research Lab#

Autonomous LLM agents playing Minecraft, coordinated through a multi-layer observability stack.

Moincraft is a private research lab running LLM-driven Mineflayer bots inside a Paper 1.21.11 Minecraft server, observed through a real-time Svelte dashboard, Prismarine 3D viewer, and structured JSONL event telemetry. The project explores multi-agent cooperation, emergent swarm intelligence, and autonomous goal-directed behavior in a sandboxed 3D world.

🚀 Quick Start#

cd ~/moincraft
./launch_all.sh          # Start full stack
./verify_stack.sh        # Health check all services

Stack verification: npm run green (check + build + verify + relay contract)

📡 Service Endpoints#

🤖 Active Bots#

🧠 Research Focus#

• Multi-agent cooperation — 5-level framework from broadcast → collective intelligence
• Emergent protocol evolution — bots invent shorthand via frequency analysis
• Behavioral fingerprinting — LLM decision strategy profiling
• Autonomous goal pursuit — SelfPrompter loop with STOPPED/ACTIVE/PAUSED states
• RAG-enhanced code generation — skill library + example retrieval for !newAction

📚 Documentation#

• Architecture Deep-Dive — full stack, ports, lifecycle
• Agent Systems — modes, commands, cooperation framework
• Dashboard & Telemetry — Svelte UI, JSONL events, analytics
• Deployment & Operations — runbook, troubleshooting
• MineCollab Protocol — task types, benchmarks, evaluation
• Security Hardening — RCON, auth, firewall
• Error Logging & Debugging — log4j2, PM2, Chrome DevTools

🌍 External Links#

• Dashboard (Primary)
• MindServer
• Prismarine Viewer
• Architecture Diagram — dark-themed SVG system overview