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 currently selected object, the attributes are divided into the following three categories:

1. Template Attributes

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 Properties

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): Position, rotation, and collision participation (enables physics-based collision detection; see 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 Properties

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	Name	Description
	Home	Returns to the home page. If the current scene has unsaved content, the system prompts you to save it.
	Save	Saves the currently created or modified scene content.
	Save As	Saves the current scene as a new scene copy.
	Undo	Undoes the previous operation.
	Redo	Redoes the undone operation.
	Path Mode	Enables Path Mode for viewing and managing paths.
	Positioning Mode	Switches to Localization Mode, where users can modify, add, or delete positioning codes as needed, or use a reference model to assist scene editing.
	Copy	Copies the selected actor or digital twin and enters placement mode. ⚠ Child actors cannot be copied.
	Delete	Deletes the selected actor or digital twin. ⚠ Child actors cannot be deleted.
	Gravity	Used to enable or disable gravity simulation.
	Generate Simulation Record	Runs scene simulation for a specified duration (accelerated or real-time), records runtime data and video, and uploads them for later analysis and review.
	Debug Playback	Enters Debug Playback mode to preview and debug scene runtime behavior, helping identify runtime issues 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 Create a Digital Twin.

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 properties, behavior logic, and display configuration of the currently selected object. The content shown in the Attribute Pane varies depending on the selected object.

Scene Attribute

When no object is selected, or when you click an empty area in the scene, the Attribute Pane displays basic information about the current scene.

Digital Twin Attribute

After a digital twin in the scene is selected, the Attribute Pane displays its property information and related configuration items. Different types of digital twins contain different properties. The actual content is subject to what is displayed in the Attribute Pane.

Digital twin properties are defined by their templates. To adjust the property item structure or field definitions, modify the corresponding digital twin template.

Digital twin properties usually include the following categories:

The display configuration includes:

• Digital Twin Editing: Enter Digital Twin Editing mode to configure an independent display model for the current digital twin.
• Digital Twin Display Mode: Set how the current digital twin model is displayed in the scene. It supports three modes: Template Model, Digital Twin Model, and Overlay.

For detailed steps, see Configure a Digital Twin Display Model.

Model Resource Properties

When a model resource in the scene is selected, the Attribute Pane displays the related properties of that model.

Common configuration items include:

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.

Preferences

Preferences are used to adjust Designer’s interface display, rendering effects, and interaction methods during scene editing.

Click Settings in the menu bar and select Preferences to open the Preferences panel. In this panel, you can configure language, appearance, rendering level, selection interaction, and rotation mode.

Description

Preferences are global settings and affect both template editing and scene editing in Designer. After a template or scene is closed and reopened, the system retains the previous settings.

Interface and Display Settings

Interface and display settings are used to adjust Designer’s display language, interface style, and scene rendering quality.

Selection Mode

Sets the interaction behavior when clicking and dragging scene objects. It helps users choose whether to move an object at the same time it is selected, based on their editing habits.

Selection interaction supports the following two modes:

Select and Move

When you click an object in the scene and drag while holding the left mouse button, the system selects the object and moves it at the same time. This mode is suitable when you need to quickly adjust object positions.

Select Only

When you click and drag an unselected object in the scene, the system only selects the object and does not move it. After the object is selected, drag it again to move it.

This mode is suitable when you only want to select an object first, view its properties, or switch the selected object. It helps avoid accidental position changes caused by unintended dragging when selecting an object.

Rotation Mode

Rotation Mode sets how the system determines the rotation direction when you drag a rotation handle.

After an object is selected, rotation handles appear around it. You can drag the top, right, or bottom handle to adjust the object’s orientation. Different rotation modes use different mappings between handles and rotation axes.

Rotation Mode supports the following two modes:

Fixed Axis

In this mode, rotation handles are fixed to the object’s own model coordinate axes and do not change with the viewing angle.

No matter which angle you view the object from, the same handle always corresponds to the same model axis.

View Based

In this mode, the system automatically determines which model axis the dragged rotation handle should correspond to based on the current viewing angle.

In other words, the same handle may correspond to different rotation axes from different viewing angles. For example, when viewing an object from the front, the bottom handle may rotate the object around the model Y axis; after switching to a top view, the same handle may rotate the object around the model Z axis.

Recommendations

• To rotate precisely according to the model’s own coordinate axes, select Fixed Axis Based.
• To quickly and intuitively adjust an object’s orientation based on the current viewing angle, select View Based.