Build Graphs by ScriptableObjects

​

Create a Graph

In the Project tab, right‑click and choose Create > Inworld > Graph > Default or Character Interaction.

​

Fill in Required Fields

First, fill in the required fields; otherwise the graph will not run. The Default Graph is suitable for general tasks that are not related to character interaction. You can also inherit from Default Graph to implement more customized functionality. UserData is required. The Character Interaction Graph inherits from Default Graph. It is a template focused on character interaction. In addition to UserData, it has a mandatory field: CharacterData. If you plan to use a TTS node, also fill in the Voice ID. If you plan to use an LLM node, provide a Prompt.

​

Create a Node

In the Project tab, right‑click and choose Create > Inworld > Create Node, then choose your node type. After you create it, rename the ScriptableObject — especially its Node Name under General Configuration.

​

Add a node to the graph

You can drag it directly into the graph’s Nodes list.

​

Create an Edge

In the Project tab, right‑click and choose Create > Inworld > Create Edge, then choose your edge type. Then assign the target GraphAsset, the source NodeAsset, and the target NodeAsset to the edge. Finally, don’t forget to add the created edge to the graph’s Edges list.

​

Create a New Custom Node/Edge Type

Without the Graph Editor, this is more involved. First, create a Unity script that inherits from InworldNodeAsset (or the appropriate base type for edges). Then add the [CreateAssetMenu] attribute to the class so it appears in the Create menu.

​

Configure Start/End Nodes

Although this step is handled automatically by the Graph Editor, it is required when creating a graph via ScriptableObjects. Drag the corresponding NodeAsset into the Start/End Node fields on the GraphAsset.

​

About End Node and End Nodes

We provide both End Node and End Nodes fields. The only difference is that End Nodes supports multiple end nodes. If you have only one end node, you can use either field.

​

Validate with Graph Editor

At any time, you can open the Graph Editor to review your graph. Any edits you make directly in the GraphAsset will immediately be reflected in the Graph Editor.