Getting to know the interface

To open the visual scene logic editor, go to the project page and click on the puzzle icon next to the scene

../../_images/image-124.png

The following window will open where:

../../_images/image-213.png
  1. Workspace
  2. Block Library
  3. Blockly toolbar

Workspace

A logical structure of the scene - a script - is created in the workspace

Workspace controls

../../_images/image-312.png

In order:

  1. Expand editor to full screen
  2. Focus on the center of the work area. The center is determined by existing blocks
  3. Zoom in on workspace
  4. Zoom Out Workspace
  5. Trash from which you can restore recently deleted blocks and groups of blocks

Search by objects

../../_images/image-125.png

In the logic editor, there is a search for blocks by objects in the workspace located on the stage. To call it, you must press the key combination Ctrl + F

  1. Jump to the previous search result
  2. Move to the next search result
  3. Case-sensitive search - search results become dependent on the input of upper or lower case characters

Note

For example, if you want to find “block 1” and in the search write “Block 1” using case sensitivity, then you will not find “block 1”

  1. Search by words - the search occurs only for the entered words

Note

For example, if you want to search for “Player” and start spelling the word, the result will not be shown until the word is entered completely

  1. Close search box
../../_images/image-132.png

Block context menu

../../_images/image-1110.png

Right-clicking on a block opens the context menu of the block, allowing you to:

  1. Duplicate Block
  2. Add a comment to a block
  3. Insert inside/outside
../../_images/image-181.png

Note

This function changes only the visual display of the block

  1. Collapse/expand block
  2. Disable block
  3. Delete block or group of blocks

Block Library

../../_images/image-92.png

The script is assembled from the blocks in the block library. All blocks are grouped into sections according to their purpose: “Logic”, “Actions”, etc.

For objects located on the stage, in the “Objects” section, subsections are created according to the type of objects

Note

You can read more about block types in the corresponding article

Blockly toolbar

../../_images/image-69.png

The toolbar allows:

  1. Apply Changes
  2. Cancel changes
  3. Switch to VR Scene Preview
  4. Switch to scene preview on PC
  5. Go to scene edit mode on PC
  6. Open code (recommended for experienced programmer users)

Highlighting blocks in use

For the convenience of the user, a function was developed to highlight active blocks that are currently being executed in the project. This is useful for debugging and identifying errors in a script

../../_images/image-12.gif

In this example, two blocks are selected at once:

  • An event block that reacts to the collision of objects on the stage. This happens because when the scene starts, we animate the cube by moving it to the side where the sphere is. Therefore, it turns out that at the moment the cube collides with another object, this block is triggered
  • An event block that includes a construction of action blocks on three objects: a cone, a cube, and a sphere

Working with logic of deleted object

When deleting an object from the 3D scene, the user will see a message stating that this “Object is used in logic. Do you want to delete it?”

../../_images/image-161.png

If you delete such an object, then all the logic associated with this object will stop working and the blocks of this object will become inactive

../../_images/image-171.png

However, if you place a new object of the same type as the old one and name it the same, all related logic is reanimated and will work correctly