How augustzhang1/ai-builder-minecraft works
AI-Builder-Minecraft is a separate Python service that turns Minecraft chat commands into AI-designed or image-derived block builds, previews them, and places them through RCON. The graph preserves the documented design/render/voxelize/preview/place workflow and major command families. The README and source index support the main orchestration links; some specialized internal handoffs are not visible in the sampled excerpts and are left unconnected or marked unverified.
Main entry points: main.py Command orchestrator · edit_prompt.py AI build edits · build.py Mesh voxelizer · interior.py Interior analysis
Components 23
Command Service
- Command orchestrator
mcmcp/main.py - Settings
mcmcp/config.py
Design and Geometry
- AI design and review
mcmcp/llm.py - OpenSCAD renderer
- Mesh voxelizer
mcmcp/build.py - Build preview
mcmcp/preview.py - Figure posing and color
mcmcp/figure.py
Build Editing
- Interior analysis
mcmcp/interior.py - AI build edits
mcmcp/edit_prompt.py - Edit operations
mcmcp/edit_ops.py - Edit undo
mcmcp/edit_undo.py - World region reader
mcmcp/region.py
Image and Statue
- Pixel-art converter
mcmcp/pixelart.py - Statue generation
mcmcp/statue.py - Statue voxelizer
mcmcp/statue_grid.py - Face and eye coloring
mcmcp/statue_eyes.py
World Interaction
- Saved designs
mcmcp/saves.py - Schematic export
mcmcp/schem.py - RCON client
mcmcp/rcon.py - Build animation
mcmcp/animate.py - Preview hologram
mcmcp/ghost.py
Other components
- Minecraft operator
- Minecraft server
Connections 27
- Minecraft operator → Command orchestrator: sends commands
README.md - Command orchestrator → AI design and review: requests design
README.md - Command orchestrator → Mesh voxelizer: renders and voxelizes
README.md - Mesh voxelizer → OpenSCAD renderer: renders meshes
mcmcp/build.py - Command orchestrator → Build preview: shows preview
README.md - Command orchestrator → RCON client: sends game commands
README.md - RCON client → Minecraft server: executes commands
README.md - Command orchestrator → Settings: reads settings
mcmcp/main.py - Command orchestrator → Figure posing and color: poses figures
mcmcp/main.py - Command orchestrator → Interior analysis: requests furnishing
mcmcp/main.py - Command orchestrator → AI build edits: requests edits
mcmcp/main.py - Command orchestrator → Edit operations: applies edits
mcmcp/main.py - Command orchestrator → Edit undo: undoes edits
mcmcp/main.py - Command orchestrator → World region reader: reads build region
mcmcp/main.py - Interior analysis → Mesh voxelizer: stamps details
mcmcp/interior.py - AI build edits → AI design and review: requests changes
mcmcp/edit_prompt.py - AI build edits → Interior analysis: uses analysis
mcmcp/edit_prompt.py - AI build edits → Build preview: renders edit views
mcmcp/edit_prompt.py - Command orchestrator → Pixel-art converter: converts image
mcmcp/main.py - Command orchestrator → Statue generation: requests statue
mcmcp/main.py - Statue generation → Statue voxelizer: voxelizes mesh
- Statue voxelizer → Face and eye coloring: paints statue eyes
mcmcp/statue_grid.py - Command orchestrator → Saved designs: saves and loads
mcmcp/main.py - Command orchestrator → Schematic export: exports schematic
mcmcp/main.py - Command orchestrator → Build animation: animates building
mcmcp/main.py - Build animation → RCON client: sends game commands
mcmcp/animate.py - Command orchestrator → Preview hologram: manages hologram
mcmcp/main.py