Core Nodes

Structural plumbing every module graph is built from. Input, Output and Module Property define a module's interface — the sockets and properties it exposes when used as a node inside another graph (see Modularity). Stage controls execution order between disconnected branches (see Staging), Route and Watch pass values through (Watch also surfaces them in the debug tools), and Null is an explicit no-op.

7 nodes.

Node	Registry path
Input Socket	core/Input
Module Property	core/ModuleProperty
Null	core/Null
Output Socket	core/Output
Route	core/Route
Stage	core/Stage
Watch	core/Watch

Input Socket

core/Input

Defines an input socket for the containing node module (graph).

When the module is used as a node inside another graph, each Input node becomes an input socket on the module node, and the value passed into that socket is emitted from this node's value output inside the module.

Outputs

Output	Type	Description
value	any	The value received through the module's input socket

Properties

Property	Type	Default	Description
input_type	str	"any"	Input Type. Choices: actor, agent, any, bool, character, character_context, client, context_id, context_id_item, dict, event, float, ….
input_name	str	"state"	Input Name
input_optional	bool	False	Input Optional
input_group	str	""	Input Group
num	int	0	Number

Module Property

core/ModuleProperty

A node that can be placed to define a property of a Graph

When the graph is used as a node module inside another graph, each ModuleProperty node becomes a property on the module node.

Outputs

Output	Type	Description
name	any	The name of the property
value	any	The value of the property

Properties

Property	Type	Default	Description
property_name	str	""	Property Name
property_type	str	""	Property Type. Choices: str, bool, int, float, text.
default	any	unset	Default Value
choices	list	unset	Choices
description	str	""	Description
num	int	0	Number. Min: 0.

Null

core/Null

A node that returns None

Outputs

Output	Type	Description
value	any

Output Socket

core/Output

Defines an output socket for the containing node module (graph).

When the module is used as a node inside another graph, each Output node becomes an output socket on the module node, and the value connected to this node's value input is exposed through that socket.

Inputs

Input	Type	Description
value	any	(optional) The value to expose through the module's output socket

Properties

Property	Type	Default	Description
output_type	str	"any"	Output Type. Choices: actor, agent, any, bool, character, character_context, client, context_id, context_id_item, dict, event, float, ….
output_name	str	"state"	Output Name
num	int	0	Number

Route

core/Route

Simply passes the value of the input to the output

Inputs

Input	Type	Description
value	any

Outputs

Output	Type	Description
value	any

Stage

core/Stage

A node that can be connected in or out and defines a stage level for the nodes connected to it

This stage level can be used to control the order of execution of nodes in the graph, the lowest stage will be executed first.

Inputs

Input	Type	Description
state	any	(optional) Any value to pass through. If not connected, defaults to True
state_b	any	(optional) Any value to pass through.
state_c	any	(optional) Any value to pass through.
state_d	any	(optional) Any value to pass through.

Outputs

Output	Type	Description
state	any	The value of the input state or True if corresponding input is not connected
state_b	any	The value of the input state_b
state_c	any	The value of the input state_c
state_d	any	The value of the input state_d

Properties

Property	Type	Default	Description
stage	int	0	Stage. Min: 0.

Watch

core/Watch

Passes the input value through unchanged and logs it for inspection when the graph is running in the node editor (creative mode).

Inputs

Input	Type	Description
value	any	The value to watch

Outputs

Output	Type	Description
value	any	The value, passed through