projects

⛏️ Moincraft

Minecraft/Mineflayer/LLM agent runtime: Paper, relay, dashboard, viewer, MindServer, PM2, and docs.

Root: /home/mc/moincraft
Role: Minecraft research/runtime stack for LLM-controlled Mineflayer bots, a Paper server, relay API, dashboard UI, and Prismarine viewer.

Moincraft no longer owns the global operator wiki source. Workspace-wide wiki commands live in /home/mc/wiki; Moincraft commands below are runtime checks and live-service operations only.

Owns#

  • bots/ — ESM Node Mineflayer runtime, MindServer, relay (dashboard.js), profiles, settings, global viewer.
  • bots/dashboard/ — SvelteKit/Svelte 5 dashboard backed by Socket.IO and relay APIs.
  • server/ — Paper/Spigot runtime state and Minecraft world.
  • docs/ — Moincraft-specific operator docs and architecture notes.
  • launch_all.sh, stop_all.sh, verify_stack.sh — live-service scripts; use intentionally.
  • ecosystem.config.cjs — PM2 map for Paper, relay, viewer, swarm, and dashboard services.

Public service map#

Port Service
25565 Paper Minecraft server
55666 Svelte dashboard UI
55667 Dashboard relay / Socket.IO API
55668 MindServer agent hub
55669 Prismarine WebGL viewer
55661+ Per-agent viewer ports

Operator commands#

cd /home/mc/moincraft
npm run check
npm run build
npm run verify
npm run contract
npm run green

Runtime start/stop commands (./launch_all.sh, ./stop_all.sh, PM2 commands) mutate live service state.

Sources: root AGENTS.md, moincraft/docs/moincraft-stack-cheatsheet.md, moincraft/docs/deployment-guide.md, moincraft/docs/operative-manual.md.