Node reference

This build has five node types, in three categories. Every behavior graph is built from these. This page describes what each does at runtime and every field you can set.

Node	Category	Ports	Editable fields
Start	Lifecycle	Out	None
End	Lifecycle	In	None
Idle	Action	In, Out	Sprite, FPS, Duration
Walk	Action	In, Out	Sprite, FPS, Duration
Random	Logic	In, Out ×N	Paths (2 to 8)

The graph runs from Start, follows the wires through your action and logic nodes, and when it reaches End it loops back to Start and runs again, forever, until you turn the pet off.

Lifecycle

Start

The entry point of the graph. Has a single Out port and no inputs. Execution always begins here.

Exactly one Start runs. You can only meaningfully have one; extra Start nodes are flagged as a problem.
No editable fields.
Its Out must connect to something, or the pet has nothing to do.

End

Marks the end of a path. Has a single In port. When the pet reaches an End, the graph restarts from Start.

You can have several End nodes (e.g. one at the tail of each Random branch).
No editable fields.

Actions

Action nodes are the visible behavior: the pet plays an animation for a while, then moves on to the next node. Idle and Walk share the same fields; the difference is that Walk moves and Idle doesn’t.

Idle

The pet stands still at its current spot and plays its animation.

Fields:

Sprite. Which of your imported sprites to play. Required. You can set a per-node FPS override, or leave it to inherit the sprite’s own default FPS.
Duration. How long the action lasts, with a Mode toggle:
- Time. A random length between a Min and Max in seconds (default 2-5 s). An optional Finish animation checkbox rounds the time up so the animation ends on a whole loop instead of mid-frame.
- Loops. Run for a random number of whole animation loops between Min and Max.
Each time the node runs it picks a fresh random value in your range, so the pet doesn’t feel metronomic.

Walk

Same as Idle, but the pet moves horizontally while the animation plays.

Fields: identical to Idle (Sprite, FPS, Duration Time/Loops). Default duration is 3-6 s.

About movement:

Direction is automatic. There’s no direction field. The pet heads one way, and bounces off the screen edges, reversing direction, so it never walks off screen.
Speed is the engine default (a steady stroll); it isn’t a per-node setting in this build.
The sprite mirrors to face the direction of travel. If your art is drawn facing left, flip it with the sprite’s Flip horizontally option so it faces the right way.

Logic

Random

Branches the flow. Has one In port and several Out ports; when reached, it picks one connected output and continues down it.

Field:

Paths. How many outputs the node has, from 2 to 8 (default 2). The node builds “Out 1” … “Out N” accordingly.

The choice is weighted (equal weighting by default), and only connected outputs are eligible. Random is the main tool for giving a pet personality: wire each output to a different action so the pet sometimes idles, sometimes walks, sometimes does something else.

Not nodes: drag & fall

Two behaviors are built into the engine and apply to every pet automatically. You don’t (and can’t) wire them:

Drag. You can always pick a pet up with the mouse and move it.
Fall. Dropped in mid-air, a pet falls with gravity until it lands, then resumes its graph from Start.

(The only thing that changes drag is Focus Mode, which makes pets click-through and therefore un-draggable, see The system tray & everyday controls.)

A minimal working graph

The smallest pet that will go Live:

Start → Idle(sprite: "idle") → End

A more lively one:

                 ┌─ Out 1 → Walk(sprite:"walk") ─┐
Start → Random ──┤                               ├→ End → (loops to Start)
                 └─ Out 2 → Idle(sprite:"idle") ─┘