Configuration Tokens
Nova supports three main categories of configuration tokens: system tokens, fx file tokens and dll tokens.
System Tokens
System tokens are read directly by Nova and cannot be modified at runtime. They serve a variety of purposes including database, system, channel and feature configuration.
How does Nova parse system tokens?
Nova will use the last value of a system configuration token. Each nova channel parses tokens in the following order:
[DATABASE].cfg from DB_OVERLAY
db_[DATABASE].cfg from DB_OVERLAY
override_[DATABASE].cfg from DB_OVERLAY
custom/pc-nova.cfg
custom/override_[DATABASE].cfg
custom/IG_CONFIG/[AECHELON_DEVICE_CFG]/cluster.cfg
Channel override referenced in igconfig.ccfg. NOTE: This file often includes baseline channel files from software/data/versions which will be parsed first.
Supplemental overrides such as override_host_cigi.cfg or override_standalone_spy.cfg
FX File Tokens
FX tokens are configuration tokens primarily designed to support special effects and other features located in the software branch under [SOFTWARE]\data\DB\DB_SYSTEM\DB_SYS_DATA
Many of these tokens can be tuned at runtime using the FX File Editor.
Overriding FX Tokens
In order to prevent editing token values directly in the DB_SYSTEM subfolders and losing those settings with new runtimes, Nova provides the ability to create an overarching FX override file. This file can be referenced with the following token:
Token Name | Default Value | Range and Description |
|---|---|---|
FX Override | ““ | Path to the fx override file. This should be a relative path starting at E:\CM\data |
The syntax of this override file definea the .fx file being overwritten using a WITH statement and then lists the corresponding tokens from that file being overwritten. Only the tokens listed underneath the WITH statement will be overwritten. All other tokens in that file remain unchanged. The following example shows how to override the color of the first flare type in the OTW channel.
WITH DB_SYSTEM\DB_SYS_DATA\FLARES\Flares_OTW.fx
VEC3F COLOR_0 0.8 0.1 0.1 # default value of 0.4 0.7 0.6DLL Tokens
Nova supports several dll plugins and each of these plugins typically has a corresponding configuration file. The primary dll used is the CIGI dll. This dll parses tokens from the file referenced by the ConfigHostInterfaceFile token.
Other built in dlls include but are not limited to atbosInterface, autoTraffic, sensorHost, and disInterface. Each of these dlls has their own configuration file. It is important to put tokens in their proper file to prevent errors.