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

​
Adding onEntry Actions

Properties panel On Entry tab with three actions listed: panel-start, Load Scene, and Transform Object

On Entry tab showing multiple actions (panel-start, Load Scene, Transform Object) running in sequence

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 like Training Control, Media Playback, Object Manipulation, etc. 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 showing searchable list of actions organized by Training Control category

The Add Action picker — search or browse actions by category

​
Action Execution Order

onEntry actions run sequentially — one after another, in the order they appear in your list. Example sequence for a state:
  1. Load “Operating Room” scene (immediate)
  2. Delay 1 second (let scene render)
  3. Play narration audio “Follow these steps…” (5 seconds)
  4. Show Panel — title “Heart Monitor”, body “Check the heart monitor” (waits for learner to read or click Next)
  5. Highlight the heart monitor object in blue (stays highlighted)
The learner sees: scene loads → audio plays → panel appears → object highlights. Each action completes before the next one starts.
Use Delay actions to add pauses between things. For example, if you load a scene and then immediately show a panel, the panel might appear before the scene fully renders. Add a 1–2 second delay in between.

​
Example: Typical State Setup

Here’s a realistic example of onEntry actions for a state called “Identify the Problem”:
When this state starts:
  • Scene loads (2-second delay for it to render)
  • 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

Always load a scene before playing audio or showing content. Users need to see the environment before interacting with it.
Use a 1-2 second wait after loading a scene. It gives the 3D engine time to render everything.
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: