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.
Deep links#
Sources: root AGENTS.md, moincraft/docs/moincraft-stack-cheatsheet.md, moincraft/docs/deployment-guide.md, moincraft/docs/operative-manual.md.