moincraft

🎮 Operator Runbook

Safe operator commands, in-game bot commands, verification ladder, and emergency moves.

Local command ladder# 

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

Use runtime mutating scripts only when the task is operational:

./launch_all.sh
./verify_stack.sh
./stop_all.sh

In-game command basics#

Command Use
!stop Halt current bot actions.
!come / !goToPlayer Move bot to player.
!inventory Inspect carried items.
!stats Inspect health/food/location basics.
!goal <description> Set a high-level natural-language goal.
!task Interact with structured task execution.
!newAction(description) Let the code model synthesize a sandboxed Mineflayer action.

Prompting rules#

  • Be specific: “Find a cave below Y=50 and mine iron ore” beats “mine iron”.
  • Break complex work into chained goals.
  • Mention relevant tools/items when they matter.
  • Use !stop before issuing conflicting movement/action instructions.

Emergency moves#

Situation First move
Bot stuck in a loop Send !stop in chat.
Bot unresponsive Verify relay/MindServer first, then consider process-level recovery.
Server crashed Use the project runbook; stop/start intentionally.
Token/model cost concern Reduce profile scope/model intensity before broad restarts.

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