It turns Minecraft Redstone concepts into a complete interpreter with its own lexer, parser, AST, runtime, examples, and unit tests, all using only the Python standard library.
Lever is a small, esoteric programming language inspired by Minecraft Redstone. Programs move byte values through Redstone-inspired components such as chests, hoppers, dust, repeaters, observers, comparators, pistons, and lamps.
The interpreter is written in Python and includes a lexer, recursive-descent parser, abstract syntax tree, runtime, stack-based storage, examples, and unit tests.
[!IMPORTANT] Disclaimer
Lever is an independent programming language inspired by Minecraft's Redstone mechanics and terminology. It is not affiliated with, endorsed by, sponsored by, or associated with Mojang Studios or Microsoft. Minecraft is a trademark of Microsoft/Mojang.
Check your installed Python version with:
python --version
On Windows, the Python Launcher can be used to select a specific version:
py -3.12 --version
Clone or download the project, then open a terminal in the project directory.
py -3.12 -m venv .venv
.\.venv\Scripts\Activate.ps1
python --version
If the py launcher is not available, use the Python executable directly:
python -m venv .venv
.\.venv\Scripts\Activate.ps1
PowerShell may require permission to run activation scripts. If activation is blocked for your user account, run PowerShell once with the following command and then activate the environment again:
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
python3.12 -m venv .venv
source .venv/bin/activate
python --version
The project has no runtime dependencies to install. When finished, leave the virtual environment with:
deactivate
Run the interpreter as a Python module from the project root:
python -m src.main examples/hello.lever
Programs must use the .lever extension. The interpreter reports syntax and runtime errors in the terminal and returns a non-zero exit status when execution fails.
examples/hello.lever demonstrates storing ASCII bytes in a Chest, transferring them in valid Hopper batches, and printing them with Slime_Piston:
RedstoneBlock hello.lever
Chest 33,100,108,114,111,87,32,111
Lever is a Minecraft-inspired programming language.
Similar projects matched by category, topics, and programming language.
Harness Engineering is a methodology for improving coding agent outputs by carefully crafting the environment around them—providing curated context, tools, and executable constraints that encode an organization’s nonfunctional requirements and cumulative lessons.
A 28.9 million parameter language model runs on an $8 ESP32-S3 microcontroller entirely on-device, generating simple stories at about 9.5 tokens per second.
mimic captures traffic from any iOS or web app and automatically generates a Python client library that lets you call the app's API like a regular library.