https://github.com/humanapp/mindcraft-lang
Mindcraft -- a tile-based visual programming language for creative coding applications
https://github.com/humanapp/mindcraft-lang
coding creative-coding game-development kodu luau microcode mindcraft programming-language project-spark roblox robotics stem tile-based typescript visual-programming
Last synced: 2 days ago
JSON representation
Mindcraft -- a tile-based visual programming language for creative coding applications
- Host: GitHub
- URL: https://github.com/humanapp/mindcraft-lang
- Owner: humanapp
- License: mit
- Created: 2026-02-24T00:30:32.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-02T04:42:02.000Z (12 days ago)
- Last Synced: 2026-04-02T05:04:40.317Z (11 days ago)
- Topics: coding, creative-coding, game-development, kodu, luau, microcode, mindcraft, programming-language, project-spark, roblox, robotics, stem, tile-based, typescript, visual-programming
- Language: TypeScript
- Homepage:
- Size: 21 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Mindcraft Language
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](https://www.kodugamelab.com/), [Project Spark](https://en.wikipedia.org/wiki/Project_Spark) ([Wiki](https://projectspark.fandom.com/wiki/How_the_brains_work)), and [MicroCode](https://microbit-apps.org/microcode-classic/docs/language).
## Demos
- [Ecosystem Sim](https://sim.mindcraft-lang.org) -- carnivores, herbivores, and plants driven by user-editable Mindcraft brains
## Repository Structure
```
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
```
## Packages
| Package | Description |
|---------|-------------|
| [@mindcraft-lang/core](packages/core/) | Language runtime -- tiles, parser, compiler, VM (multi-target: Roblox, Node.js, ESM) |
| [@mindcraft-lang/ui](packages/ui/) | Shared React UI -- shadcn/ui primitives + brain editor components |
| [@mindcraft-lang/docs](packages/docs/) | Shared documentation subsystem -- renders as in-app sidebar or full-screen SPA |
## Apps
| App | Description |
|-----|-------------|
| [Ecosystem Sim](apps/sim/) | Demo: carnivores, herbivores, and plants driven by user-editable Mindcraft brains |
## Getting Started
Install the packages you need:
```bash
# 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/docs
```
For full setup instructions -- Vite config, TypeScript paths, Tailwind, and component usage -- see the [Integration Guide](INTEGRATION.md).
## Documentation
Documentation is a work in progress. Browse the sim demo's [language documentation](https://sim.mindcraft-lang.org/docs) online. See also the [core package README](packages/core/README.md) for language architecture, the [ui package README](packages/ui/README.md) for the shared React components, and the [docs package README](packages/docs/README.md) for the documentation system.
## Contributing
To report a bug or request a feature, please [open an issue](https://github.com/humanapp/mindcraft-lang/issues).
## License
[MIT](LICENSE)