🟨 Open a graph

The Open a graph block allows you to structure your projects by separating the logic into several functional graphs, thus avoiding overly complex and illegible modules.

This block allows you to switch the execution of the current graph to another graph, simulating a function call or subroutine, often used with "Blackboxes" for a controlled return.

📥 Entries

• graph: Select the destination graph via the selector. This graph can be a module or an encapsulated logical subpart to be executed.

📤 Outings

• No direct output: This block does not produce standard stream output. It redirects execution to the first step of the target graph (usually a "Blackbox input" block if configured).

💡 Example of use

Scenario: Organization of a modular quest system

1. The player accepts a quest in the main “Main Quests” graph.
2. The flow reaches an Open Graph block.
3. The target graph “Secret Quest: Flight of the Dragon” is selected.
4. Execution switches to this graph, where a series of steps (dialogues, fights) is executed.
5. Once the quest is completed, a "Blackbox output" block in the secondary graph returns the flow to the main graph with a completion status.

⚙️ Technical Details

• Working with GraphRef: This block uses graph references (GraphRef) in memory to locate and execute the target graph start block.
• Variable management: It initializes or links the variables necessary for the execution of the secondary graph, ensuring a smooth transition between contexts.

Updated on: 04/03/2026