MinePilot

MinePilot is an AI build planner for Minecraft.

It uses CraftDAG to turn building ideas into small Minecraft build plans with 3D preview, material lists, layer-by-layer guides, and Java Edition export paths.

MinePilot is the user-facing app. CraftDAG is the open core engine.

Mental model

User idea
→ prompt/template flow
→ CraftDAG document
→ Voxel Plan
→ preview / materials / layers / download path

MinePilot is not a general Minecraft game agent. It should not start by controlling a live bot. The first version is web-first.

Key docs

Start here:

• Product Brief
• Implementation Plan
• Project Roadmap
• Golden Prompt Suite

Relationship with CraftDAG

CraftDAG = open core engine
MinePilot = user-facing product and playground

MinePilot should consume CraftDAG packages and should not duplicate compiler logic.

Cloudflare Workers deployment

MinePilot deploys to Cloudflare Workers through the Cloudflare OpenNext adapter.

For Cloudflare Workers Builds, configure the build command as:

pnpm run deploy

The normal pnpm run build command only runs next build; it is useful for framework validation, but it does not generate or deploy the Worker bundle. The Cloudflare command must run OpenNext so it creates .open-next/worker.js and deploys with Wrangler.

Useful local commands:

pnpm run build:cloudflare
npx wrangler deploy --dry-run
pnpm run preview

Initial product target

A user should be able to:

1. type a small Minecraft build idea
2. preview the generated build
3. inspect materials
4. inspect layers
5. eventually download a Java Edition-friendly output file

Early non-goals

• no authentication
• no payments
• no live Minecraft bot
• no survival automation
• no Bedrock support
• no redstone generation
• no large city generation