A tile-based programming language for creative coding applications.
Mindcraft programs are built by arranging tiles -- typed, composable tokens -- into rules. Each rule has a WHEN side (condition) and a DO side (action). A collection of rules forms a brain that drives an autonomous actor. Host applications extend the language with custom types, sensors, and actuators.
The core library compiles to Roblox (Luau), Node.js, and browser (ESM) targets from a single TypeScript codebase.
Mindcraft draws inspiration from other tile-based programming systems past and present, including Kodu Game Lab, Project Spark (Wiki), and MicroCode.
- Ecosystem Sim -- carnivores, herbivores, and plants driven by user-editable Mindcraft brains
packages/
core/ @mindcraft-lang/core -- language runtime (multi-target)
ui/ @mindcraft-lang/ui -- shared React UI components
docs/ @mindcraft-lang/docs -- shared documentation sidebar and rendering
apps/
sim/ Ecosystem simulation demo
| Package | Description |
|---|---|
| @mindcraft-lang/core | Language runtime -- tiles, parser, compiler, VM (multi-target: Roblox, Node.js, ESM) |
| @mindcraft-lang/ui | Shared React UI -- shadcn/ui primitives + brain editor components |
| @mindcraft-lang/docs | Shared documentation subsystem -- renders as in-app sidebar or full-screen SPA |
| App | Description |
|---|---|
| Ecosystem Sim | Demo: carnivores, herbivores, and plants driven by user-editable Mindcraft brains |
Install the packages you need:
# Core only (language runtime, compiler, VM)
npm install @mindcraft-lang/core
# Core + UI (adds brain editor and shadcn/ui components)
npm install @mindcraft-lang/core @mindcraft-lang/ui
# Full stack (adds documentation sidebar and renderer)
npm install @mindcraft-lang/core @mindcraft-lang/ui @mindcraft-lang/docsFor full setup instructions -- Vite config, TypeScript paths, Tailwind, and component usage -- see the Integration Guide.
Documentation is a work in progress. Browse the sim demo's language documentation online. See also the core package README for language architecture, the ui package README for the shared React components, and the docs package README for the documentation system.
To report a bug or request a feature, please open an issue.