Blueprint Roblox Editor

BRE (Blueprint Roblox Editor) is an open-source project that allows users to use Python or the editor (the web application) to program in Luau, the language used by Roblox, derived from Lua.

The goal is to replicate the same programming system as Unreal Engine 5’s Blueprint, so that programming is done not with lines of code but with blocks. This can also attract people who want to learn programming.

BRE can be customized using block definitions that you can create yourself! Read the documentation to learn more.

Please send bugs to Report a Bug (Issues) and proposals to Propose a Node (Issues).

Contribute

To help the project evolve, you can report vulnerabilities/bugs, whether on the site or in the backend (API).

Additionally, it is possible to propose your own node. Please follow the format below:

{
    "type": "METHOD",
    "inputs": {
        "input_name": {
            "defaultValue": "default_input_value"
        }
    },
    "outputs": [
        "output_name"
    ]
}

Note: outputs and inputs can be empty:

{
    "type": "METHOD",
    "inputs": {},
    "outputs": []
}

⚠️ IMPORTANT: Write the type in uppercase as follows:

• METHOD = exec connection
• FUNCTION = no exec connection
• EVENT = one exec output

Once that's done you need to create the node in Python on the backend, create a file in src/Nodes/Models, you need to complete the toLuau function and indicate your .json file in the constructor then the type of the node.

from src.Nodes.Node import Node
from src.Nodes.NodeColor import NodeColor
from src.Nodes.NodeType import NodeType
class MyNode(Node):
    def __init__(self):
        super().__init__()
        self.loadFromJson("nodes/MyNode.json")

    def toLuau(self):
        return "My node"

    def __str__(self):
        return "MyNode NODE"

You can implement several things in the "translation" function, I advise you to look at the already existing nodes.

Installation

Run the following commands in a folder where you want the project to be located:

Linux:

git clone https://github.com/Program132/BlueprintRobloxEditor.git
cd BlueprintRobloxEditor
python3 -m venv env
source env/bin/activate
python3 -m pip install -r webeditor/requirements.txt
python3 webditor/app.py

Windows:

git clone https://github.com/Program132/BlueprintRobloxEditor.git
cd BlueprintRobloxEditor
py -m venv env
env/bin/activate
py -m pip install -r webeditor/requirements.txt
py webditor/app.py

Now move to http://127.0.0.1:80/

Download the lastest release if you want something stable:

git clone https://github.com/Program132/BlueprintRobloxEditor.git
cd BlueprintRobloxEditor
git fetch --tags
git checkout $(git describe --tags `git rev-list --tags --max-count=1`)

Documentation

Read README.

You can read as well the post from the devforum: Roblox DevForum Post