This page has been translated automatically.
UnigineEditor
Interface Overview
Assets Workflow
Settings and Preferences
Working With Projects
Adjusting Node Parameters
Setting Up Materials
Setting Up Properties
Landscape Tool
Using Editor Tools for Specific Tasks
Extending Editor Functionality
Programming
Fundamentals
Setting Up Development Environment
Usage Examples
UnigineScript
C++
C#
UUSL (Unified UNIGINE Shader Language)
File Formats
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
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.

Configuration Files

Warning
The scope of applications for UnigineScript is limited to implementing materials-related logic (material expressions, scriptable materials, brush materials). Do not use UnigineScript as a language for application logic, please consider C#/C++ instead, as these APIs are the preferred ones. Availability of new Engine features in UnigineScipt (beyond its scope of applications) is not guaranteed, as the current level of support assumes only fixing critical issues.

All global engine-related and project-related settings are grouped and stored in separate configuration files located in your project's data/configs folder. Each configuration file is an XML file that stores settings of a certain type. The set of configuration files is as follows:

  • default.config - this file stores all settings available when working with the Config class in API.
  • default.controls - this file stores keyboard control keys and settings defining the mouse behavior. These settings are configured via the UnigineEditor (Windows -> Settings -> Runtime -> Controls).
  • default.boot - this is the main configuration file, it stores information about location of other configuration files (necessary if the main configuration file is moved to another location). It contains Engine startup parameters, such as paths to GUI skin, loading screens, log-file, system and UnigineEditor cache files, extern defines, console commands, and other startup command-line parameters plus a group of world manager settings.
    Notice
    Values stored in this config file are overridden by the command-line parameters specified at the Engine startup.
  • default.user - this file stores various personal settings, such as helpers (wireframe, profiler, etc.)
    Notice
    This configuration file should be added to the ignore list of your Version Control System (VCS) as it stores preferences of a particular user.

The settings from these files are read by the Engine on the application start-up and used for engine initialization.

By default, the set of configuration files is created automatically on project creation.

Configuration files in the Asset Browser

Configuration File Format#

The configuration file has the following format:

Source code (XML)
<config version="2.12">
	<item name="option_name" type="option_type">option_value</item>
	...
	<item name="option_name" type="option_type">option_value</item>
</config>

Each item corresponds to one setting:

  • option_name - a name of the engine-related and project-related setting. It is the same as a name of the corresponding console variable.
  • option_type - a type of the setting: bool, int, float, string.

To read values from the configuration file and write them back, use the engine.config functions. Use the appropriate methods depending on the type of the target item.

Setting Startup Options via Configuration File#

The application start-up options can be set via both the command-line and the unigine.boot configuration file.

The CLI options specified on the application start-up always take precedence over the ones stored in the configuration file. Some of the CLI options can be changed through the console, so they are automatically stored in the configuration file (this way, after the application is quit, they will be restored on the next start-up). However, there are command-line options that don't change the configuration file, namely:

Notice
You can specify the required options manually by editing the unigine.boot file.

For example, if you specify the -video_app command-line option on the application start-up, the corresponding setting video_app in the configuration file will be ignored.

Notice
All multiple plugin paths (plugin_path) will be ignored, if at least one -plugin_path is specified in the command-line.
Last update: 2020-07-31
Build: ()