Graphs
Each logic object has a graph made of chains of nodes. A When node starts a chain, and the nodes wired after it run in order.
Opening a graph
Open a graph in any of these ways:
- Double the logic object.
- → Open logic in the Inspector.
- it in the Hierarchy and choose Open logic.
- Select it while Follow is on in the drawer.
The graph opens in the Logic drawer.
The drawer
The drawer holds the palette, the canvas, Scene objects and Details. The breadcrumb shows the open model and object.
| Button | Action |
|---|---|
| Back | Opens the graph you had open before |
| Forward | Opens the next graph |
| Follow | Opens the graph of the selected object |
| Add | Adds a Brain, Volume, Marker, Screen, Buttons and switches or Moving part |
| Problems badge | Opens the problem list |
| More | Opens a menu with Frame all and Check for problems |
Adding nodes
Nodes come from the palette or from Quick Add.
| Gesture | Action |
|---|---|
| a palette row | Adds the node |
| a palette row | Places the node where you drop it |
| Tab, or the canvas | Opens Quick Add to search for a node |
| a wire to empty canvas | Opens Quick Add with matching nodes and wires the new node |
| a logic object onto the canvas | Adds an object node |
Search also matches goals. For example, killbox suggests a Volume with When a player enters and Kill the player.
Node shapes
A node's shape shows what kind of node it is.
| Term | Meaning |
|---|---|
| Starts a chain | An event: a When node |
| Does something | An action |
| Gives a value | A number, text, object or player |
| Asks yes or no | A question |
| Controls the order | Flow, such as If or Repeat |
Nodes that can kill a player show .
Wires
Wires join nodes. There are two kinds.
| Term | Meaning |
|---|---|
| Action wire | Carries the chain: what runs next |
| Value wire | Carries a value into a node's input |
| Gesture | Action |
|---|---|
| from pin to pin | Wires them. Dropping on a node's body uses its first matching pin |
| Ctrl from a pin | Moves its wires |
| Alt a wire | Deletes the wire |
| Double a wire | Adds a knot to route the wire |
Select an action wire to set its Delay, and whether it Fires Every time, Once or A number of times.
The canvas
The canvas holds the graph's nodes, wires and comments.
| Gesture | Action |
|---|---|
| , Space or Alt | Pans |
| Zooms | |
| on empty canvas | Box-selects. Shift adds, Ctrl removes |
| Hotkey | Action |
|---|---|
| F | Frames the selection |
| Home | Frames everything |
| C | Adds a comment around the selection |
| CtrlF | Finds a node in this graph |
| CtrlA | Selects every node |
| CtrlC | Copies |
| CtrlX | Cuts |
| CtrlV | Pastes |
| CtrlD | Duplicates |
| Del | Deletes |
| Nudges the selection |
a node for Fire now (in Play), Open its logic (object nodes), Copy, Cut, Duplicate, Comment around, Delete and Help.
Details
Select a node to edit its inputs in Details and pick the variable, timer, message or object it uses. Wired inputs show wired in.
A waiting node, such as Wait or Every, has When it runs again while busy:
| Option | Effect |
|---|---|
| Each on its own | Starts another run alongside the first |
| Start again | Stops the current run and starts again |
| Ignore while busy | Skips the new run |
| Wait in line | Runs after the current one ends |
Checking for problems
→ More → Check for problems in the drawer. Or the Problems badge.
Each entry is a Problem, Warning or Hint, often with a button that fixes it, such as Add Health or Clear it.
Common problems:
| Message | Fix |
|---|---|
| This When does nothing yet | Wire a node under it |
| This step never runs | Wire something into it |
| A node needs a capability the object lacks | Press its Add button, such as Add Health |
| Outside Gameplay, so it won't be saved | Press Move under Gameplay |
Blueprints
A blueprint is a saved graph and its capabilities, reusable on other objects. Manage blueprints from the Blueprint rows in the Inspector.
| State | Meaning |
|---|---|
| One-off | Not from a blueprint |
| Linked | Follows its blueprint |
| Modified | Changed from its blueprint |
| Blueprint missing | Its blueprint was deleted |
| Command | Action |
|---|---|
| Save as blueprint | Saves a one-off as a new blueprint |
| Save new | Saves a linked copy as a new blueprint and links to it |
| Reapply | Replaces this copy with the blueprint's version |
| Push | Saves this copy's changes into the blueprint |
| Detach | Makes this copy a one-off |
| Link | Links a one-off to a blueprint |
Saved blueprints are listed under Blueprints in the palette.