This page has been translated automatically.
Video Tutorials
Interface
Essentials
Advanced
How To
Basics
Rendering
Professional (SIM)
UnigineEditor
Interface Overview
Assets Workflow
Version Control
Settings and Preferences
Working With Projects
Adjusting Node Parameters
Setting Up Materials
Setting Up Properties
Lighting
Sandworm
Using Editor Tools for Specific Tasks
Extending Editor Functionality
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
Animations-Related Classes
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
VR-Related Classes
Content Creation
Content Optimization
Materials
Material Nodes Library
Miscellaneous
Input
Math
Matrix
Textures
Art Samples
Tutorials

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 and a C# class, containing logic implementation (actions to be performed), 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
Notice
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.

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 .NET SDK: click Download .NET SDK, run the downloaded file and follow the instructions on installation. .NET SDK is required to develop projects using C# Component System. See also here how to install .NET SDK and check its version.

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: 2024-12-13
Build: ()