Flare 🔥
Programmatic Minecraft Datapacks in Python
Write Minecraft logic using full Python power: scores, NBT, execute chains, recursion, and more. Compile to optimized datapacks instantly.
Read the full documentation at: flare.oguzhanumutlu.com
What is Flare?
Flare is a modern framework for building Minecraft datapacks natively in Python. It bridges the gap between Python's high-level elegance and Minecraft's native mcfunction performance. You can use standard Python syntax, variables, and math, and Flare automatically translates and compiles your logic into highly-optimized, scoreboard-driven datapacks.
Installation
pip install flaremc
Quick Start: Advanced Math & NBT
With Flare, writing advanced datapack logic is incredibly clean. Below is a quick example of defining variables, doing advanced floating-point math natively in Minecraft, running terminal commands, and interacting with NBT.
from flare import namespace, score, math, nbt, expand
# Define your datapack namespace
namespace("my_pack")
# Declare a scoreboard variable and initialize it to 10
x = score(10)
# Compute math dynamically using native scoreboard approximations (Taylor series, CORDIC, etc.)
# All complex math compiles to highly optimized raw scoreboard operations!
result = math.sin(x) * math.sqrt(x)
# Print the dynamic float result back to the game seamlessly
print(f"The result is: {result}")
# Interact seamlessly with Minecraft's NBT environment
player_data = @a.Data[dict]
# Flare smartly manages conditional blocks and inlines commands when appropriate
if expand(x > 5):
say "X is greater than 5!"
kill @e[type=zombie, distance=..10]
Compile & Run
To compile your datapack to a .mcfunction structure, simply run:
flare main.py
To compile and immediately run it using the built-in emulator:
flare main.py --run
Documentation
Ready to unleash the full power of Python in Minecraft?
Check out the interactive playground and full documentation at flare.oguzhanumutlu.com!
Acknowledgements
AI assistance was used in creating the documentation and minimally in the source code.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file flaremc-0.10.11.tar.gz.
File metadata
- Download URL: flaremc-0.10.11.tar.gz
- Upload date:
- Size: 202.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
211f619062529bb3c1a178e99f58fc571379093e19955ce07cc26871a5ff91a2
|
|
| MD5 |
0dee96f96cfad26f30debf23fdc477fa
|
|
| BLAKE2b-256 |
f1a9e35be8717c8e9acc9100badef93a5009f52a0e3077ca682b2289a8b85071
|
File details
Details for the file flaremc-0.10.11-py3-none-any.whl.
File metadata
- Download URL: flaremc-0.10.11-py3-none-any.whl
- Upload date:
- Size: 254.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
33239d8e9019960f66143c722dae287362f41ea31068e11c5eaad15c3b0df60a
|
|
| MD5 |
833ca00fb60fa8aac955e7ec775b30fe
|
|
| BLAKE2b-256 |
684c4416a734026556ccaf622223584fa5eb66afd418bd707111374a4def8d08
|
