Advanced: Admin Settings file

Advanced: Admin Settings file

The admin settings file contains some of the configuration settings of a simulator. It allows operations or customer support to set up the simulator as purchased by the customer.

The admin settings file is located at  %LOCALAPPDATA%/CM Labs/SimulatorStore/admin.settings. The admin settings file is not installed by default on a simulator.

As long as the admin settings file is not present, factory default values hard-coded in the software or the content will be used, as described below.

Settings Entries

The file is in JSON format and supports the following entries.

Name

Description

Values

Factory Default

Name

Description

Values

Factory Default

units

the unit system to use when displaying numeric values

  • Metric

  • US Customary

US Customary

language

the language to use in the user interface, if the specified string does not correspond to an available translation file, the factory default will be used.

  • a language_country string of the form xx_CC

en_US

learningPath

whether or not the Learning Path feature is enabled

  • boolean

true

replay

whether or not the replay feature is enabled

  • boolean

true

tandemJoinerIDs

in a tandem setup, the ID of the simulators that should join to the current simulator

  • array of strings

empty

screensSetupOverrides

an array of screens setup overrides to be used, one per equipment type to be overridden.

The array of overrides will be examined only if the screens setup override element of the SimulatorDescription.json file is set to true.

 

  • Format: { "equipmentName": <name>,  "screensSetup": <screensSetupValue> }  where

    • <name>: the Name property of an Equipment as defined in its .vxequipment definition file

    • <screensSetupValue>: Left-Right/Top-Bottom

If no override is specified for a particular Equipment, the screens setup will be taken from the Equipment's vxequipment definition file.

settingsPerEquipment

an array of object each representing a specific equipment with its overridden settings. Currently here is the list of supported settings:

  • “aiAssistant”

    • boolean

    • enables the use of aiAssistantManager

  • Array of JSON object :

image-20250221-175749.png
  • Where “equipmentName” is the Name property of an Equipment as defined in its .vxequipment definition file.

  • Where “settings” is a list of override properties with their values

empty

version

version of the admin.settings file. Currently using the version 1.

  • integer

1

File Sample

Here is a typical example of an admin.settings file:

{ "units": "Metric", "language": "fr_FR", "learningPath": false, "replay": false, "tandemJoinerIDs": [ "CML-ID" ], "screensSetupOverrides": [ { "equipmentName": "VX_EX_EQP_NAME", "screensSetup": "Left-Right" }, { "equipmentName": "VX_BH_EQP_NAME", "screensSetup": "Top-Bottom" } ], "settingsPerEquipment": [ { "equipmentName": "VX_DZ_EQP_NAME", "settings": { "aiAssistant": true } } ], "version": 1 }


The screen orientation “Left-Right” means that the view is setup for horizontal viewing, and does not refer to the physical orientation of the screens themselves.

An Edge screen will be horizontal while on a Advantage setup with 3 screens, the screens will go from left to right, but will be physically in a vertical position.