Visual Logic Editor, aka Puzzles

Verge3D Puzzles is a powerful yet easy-to-use tool for creating behavior scenarios. With Puzzles you can make your 3D content interactive and responsive to user actions.

This tool allows non-coders (designers, marketers, engineers, teachers) to significantly extend their possibilities. Even if you are a seasoned programmer you'll find it very helpful both in prototyping and in production.

Running the Editor

The Puzzles editor may be launched from the App Manager by clicking on the corresponding button for an application.

You can also run the editor from the individual application page.

Creating Scenarios

By dragging individual puzzles from the toolbox on the right to the workspace and connecting them together, you can create various scenarios and see how they work with your 3D content right away. Here are some resources that may help you get started:



After clicking this button, your puzzles take effect. Under the hood, the Run button interprets the puzzles currently present in the work space (in all tabs) and produces JavaScript code from them. The code is then executed by the browser and thus applied to the application running in the background.

Most of the times, you can repeatedly click Run in order to immediately apply your tweaks for the puzzles. However, if you want to reset the state of your app and perform a clean run, simply use the browser's standard refresh page button instead. Once the page is refreshed, the puzzles automatically take effect. Be sure to save your changes before reloading the page otherwise they will be lost!


This button saves your puzzles. Similarly to the Run operator, the Save button interprets the puzzles currently present in the work space (in all tabs) and produces JavaScript code from them. However, the code is not executed. Instead, all puzzles and the generated code are saved in the application folder for persistent storage as the files visual_logic.xml and visual_logic.js respectively.

The Save operator requires the local development server to be running. If it is not, a connection error will be displayed:

In this case you should launch 3ds Max or Blender, or, if the program is already running, start the App Manager again.

See also Backup.


As the editor window often obscures the application running in the background, you can use this button to hide it. It can be brought back by clicking the top left puzzle-like button.

Reset / Refresh

Use the browser's standard refresh page button to reload the editor and the application running in the background. All unsaved puzzles or changes will be removed, and all variables and scene objects properties will be reset to their initial values.


Drag the corner of the editor window to resize it.

If the draggable corner is not visible, perform right click and select Reset Editor Dimensions:

Right Click Menu (Over a Puzzle)

The context menu can be invoked by right-clicking on a puzzle (residing in the toolbox or placed in the workspace), or on the empty workspace. The menu provides the access to a bunch of very helpful operators.


Creates a copy of a group of puzzles. You can also use the copy and paste shortcuts Ctrl-C / Ctrl-V to do the same.

Add Comment / Remove Comment

Adds a comment to a puzzle. The comment is represented with a question mark button by clicking on which a comment window is revealed. The comment may be saved persitently in both open and closed state.

A comment can be removed by selecting Remove Comment in the right-click menu.

Inline Inputs / External Inputs

By default, a puzzle can be in its inlined or external inputs form. This menu option switches between these forms. The difference is purely cosmetic, yet sometimes transforming puzzles can make them more readable and compact.

Collapse / Expand

A group of puzzles can be collapsed to make it more compact.

Disable / Enable

Use this menu option to skip a group of puzzles from execution.


Deletes a group of puzzles. Alternatively, use the Del key.

Save to Library

Saves a group of puzzles to the library for the purpose of reusing it later.


Opens the corresponding puzzle's page from the Puzzles Reference. Available both for the toolbox...

...and for puzzles in the workspace:

You can also access these pages from this manual's contents window (on the right).

  • Logic (Generic)
  • Loops (Generic)
  • Text (Generic)
  • Numbers (Generic)
  • Lists (Generic)

Right Click Menu (Over the Workspace)

Undo / Redo

Reverses or repeats the most recently performed action. You can also use the shortcuts Ctrl-Z / Ctrl-Shift-Z.

Straighten Up

Repositions all the puzzles in a tab so that they form a neat line.

Collapse / Expand

Works similarly to the single group variant, except it affects all puzzles in a tab.


Works similarly to the single group variant, except it deletes all puzzles in a tab.

Reset Editor Dimensions

Resizes the editor window to better fit the screen resolution.


Every time you click the Save button, the previously saved file visual_logic.xml is copied to the folder called puzzles_backup with a time stamp added to the file name. This allows you to restore any of the previously saved revisions of your puzzles when you need it. Simply copy a file back to the application folder root and remove the time stamp from its name. Your puzzles will update after refreshing the editor.