This page has been translated automatically.
Video Tutorials
Interface
Essentials
Advanced
How To
Professional (SIM)
UnigineEditor
Interface Overview
Assets Workflow
Settings and Preferences
Working With Projects
Adjusting Node Parameters
Setting Up Materials
Setting Up Properties
Lighting
Landscape Tool
Sandworm
Using Editor Tools for Specific Tasks
Built-in Node Types
Nodes
Objects
Effects
Decals
Light Sources
Geodetics
World Nodes
Sound Objects
Pathfinding Objects
Players
Programming
Fundamentals
Setting Up Development Environment
Usage Examples
C++
C#
UnigineScript
UUSL (Unified UNIGINE Shader Language)
Plugins
File Formats
Materials and Shaders
Rebuilding the Engine Tools
GUI
Double Precision Coordinates
API
Containers
Common Functionality
Controls-Related Classes
Engine-Related Classes
Filesystem Functionality
GUI-Related Classes
Math Functionality
Node-Related Classes
Objects-Related Classes
Networking Functionality
Pathfinding-Related Classes
Physics-Related Classes
Plugins-Related Classes
IG Plugin
CIGIConnector Plugin
Rendering-Related Classes
Content Creation
Content Optimization
Materials
Material Nodes Library
Miscellaneous
Input
Math
Matrix
Textures
Art Samples
Tutorials
Warning! This version of documentation is OUTDATED, as it describes an older SDK version! Please switch to the documentation for the latest SDK version.
Warning! This version of documentation describes an old SDK version which is no longer supported! Please upgrade to the latest SDK version.

Setting Up Environment to Develop Editor Plugins

This article describes the process of configuring development environment required to develop plugins for UnigineEditor depending on your operating system.

Warning
This feature is an experimental one and is not recommended for production use.

UnigineEditor is an application written entirely in C++ relying a lot on the Qt5 framework infrastructure. So, in order to extend its functionality not only C++ programming skills are required, but you should also be familiar with the Qt5 framework, CMake build system.

Notice
Qt Framework version 5.12.3 is required to develop plugins for UnigineEditor.

Windows Environment#

The following actions are to be performed to prepare your environment on Windows:

  1. Download an offline installer for the Qt open-source 5.12.3 from the official web-site for Windows operating system.
  2. Run the installer and click Next in the window that opens.
  3. To start the installation process you will need to enter you Qt account credentials (if you already have an account) or you'll can Sign-up for a new account right in the installer by filling the fields offered, accepting the service terms and clicking Next.

  4. Before proceeding to the next step you'll have to confirm your email, so check your inbox for the new email verification message from the Qt Company and click verification link provided.
  5. After clicking the link you will be redirected to your Qt account at https://login.qt.io/login and prompted to fill other required fields and click Confirm.

  6. As you confirm you may return to your offline installer and click Next, the welcome message shall be displayed, click Next again and the installation process shall continue.

  7. At the next stage specify installation directory and click Next to proceed to the Select Components stage.

  8. Select Components to be installed.

    Notice
    The Sources component is optional, so tick it only if you need to browse through the Qt source code.
  9. Read and confirm that you accept the License agreement and click Next to continue the installation process.
  10. After successful installation of the Qt Framework 5.12.3 you should add a new environment variable named UNIGINE_QTROOT and set its value so that it points to the folder, where the MSVC2015 64bit compiler kit is located.

    On Windows the path should be as follows:
    <YOUR_QT_INSTALLATION FOLDER>\5.12.3\msvc2015_64.

    In our case, for example, "C:\Qt\Qt5.12.3\5.12.3\msvc2015_64"

    1. Open Control Panel → System and select Advanced System Settings
    2. Follow the instructions given in the picture below.

    3. Click OK and close the Control Panel.
    Notice
    If you're using CMake, it's enough to have a path to Qt5.12.3 installation directory in the PATH variable.
  11. Restart your IDE, so that the information on environmental variables is updated.
  12. Now you are ready to start developing your first plugin for UnigineEditor!

Linux Environment#

The following actions are to be performed to prepare your environment on Linux:

  1. Download an offline installer for the Qt open-source 5.12.3 from the official web-site for Linux operating system.
  2. Run the installer and click Next in the window that opens.
  3. To start the installation process you will need to enter you Qt account credentials (if you already have an account) or you'll can Sign-up for a new account right in the installer by filling the fields offered, accepting the service terms and clicking Next.

  4. Before proceeding to the next step you'll have to confirm your email, so check your inbox for the new email verification message from the Qt Company and click verification link provided.
  5. After clicking the link you will be redirected to your Qt account at https://login.qt.io/login and prompted to fill other required fields and click Confirm.

  6. As you confirm you may return to your offline installer and click Next, the welcome message shall be displayed, click Next again and the installation process shall continue.

  7. At the next stage specify installation directory and click Next to proceed to the Select Components stage.

  8. Select Components to be installed.

    Notice
    The Sources component is optional, so tick it only if you need to browse through the Qt source code.
  9. Read and confirm that you accept the License agreement and click Next to continue the installation process.
  10. After successful installation of the Qt Framework 5.12.3 you should add a new environment variable named UNIGINE_QTROOT and set its value so that it points to the folder, where the GCC 64bit compiler kit is located.

    Notice
    If you're using CMake, it's enough adding a path to Qt5.12.3 installation directory to $PATH.

    On Linux the path should be as follows:
    <YOUR_QT_INSTALLATION FOLDER>/5.12.3/gcc_64.

    1. Open the current user's profile into a text Editor

      Source code
      vi ~/.bash_profile
    2. Add the export command for your environment variable.

      Source code
      export UNIGINE_QTROOT=<YOUR_QT_INSTALLATION FOLDER>/5.12.3/gcc_64
    3. Save your changes.
    Notice

    Adding the environment variable to a user's bash profile alone will not export it automatically, the variable will be exported the next time the user logs in. To immediately apply all changes to bash_profile, use the source command.

    Source code
    source ~/.bash_profile
  11. Now you are ready to start developing your first plugin for UnigineEditor!
Last update: 2022-03-10
Build: ()