States

​

What Happens in a State

When a state is entered, its On Entry actions prepare the step. Depending on the training, the learner may see:

• A loaded 3D scene, which can remain in use across several steps
• Instructional content, such as panels, highlights, and instruction animations
• Objects they can interact with through Tap, Move, or Rotate events

A matching event and satisfied condition can select a transition. That transition can move to another step or run actions while keeping the current step active.

​

Creating a State

​

Step Properties

Open the Properties panel by clicking Step Properties on the ribbon. For a step, the Properties panel shows three tabs: The step’s panel title and body text can be edited inline in Step Panel view or in the Show Panel action’s properties.

​

Start Node and End Steps

• Start node: The first step in the Steps list is the entry step and can contain training content. Moving a step to the top changes the starting step. There is no separate per-step entry checkbox.
• End steps: A step with no transition leading to another step is treated as an end step. This includes steps with no transitions and those whose transitions all have no destination. There is no separate Final checkbox in Creator. An end step can still display content and respond to interactions that stay within it.

​

onEntry and onExit Actions

Each state has two special action lists:

• onEntry: Actions that run automatically when the state is entered
• onExit: Actions that run when a selected transition leaves the state for another step

Common onEntry actions:

• Load a 3D scene
• Play narration or audio
• Show a text panel with instructions
• Highlight an object to guide learner attention
• Initialize a variable (for example, set an attempt counter to 0 at the beginning of training)

Common onExit actions:

• Stop audio or narration
• Hide panels or highlights
• Update a variable to record progress during the training
• Use Transform Object to restore an object to a known position

Reset Object Transformation belongs in the Actions list of the transition triggered by a Move or Rotate event. It automatically restores the object involved in that interaction. It is not a general onExit action for restoring arbitrary objects. See Entry & Exit Actions and Exit Actions for more detail.

​

The Visual Canvas: Working with State Nodes

​

Selecting a State

Click any state node on the canvas to select it. If the Properties panel is open (toggle it from Step Properties on the ribbon), it updates to show that step’s tabs and actions.

​

Moving a State

Click and drag a node in Outline to adjust its position temporarily. This does not change the step order or transition logic. Switching views or clicking Re-arrange resets these manual positions to the automatic layout; they are not saved as the training’s layout.

​

Deleting a State

Right-click a step in the Steps list to open Duplicate, Move Up, Move Down, and Delete. You can also drag to reorder the list. Adding, deleting, or reordering steps updates sequential Next destinations; review explicit choice and conditional routes afterward. This differs from visually positioning nodes in Outline.

​

Naming States: Best Practices

Give your states meaningful, descriptive names — not generic names like “State 1” or “Screen 2”. Good names make your logic easier to understand and debug. Good state names:

• “Show Safety Warning”
• “Wait for Valve Tap”
• “Demonstrate Valve Opening”
• “Show Completion Screen”
• “Incorrect Choice Feedback”

Avoid:

• “State 1”, “State 2”
• “Next”, “Previous”
• Single-word vague names like “Interaction”

​

State Canvas Tips

​

Next Steps

Now that you understand states, learn how to:

• Connect states with Events and Transitions — Define what triggers movement between states
• Add Entry & Exit Actions — Make things happen automatically
• Build Conditional Transitions — Create branching flows based on learner choices or variables