Editor Tools

Setup your Studio generated story in Unity

As of VRse Builder 0.5.2 project creation related setup has been moved to Studio, read more about how to create a project on studio.

Once you have a project on studio and generated and published a story, you will be able to setup your project in Unity following the steps below.

Access the Unity Tools

Via VRse Tools Overlay

The VRse Tool Overlay provides three main options:

Login: Used for logging into VRseBuilder platform within Unity,Required before accessing other tools

Modules: Opens the VRse Studio Projects Window and allows project switching and module management. You can also access the development and art Unity scenes

Edit Story: Opens the Story Edit Window, This is the primary interface for experience editing also contains all tools and options for story modification

Story Edit Window Interface

This window will help you edit and manage content for your VR story, once you have logged in

Creator Section

The Creator section is the primary workspace for editing your VR story experiences.

Interface Layout

The Creator section features a split-panel interface with:

Left Panel: Navigation Hierarchy

• Hierarchical chapter and moment navigation
• Visual highlighting of current selection
• Quick access to all story elements

Right Panel: Detailed Editing Area

• Contextual editing interface for selected elements
• Node-based editing system
• Parameter configuration panels

Adjustable Splitter

• Drag to resize panels according to your workflow preferences
• Optimizes workspace organization

3.1.2 Save Management

Save Status Indicator The save status is clearly indicated through color-coded buttons:

• 🔴 Red “Save to JSON file” button: Current story contains unsaved changes
• 🟢 Green “Save to JSON file” button: Story is saved and up-to-date

**Save Process** Step 1: Save Changes

1. Click the “Save to JSON file” button
2. A confirmation dialog will appear with:
   • Confirmation button: Proceed with saving
   • Cancel button: Cancel the save operation

Step 2: Confirm Save

1. Click Confirmation to save changes
2. Button will turn green to indicate successful save

3.1.3 Load Management

**Load from JSON** Purpose: Restore previously saved story state Use Case: When you want to discard current changes and revert to last saved version

Step 1: Load Saved Version

1. Click “Load from JSON file” button
2. Current unsaved changes will be discarded
3. Story will revert to last saved state

> Warning: Loading from JSON will permanently discard any unsaved changes. Ensure you want to lose current modifications before proceeding.

3.1.4 File Management

**Open JSON File** Purpose: View the raw JSON file containing your story data

Step 1: Open File

1. Click “Open File” button
2. JSON file will open in your default text editor
3. View raw story structure and data

> Note: This is for viewing purposes. Direct editing of JSON files outside the Story Editor is not recommended.

3.1.5 Voice Over Tool

The Voice Over (VO) Tool provides comprehensive audio generation and management capabilities for your VR experiences.

**Accessing the VO Tool** Step 1: Open VO Preview

1. In the Creator section, click the “VO Preview” button
2. The Voice Over Previews window will open

VO Preview Window Interface The VO Preview window organizes all voice-over content by story structure:

Hierarchical Organization

• Voice-overs grouped by chapter and moment
• Clear visual hierarchy for easy navigation
• Expandable sections for detailed view

Status Indicators

• Pending Generation: VOs awaiting generation
• Generated: Completed voice-over files

VO Generation Process

Individual VO Generation For Pending VOs:

1. Locate the VO marked as pending
2. Click the “Generate Pending VO” button (yellow text) below the specific VO
3. System will generate audio files for all pending voice-overs

> Note: Currently, this button generates all pending VOs in the story, not just the individual VO. Individual generation functionality will be updated in future releases.

Bulk VO Generation For All Pending VOs:

1. Scroll to the bottom of the VO Preview window
2. Click the “Generate Pending \<number\> VOs” button
3. System will generate all pending voice-overs in sequence

VO Testing and Playback

Testing Generated VOs Step 1: Locate Generated VO

1. Find the VO that has been successfully generated
2. Generated VOs will show a play button at the bottom

Step 2: Play Audio

1. Click the play button to test the audio
2. Listen to ensure quality and accuracy
3. Use for final verification before deployment

Advanced VO Options

Regeneration Toggle Fresh Generation Option

1. Locate the toggle below the “Generate Pending VOs” button
2. Enable toggle: Delete existing VOs and regenerate all
3. Disable toggle: Only generate missing VOs

Use Cases for Regeneration:

• Voice quality improvements
• Script changes requiring new audio
• Different voice settings or parameters

Status Messages All VOs Generated

• When all VOs are complete, window displays: “No pending VOs to be generated.” (green text)
• Indicates story is ready for deployment

Pending VOs

• Clear count of remaining VOs to generate
• Progress tracking for large stories

3.1.6 Node-Based Editing System

The Creator section uses an advanced node-based editing system for intuitive story creation.

Key Features

Template-Based Node Selection

• Choose from pre-defined node templates
• No dependency on external node libraries
• Consistent parameter structure across node types

Contextual Parameter Editors

• Parameter editors adapt based on selected node type
• Organized sections for different parameter categories
• Expandable sections for better data organization

Enhanced Data Display

• Improved readability of node data sections
• Expandable parameter groups
• Clear visual hierarchy for complex data structures

Node Types and Parameters

Actions: Execute specific behaviors in your VR experience Triggers: Detect user interactions and environmental changes

3.1.7 Navigation System

Enhanced Chapter and Moment Organization

Hierarchical Structure

• Clear chapter and moment hierarchy in left panel
• Visual indicators for current selection
• Expandable/collapsible sections for better organization

Quick Navigation

• Click any chapter or moment for instant navigation
• Visual highlighting shows current selection
• Breadcrumb navigation for complex stories

Visual Indicators

• Selected elements: Highlighted in the navigation panel
• Modified elements: Visual indicators for unsaved changes

3.1.8 Copy/Paste Functionality

The Creator section supports comprehensive copy/paste operations for efficient story development.

Supported Operations

Chapter Level

• Copy entire chapters with all contained moments
• Paste chapters to duplicate story sections
• Maintain all node relationships and parameters

Moment Level

• Copy individual moments
• Paste moments within same or different chapters
• Preserve all actions and triggers

Node Level

• Copy individual nodes (actions, triggers)
• Paste nodes within same or different moments
• Maintain all parameter settings

Context Menu Operations

Three-Dot Menu provides:

• Copy: Copy selected element
• Paste: Paste previously copied element
• Remove: Delete selected elements

Copy/Paste Workflow

Step 1: Select Element

1. Click on the three-dot menu (⋯) next to the element you want to copy
2. Select Copy from the menu

Step 2: Navigate to Destination

1. Navigate to the desired location in your story
2. Click on the three-dot menu (⋯) in the target location

Step 3: Paste Element

1. Select Paste from the menu
2. Element will be duplicated with all parameters intact

3.2 Report Section

Analysis and reporting tools for story performance and analytics.

(Coming in future update)

3.3 References Section

Asset and reference management for story components.

(Coming in future update)

3.4 VRse Objects Section

Object and component management for VR experiences.

(Coming in future update)

Story Editing Workflow

4.1 Basic Editing Process

Step 1: Open Story Editor

1. Access VRse Tool Overlay
2. Click Edit Story
3. Select Creator section

Step 2: Navigate to Content

1. Use left panel to navigate to desired chapter/moment
2. Click on target element for editing
3. Right panel will display editing interface

Step 3: Edit Content

1. Add/modify nodes using template system
2. Configure parameters in contextual editors
3. Use copy/paste for efficiency

Step 4: Save Changes

1. Monitor save status indicator
2. Click “Save to JSON file” when ready
3. Confirm save operation

4.2 Advanced Editing Techniques

Working with Templates

Using Node Templates

1. Select “Add Node” in your moment
2. Choose appropriate template from dropdown
3. Configure parameters using contextual editors
4. Save changes

Managing Complex Stories

Chapter Organization

• Use descriptive chapter names
• Organize related moments together
• Utilize copy/paste for similar content

Moment Structure

• Keep moments focused on single interactions
• Use clear naming conventions
• Document complex trigger/action relationships

---

5. Advanced Features

5.1 Custom Node Creation

For advanced users, new nodes can be added to extend the system’s capabilities.

Adding New Nodes

Step 1: Access Node Template Data

1. Navigate to: Assets/Core/NoCode/DataVRseHelper/NodeTemplateData.asset
2. Open the asset in Unity Inspector

Step 2: Define Node Structure

1. Node Name: Specify the name for your new node
2. Options: Add different option types for the node
3. Parameters: Define required parameters for each option

Step 3: Parameter Configuration For each parameter, specify:

• Parameter Name: Key identifier
• Data Type: Type of value (string, int, float, bool, etc.)
• Default Value: Initial value when node is created

Parameter Types

Supported Data Types:

• String: Text-based parameters
• Integer: Whole number values
• Float: Decimal number values
• Boolean: True/false toggles
• GameObject: Scene object references
• Vector3: 3D position/rotation/scale values

5.2 Template System Benefits

Consistency: All nodes follow standardized parameter structures Efficiency: Rapid node creation without manual parameter entry Maintainability: Centralized node definitions for easy updates Extensibility: Easy addition of new node types as neededead m