This page has been translated automatically.
Video Tutorials
How To
Professional (SIM)
Interface Overview
Assets Workflow
Settings and Preferences
Working With Projects
Adjusting Node Parameters
Setting Up Materials
Setting Up Properties
Using Editor Tools for Specific Tasks
Extending Editor Functionality
Built-in Node Types
Light Sources
World Nodes
Sound Objects
Pathfinding Objects
Setting Up Development Environment
Usage Examples
UUSL (Unified UNIGINE Shader Language)
File Formats
Materials and Shaders
Rebuilding the Engine Tools
Double Precision Coordinates
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
Material Nodes Library
Art Samples
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.

Quick Start with Component System

Let's create a small game project to illustrate typical use cases and best practices for the C++ Component System.

What You Will Learn#

The game that you will create is a simple top-down shooter with physics mechanics. The player controls the character with WASD buttons and rotates it to fire bullets using the cursor. The level has some geometric objects (cubes, spheres, etc) that can be thrown to holes by either pushing or shooting. The game has a time limit based on which the game ends. The application also provides a user interface to show the timer and the current amount of objects left to clear. At the end, the game outputs a widget with the reset functionality.

You will acquire some basic UNIGINE Editor skills and knowledge about the UNIGINE engine in general. The basic workflow for game logic implementation with the C++ Component System is given below.

C++ Component System enables you to implement your application's logic via a set of building blocks — components, and assign these blocks to objects (nodes), giving them additional functionality. A logic component integrates a node, a C++ class, containing logic implementation (actions to be performed), and a property defining a set of additional parameters to be used.

In this tutorial you will learn how to:

  1. Set Up the Project
  2. Create the Controllable Character
  3. Implement Shooting
  4. Generate Physical Objects
  5. Implement Color Zone
  6. Play Background Music
  7. Manage Game Rules
  8. Create the End UI
  9. Build the Project
The following tutorial is written with float coordinates precision for the Community edition of the SDK. If you wish to follow it using an SDK version with double coordinates precision, you must change data types in the code snippets accordingly (vec3 -> dvec3, and so on).

What You Need to Start Coding#

To start developing your code, you need to set up an IDE.

In most cases, it is enough. However, if you have issues, check the articles in the Setting Up Development Environment section.

On Windows#

We recommend you to use Microsoft Visual Studio 2015+:

  1. Follow the link and click Download Visual Studio.
  2. Choose the required version for downloading.
  3. Open the downloaded file and follow the instructions on installation.

UNIGINE automatically uses Visual Studio as the default IDE for editing the code of the C++ project. If it doesn't, you can set it manually via the UNIGINE SDK.

On Linux#

You can use any IDE suitable for C++ development. However, note that within this guide we will use Visual Studio Code:

  1. Follow the link and choose the required version for downloading.
  2. Open the downloaded file and follow the instructions on installation.

If UNIGINE doesn't use your IDE as the default one for editing the code of the C++ project, you can set it manually via the UNIGINE SDK.

You may also need to install a С++ compiler GCC 6.3.0+:

Shell commands
sudo apt install g++

Additional Reference Materials#

For more details refer to the Programming Quick Reference article to learn key information on the workflow stages for developing a project with UNIGINE. It contains code examples that will be useful when developing your first UNIGINE projects.

Last update: 2022-12-14
Build: ()