Story Navigation (Experimental)

Skip or rewind moments in your VR experiences

Overview

Story Navigation provides runtime controls that allow trainers to navigate through training moments during VR sessions. Think of it as “VCR controls” for your VR experience—trainers can pause, skip ahead, or reset to review previous moments.

This feature is useful for:

• Demonstrating specific moments without completing the entire module
• Skipping ahead to let trainees practice particular sections
• Resetting to review previous moments
• Pausing the experience for discussion or instruction

How Story Navigation Works

Story Navigation connects to VRseBuilder’s playback system, which manages the flow of moments and chapters in your training module. When added to a scene, the navigation UI provides three core controls:

Control	What It Does
Pause	Freezes the current moment, stopping all active actions and timers
Skip	Advances to the next moment, completing the current one
Reset	Returns to the beginning of the current moment or chapter

The core playback system handles all the complexity of managing moments, chapters, and transitions. The navigation controls simply send commands to this system.

Note: Story Navigation controls only appear in Training Mode. They are automatically hidden during Evaluation Mode to ensure assessments run without interference.

Quick Setup

1. Add the Prefab to Your Scene

Navigate to the prefab in your Project window:

Assets > VRseBuilder > _Core > Runtime > Systems > StoryNavigation > Prefabs

Drag StoryNavigationController into your scene hierarchy.

2. Position the Controller

Move the prefab to a location where trainers can easily access the UI without obstructing the training environment.

Tip: Consider placing the controller near the trainer’s typical standing position, or in a consistent location across all training modules.

3. Test the Setup

Enter Play mode. The navigation UI appears and responds to the current module’s moment structure.

No additional configuration is required—the prefab auto-connects to the Story system.

Configuration

Enable or Disable Step Navigation Per Module

Control whether the navigation UI appears for specific modules:

1. Select your RoomManagerConfig asset (e.g., RoomManagerConfig_AZ - Compaction)
2. Expand the module under Modules Data → Experiences
3. Locate the Step Navigation section
4. Toggle Enable Step Navigation:
   • ✅ Enabled (Default) — Navigation UI is visible and functional
   • ⬜ Disabled — Navigation UI is hidden for this module

Use this when certain modules should allow trainer intervention while others run without interruption.

Enable or Disable Analytics Capture

Control whether navigation events are tracked and sent to the Pulse dashboard:

1. Select your RoomManagerConfig asset
2. Locate Step Navigation Data Enabled in the top-level settings
3. Toggle the checkbox:
   • ✅ Enabled (Default) — Navigation events are tracked and sent to analytics
   • ⬜ Disabled — Navigation events are not captured

Use this if you need navigation controls but don’t want the data reported to your dashboard.

Configuration Reference

Setting	Location	Default	Purpose
StoryNavigationController	Scene Hierarchy	Must be added manually	Provides the navigation UI
Enable Step Navigation	RoomManagerConfig → Module → Step Navigation	✅ Enabled	Show/hide UI per module
Step Navigation Data Enabled	RoomManagerConfig (top-level)	✅ Enabled	Enable/disable analytics

Multiplayer Behavior

In multiplayer sessions, only the host can control navigation. When the host pauses, skips, or resets, all participants are synchronized automatically. Participants do not see or have access to the navigation controls.

Actions and Triggers

Coming soon

Limitations

Limitation	Details
Training Mode only	Controls are hidden in Evaluation Mode
Host-only in multiplayer	Participants cannot control navigation
Requires compatible Actions/Triggers	Custom Actions and Triggers must implement navigation support to respond correctly to Pause, Skip, and Reset commands