Skip to main content

​
What Happens When a State is Entered

Here’s the sequence:
  1. Transition fires and moves the training to a new state
  2. onEntry actions run (in the order you defined them)
  3. State is now fully set up and waiting for learner interaction
  4. Learner does something (taps, moves, chooses, etc.)
  5. An event is triggered, and a transition out of the state may fire

​
Common onEntry Actions

The time limit applies across subsequent steps until it is removed. Add Remove Time Limit to the successful completion transition’s Actions list when the timed task ends.

​
Adding onEntry Actions

Step Properties panel with On Entry (3) selected and three actions listed: panel-start, Load Scene, and Teleport User To

On Entry tab listing panel-start, Load Scene, and Teleport User To

1

Select a state on the canvas

Click the state node in the steps list or on the canvas.
2

In the Properties panel, select the On Entry tab

You’ll see a list of actions already in this state’s onEntry (if any) and an Add Action button.
3

Click the Add Action button

A searchable action picker appears with actions organized by category.
4

Select the action type you want

Browse categories such as Panel & UI, Scene, and Object, or use the search bar.
5

Configure the action

Expand the action to set its parameters (scene name, audio file, object to highlight, etc.).
Add Action dropdown with a Search actions field and actions grouped under Panel & UI, Scene, and Object

Add Action picker showing search and the Panel & UI, Scene, and Object categories

​
Action Execution Order

onEntry actions start in list order. For asynchronous actions, enable Wait Until Complete when the next action depends on completion. Without waiting, playback and later actions can overlap. Example sequence for a state:
  1. Load “Operating Room” scene (Wait Until Complete enabled)
  2. Delay 1 second (an intentional pause after loading)
  3. Play narration audio “Follow these steps…” (5 seconds; Wait Until Complete enabled)
  4. Show Panel — title “Heart Monitor”, body “Check the heart monitor” (Wait Until Complete disabled; enable Next for learner navigation)
  5. Highlight the heart monitor object in blue (stays highlighted)
The learner sees: scene loads → audio plays → panel appears → object highlights. The scene and narration complete before the following actions because their wait options are enabled.
Use Wait Until Complete to wait for a scene load or media playback. Use Delay for an intentional fixed pause; a fixed delay does not guarantee that loading has finished.

​
Example: Typical State Setup

Here’s a realistic example of onEntry actions for a state called “Identify the Problem”:
When this state starts:
  • Scene finishes loading, followed by the optional 2-second pause
  • Audio narration plays (5 seconds)
  • Panel appears below
  • Pressure gauge pulses red to guide the learner’s eye
  • Learner can now tap the highlighted gauge or select an answer

​
Coordinating onEntry with Events

Your learner interaction depends on what you set up in onEntry. Example: onEntry actions:
  • Show Panel: body “Tap the valve to open it”
  • Highlight valve in blue
Event (Tap):
  • Trigger on valve tap
  • Transition to next state
The learner sees the highlighted valve and knows what to do. When they tap it, the event fires and moves forward.

​
Using onEntry for Setup, Not Just UI

onEntry isn’t just for displaying things — use it to initialize your training logic: Examples:
  • Set Variable score to 0 at the beginning
  • Set Variable startTime to now() to track elapsed time (now() returns the current time in milliseconds)
  • Set Variable isFirstAttempt to true for attempt tracking
  • Set Variable userChoice to "" before showing a choice panel
Then, in later states, use conditions with these variables to create branching logic.

​
onEntry Best Practices

Load the scene before actions that need its objects. Later states can reuse the loaded scene; add another Load Scene only when you intend to load or replace it.
Enable Wait Until Complete for scene-dependent actions. Add a short Delay afterward only if the training needs a pacing pause.
If you have audio narration, play it before showing a text panel. The learner will read and listen simultaneously.
Use onEntry to highlight objects the learner must interact with. Make it obvious what they should tap, move, or rotate.
If onEntry actions take too long, learners may get bored or distracted. Aim for 3–5 seconds of setup.

​
Next Steps

Learn about: