Getting Started

User Interface

Home Page

After login, you arrive at the Home Page. It provides access to recent scenes/templates and the main editors.

Main functions

Function menu

The Designer left-side function menu displays the main functional modules accessible, supporting quick switching between pages. The menu items shown may vary slightly depending on the user’s role and the company’s license permissions.

Start

“Start” Ribbon used for quick operations and fast access to recently edited content:

• Quick Create: Buttons provided at the top:
  • New Template
  • New Scene
• Recent edits
  • Displays recently opened Digital Twin Templates and Scenes.
  • Supports filtering (All / Digital Twin Templates / Digital Twin Scenes).
  • Supports two view modes: List /Grid.
  • Click the name to open quickly.

Digital Twin Template

The “Digital Twin Template” section on the homepage is used to manage and view template resources on the platform and mainly includes the following functions:

• New Template

The button New Template at the top of the page allows you to create a new Digital Twin Template.

• Catalog

The left side displays the platform catalog structure and supports creating new folders for easier categorization and management.

• Content

The right side displays the folders and template files (icon: ) in the current directory, and supports searching, switching views, and opening templates.

Digital Twin Scenes

The “Digital Twin Scenes” area on the homepage is used to manage and view scene resources on the platform and mainly includes the following functions:

• New Scene

The New Scene button at the top of the page allows you to quickly create a new Digital Twin Scene.

• Import Scene

Use this to import scenes for the Hands-On Lab, so you can access and work with Hands-On Lab content. For detailed instructions on using the Hands-On Lab, please refer to FactVerseHands-On Lab.

• Export Scene

Supports exporting scene files for sharing and backup.

• Catalog

The left side displays the platform resource directory structure and supports creating new folders for easier categorization and management.

• Resource Content

The right-side displays folders and scene files(icon: )under the current directory, supporting search, view switching, and opening scenes.

Courseware

Visible to users with teacher roles.

On the “Courseware” page, the system displays the list of courseware accessible to the current account.

• Click the name of a courseware that is already bound to a scene to open it for viewing or editing.
• Click the name of a courseware that is not yet bound to a scene, and after opening it, you can select and bind it to the appropriate scene.

Template Editor

In FactVerse Designer, by clicking the New Template button on the homepage or opening any digital twin template, you will enter the Template Editor interface. In the Template Editor, you can define a specific type of digital twin in detail, including metadata, behavior tree, resources, etc.

Menu

The Menu in the Template Editor contains commonly used tools and commands for building digital twin templates. The following menus are included:

Toolbar

In the Template Editor, the “Toolbar” contains commonly used commands as listed in the table below:

Icon	Description
	Home button: Clicking the home button will navigate to the main page. If there are unsaved modifications to the current template, it will prompt whether to save the current template.
	Save button: Save the newly created or modified template.
	Save as button: Clicking the “Save as” button allows you to save the current template as a new file.
	Copy: Copy the selected resource and enter placement mode. Attributes and structures cannot be copied.
	Undo button: Undo the user’s previous action.
	Redo button: Restores the user’s previously undone action.
	Delete: Delete a resource. Attributes and structures cannot be deleted.

Resources

The Resources library is located on the left panel of the Template Editor, providing resource management and quick access. Users can drag resources from the library into the scene to build digital twin templates.

Resources Interface Description

The resources interface is divided into two tabs:

• My Resources: Displays all uploaded 2D/3D graphic assets.
• Libraries: Provides system-predefined device models and utility widgets.

1. My Resources

Users can browse and use uploaded 2D/3D resources from the FactVerse platform.

Resource Status:

• Not Cached: icon is gray, indicating the resource has not been downloaded.
• Downloading: Starts downloading when selected, with a progress indicator.
• Cached: icon is highlighted, indicating the resource is available.

2. Libraries

The Libraries tab contains system-built elements and user-defined utilities:

• Basic Equipment Models:g., material generators, conveyors, AGVs for building factory scenes.
• Functional Tools:g., captions, components, geometric shapes, effects for interactivity and visualization.
• Custom Tools: User-created tools stored under Custom, reusable across templates and scenes. For more details, refer to Custom Tools.

Digital Twin Template Pane

Located below the Resource Library, the Digital Twin Template pane displays the current template’s metadata, resources, and behavior tree. It provides a complete overview and management interface for the digital twin template.

Scene Area

The Scene Area occupies the central workspace of the Template Editor. This is where you create and edit digital twin templates.

Features:

• Scene Resources: Add models, tools, and other resources from the Resource library.
• View Cube: Located at the top-right; click faces or arrows to switch between six views.
• Reset View Button: Return to the default camera position.
• Projection Switch: Toggle between perspective and orthographic projection.

Attribute Pane

The Attribute Pane is located on the right side of the template editor interface and is used to view and edit detailed attributes of the template itself and selected scene resources.

Depending on the selection, it displays:

1. Template Attributes

• • Template Name: Identifier of the template.
  • Description: Explanation of functionality or usage.
  • Thumbnail: Upload or change the preview image.

2. Resource Properties For scene resources (e.g., models from My Resources):

• • Resource Name
  • Pose (Position/Rotation): Includes collision option (enables physical collision detection; see Collision Detection).
  • Data Binding: Bind resource attributes to external data sources. Example: bind sensor data to rotation angle for real-time updates.

3. Tool Resource Properties For tool-type resources (e.g., geometric shapes, effects, web tools):

• • Resource Name
  • Transform (Position/Rotation/Collision)
  • Tool Properties:
    • Specific parameters such as color, size, effect properties.
    • Save Preset: Save the current settings as a Custom Tool, which will appear in Resource Library > Tools > Custom for reuse.

Depending on the selected object, the Attribute Pane is divided into three categories:

1. Template Properties

When clicking on a blank area of the scene, the Attribute Pane shows general information about the current template. You can configure the following:

• Template Name: Identifier for the current template.
• Description: Notes on the purpose or usage scenario of the template.
• Thumbnail: Upload or replace the preview image for quick identification in the Resource Library.

2. Resource Attributes

When a specific resource in the scene is selected (e.g., a model from My Resources), the Attribute Pane displays the relevant configuration options:

• Resource Name: The name of the selected resource.
• Pose: Position, rotation, and collision participation (enables physics-based collision detection).
• Data Binding: Allows linking resource attributes to external data sources for dynamic control. For example, binding a sensor’s data to the “Rotation Angle” enables the model to rotate in sync with real-time field data, delivering a more realistic digital twin effect.

3. Tool Resource Attributes

When a tool-type resource is added to the scene (e.g., geometric shapes, web tools, effects), the Attribute Pane shows tool-specific configuration options:

• Tool Resource Name: The name of the tool component.
• Pose: Position, rotation, and collision participation (same as above).
• Tool Attribute:
  • Tool-specific parameter settings, such as color, size, or effect parameters.
  • Save Preset: After configuration, click Save Preset to store the current settings as a Custom Tool. The custom tool will then appear under Resources > Libraries > Custom, making it easy to reuse in other templates or scenes.

Scene Editor

By clicking New Scene on the Home Page or opening an existing scene, you will enter the Scene Editor interface. In the Scene Editor, you can organize digital twins created from templates into a complete digital twin scene, including twin layout, entrance/exit connections, and more.

Menu

The Menu in the Scene Editor contains commonly used tools and commands for building digital twin scenes. Functions include:

Toolbar

In the Scene Editor, the “Toolbar” contains the following commonly used commands as shown in the diagram below:

Icon	Description
	Home button: Clicking the home button will navigate to the main page. If there are unsaved modifications to the current scene, it will prompt whether to save the current scene.
	Save button: Save the newly created or modified scene.
	Save as button: Clicking the “Save as” button allows you to save the current template as a new file.
	Undo button: Undo the user’s previous action.
	Redo button: Restores the user’s previously undone action.
	Path mode: Enable Path Mode to view and manage paths.
	Positioning mode: Switch to Positioning Mode, allowing users to add, modify, or delete positioning codes, or use reference models to assist scene editing.
	Copy: Copy the selected role or digital twin and enter placement mode. Sub-roles cannot be copied.
	Delete: Delete the selected role or digital twin. Sub-roles cannot be deleted.
	Generate Simulation Record: Run a scene simulation at a set speed (normal or accelerated), record the process data and video, and upload it for later analysis and review.
	Debug Playback: Enter Debug Playback mode to preview and debug scene execution, helping troubleshoot and optimize scene logic.

Digital Twins

You can browse and use digital twin templates and digital twin resources in the Digital Twins tab to quickly build digital twin scenes.

Digital Twin Template Tab

Under the Digital Twin Template tab, you can view all templates uploaded to the platform.

• Load Template: Click on an unloaded twin template to start the loading process. The system will download and cache the template locally.
• Placement Mode: Click on a fully loaded template to enter Twin Placement Mode. In this mode, left-click anywhere in the scene to create a new twin instance at that position. Each click creates one instance, and multiple instances can be placed consecutively. Right-click to exit Placement Mode. For details on creating twins from templates, see the section Manually Creating Digital Twins.

Digital Twin Tab

Under the Digital Twin tab, you can view all publicly available cloud twins (excluding local digital twins). Unreferenced twins can be added directly to the scene.

Resources

The Resource Library is located in the left pane of the Scene Editor, displayed alongside the Digital Twins Library. Its functions are consistent with the Resource Library in the Template Editor. Here, you can browse and use 2D/3D assets and tool components from the platform to quickly build and enrich scene content.

For detailed usage instructions, see: Template Editor > Resources.

Digital Twin Pane

The Digital Twin Pane is located at the lower left of the Scene Editor. It displays all elements in the current scene, including twins, models, tools, documents, lights, and other resources. This pane allows you to view and manage resources in the scene.

Functions

Scene Area

The Scene Area is in the central pane of the Scene Editor interface and serves as the primary workspace for editing digital twin scenes. In this area, you can layout, organize, and edit digital twins, models, and tools to create your desired digital twin scenes.

The main features of the Scene Area in the Scene Editor include:

• Resources layout: You can place digital twins, models, or tools into the scene area, adjust their positions as needed, and start building your digital twin scene.
• Editing and organizing: In the Scene Area, you can edit and organize the added digital twins and models, adjusting their positions, sizes, rotation angles, and more to achieve the desired scene effects.
• Multi-view Display: The scene area supports multi-view display. By clicking on the view cube in the top right corner of the scene area, you can quickly switch between six views (Front View, Back View, Left View, Right View, Top View, Bottom View). This allows you to better observe and edit the scene from different perspectives.
• Viewpoint reset: Clicking the viewpoint reset button  in the Scene Area allows you to return to the initial view, making it convenient for you to adjust and perform operations during the editing process.
• Projection switching: You can switch between perspective projection and orthographic projection in the Scene Area to meet different scene requirements.

Attribute Pane

The Attribute Pane is located on the right side of the Scene Editor. It is used to view and edit the attributes, behavior logic, and layout settings of the currently selected object. The content displayed in the pane changes dynamically depending on the selected object.

Scene Attribute Editing

When you click on a blank area in the scene (no object selected), the Attribute Pane displays the basic information of the current scene. You can configure the following:

Digital Twin Attribute Editing

When you select a digital twin in the scene, the Attribute Pane will display the digital twin’s detailed attributes, such as position, main functions, input/output ports, etc., allowing precise editing and adjustment.

Model Resource Attribute Editing

When a model resource in the scene is selected, the Attribute Pane shows:

• Pose (Location, Rotation, Scale)
• Backface culling: When the selected model or its subcomponents are set to “Backface culling,” they will not be visible from the rear view. This feature is mainly used in scene models, such as when the outer walls of a virtual factory are set to “Backface culling,” showing only the internal structure from the outside perspective to enhance visibility of the interior facilities.

Tool Resource Attribute Editing

When a tool resource (such as geometry, captions, or charts) is selected, the Attribute Pane displays:

• Pose (Position, Rotation)
• Tool-Specific Properties (e.g., color, size, data binding for charts)
• Custom Preset Management (if applicable)

Behavior Tree Editing

Click the Behavior Tree tab at the top of the Attribute Pane to view the behavior tree bound to the current object (such as a scene or a twin). Click on any behavior tree to open it in the Behavior Tree Editor for adjustments. See Behavior Tree Editor for details.

Behavior Tree Editor

FactVerse Designer provides an intuitive visual Behavior Tree Editor, eliminating the need for coding to create complex behavior logic for digital twins.

The Behavior Tree Editor interface consists of the following main components: Toolbar, Node Menu, Behavior Tree Editing Area, and Attribute Pane. Through the combination of the Node Menu, Behavior Tree Editing Area, and Attribute Pane, the Behavior Tree Editor offers a visual and interactive interface, enabling users to easily create, edit, and adjust the structure and behavior logic of behavior trees.

Toolbar

The Behavior Tree Editor’s toolbar contains a series of commonly used functional buttons for operating and managing the editor. Below are explanations of the toolbar buttons and their functions:

1. Back: The “Back” button is used to close the current behavior tree editor and return to the template or scene editor interface. After clicking this button, the behavior tree editor will be closed, and there will be a prompt to save or save as before exiting.
2. Behavior Tree Attributes: This button is used to open or access the settings for the behavior tree’s attributes.
3. Save: The Save button is used to save the currently edited behavior tree to the FactVerse platform.
4. Save As: The Save As button allows users to save the currently edited behavior tree with a different name or path.
5. Zoom: The button allows users to adjust the zoom level of the behavior tree in the editor interface. By clicking the Zoom View button, users can zoom in or zoom out the view of the Behavior Tree Editor to better observe and edit the details of the behavior tree.
6. Undo: Revert the last action.
7. Redo: Restore the last action that was undone.
8. Delete: The Delete nodes button is used to remove the selected node. When a user selects a node and clicks the Delete nodes button, the node will be removed from the behavior tree.

Node Menu

The “Node Menu” is located on the left side of the Behavior Tree Editor interface. From the Node Menu, you can select the appropriate nodes and then drag them into the Behavior Tree Editing Area to create and edit the structure of the behavior tree.

Behavior Tree Editing Area

The “Behavior Tree Editing Area” is the primary workspace for creating and editing the structure and logic of the behavior tree. Users can drag nodes into the editing area, organize them into a tree-like structure, and define the relationships and order between nodes. Users can adjust the positions of nodes and connect the lines between nodes. By working in the Behavior tree editing area, users can intuitively build and modify the structure of the behavior tree.

Attribute Pane

The Attribute Pane is located on the right side of the Behavior Tree Editor interface and is used to set the attributes and execution conditions of behavior tree nodes. When a user selects a node, the Attribute pane displays the relevant attributes and conditional parameters of that node, which the user can set and adjust. The Attribute Pane also allows users to define the execution conditions of nodes, i.e., under what circumstances the node should be executed or skipped. By setting the execution conditions of nodes, users can control the behavior and execution logic of nodes based on specific conditions.

Additionally, users can edit the name of the behavior tree in the attribute area to better manage and identify different behavior trees.