How kolbytn/mindcraft works
Mindcraft runs configurable LLM-driven Minecraft agents: a user starts agents from profiles or a task, which act in a Minecraft world and can be evaluated against task goals. The graph preserves the documented model-provider choices, task domains, vision, NPC behavior, and Python interface. The excerpts show task validation and action management, but omit much of the runtime wiring; uncertain links are therefore left out.
Main entry points: agent.js Minecraft agent · conversation.js Conversation · tasks.js Task orchestration · main.js Startup and profiles
Components 24
Agent runtime
- Startup and profiles
main.js - Runtime coordinator
src/mindcraft/mindcraft.js - Agent process
src/process/agent_process.js - Agent initialization
src/process/init_agent.js - Minecraft agent
src/agent/agent.js
Reasoning and actions
- Conversation
src/agent/conversation.js - History and memory
src/agent/history.js - Prompt construction
src/models/prompter.js - Model selection
src/models/_model_map.js - Action execution
src/agent/action_manager.js - Agent commands
src/agent/commands/index.js
Minecraft interaction
- Skills library
src/agent/library/skills.js - World access
src/agent/library/world.js - Vision interpretation
src/agent/vision/vision_interpreter.js - World camera
src/agent/vision/camera.js
Tasks and goals
- Task orchestration
src/agent/tasks/tasks.js - Construction validation
src/agent/tasks/construction_tasks.js - Cooking tasks
src/agent/tasks/cooking_tasks.js - NPC goal controller
src/agent/npc/controller.js
External interfaces
- LLM provider adapters
src/models - Minecraft server
- MindServer interface
src/mindcraft/mindserver.js - Python interface
src/mindcraft-py/mindcraft.py
Other components
- Operator
Connections 26
- Operator → Startup and profiles: starts
- Startup and profiles → Runtime coordinator: initializes agents
- Startup and profiles → Task orchestration: loads task
- Runtime coordinator → Agent process: creates process
- Agent process → Agent initialization: initializes
- Agent initialization → Minecraft agent: configures
- Minecraft agent → Conversation: runs dialogue
- Conversation → History and memory: records turns
- Conversation → Prompt construction: builds prompts
- Conversation → Model selection: selects model
- Model selection → LLM provider adapters: dispatches request
- Minecraft agent → Action execution: manages actions
- Action execution → Minecraft agent: controls execution
- Minecraft agent → Agent commands: handles commands
- Agent commands → Skills library: calls skills
- Skills library → World access: uses world access
- World camera → Vision interpretation: supplies images
- Task orchestration → Construction validation: validates builds
- Task orchestration → Cooking tasks: starts cooking task
- Task orchestration → Agent commands: sets goals
- NPC goal controller → Skills library: uses skills
- NPC goal controller → World access: queries world
- Minecraft agent → Minecraft server: acts in world
- Runtime coordinator → MindServer interface: starts interface
- Python interface → MindServer interface: connects
- LLM provider adapters → Minecraft server