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 programming-language roblox robotics stem typescript visual-programming
Last synced: 27 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 (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-19T00:23:06.000Z (about 2 months ago)
- Last Synced: 2026-04-19T01:33:27.043Z (about 2 months ago)
- Topics: coding, creative-coding, game-development, programming-language, roblox, robotics, stem, typescript, visual-programming
- Language: TypeScript
- Homepage: https://mindcraft-lang.org
- Size: 24.8 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
## Packages
| Package | Description |
|---------|-------------|
| [@mindcraft-lang/core](packages/core/) | Mindcraft Language runtime -- tiles, parser, compiler, VM (multi-target: Roblox, Node.js, ESM) |
| [@mindcraft-lang/app-host](packages/app-host/) | Project management, workspace storage, and IDB persistence for Mindcraft apps |
| [@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 |
| [@mindcraft-lang/ts-compiler](packages/ts-compiler/) | TypeScript-to-Mindcraft bytecode compiler |
| [@mindcraft-lang/bridge-protocol](packages/bridge-protocol/) | VS Code bridge network protocol types and schemas |
| [@mindcraft-lang/bridge-client](packages/bridge-client/) | Client SDK for the VS Code bridge |
| [@mindcraft-lang/bridge-app](packages/bridge-app/) | Opinionated layer atop bridge-client for the VS Code bridge |
## Apps
| App | Description |
|-----|-------------|
| [Ecosystem Sim](apps/sim/) | Demo: carnivores, herbivores, and plants driven by user-editable Mindcraft brains |
| [VS Code Extension](apps/vscode-extension/) | Author Mindcraft sensors and actuators in TypeScript using VS Code Web ([Marketplace](https://marketplace.visualstudio.com/items?itemName=mindcraft-lang.mindcraft-lang-vscode-extension)) |
| [VS Code Bridge](apps/vscode-bridge/) | Bridge server that relays between the VS Code extension and Mindcraft apps |
## 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 VS Code integration, see apps/sim for example implementation.
```
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)