Editing the Plugin Settings (.json file)

The majority of vSMRs settings are read from a '.json' file called "vSMR_Profiles.json" located in the same directory that that plugin is in. This can be opened in any plain test editor such as Notepad.

By default this file contains two profiles: "Default" and "AVISO", which can be selected via the Menu within EuroScope.

You can add more profiles to the settings file or edit the existing profiles by editing this file.

Adding a New Profile

1. Copy all of the data in one of the existing profiles (from the first parenthesis ({) before the "name": "<Profile Name>" line to the matching closing parenthesis (}) of the profile after the "approach_insets": section). For example if copying the default profile copy everything from:

   {
       "name": "Default",
       "font": {
           "use_custom_font": true,
           "font_name": "EuroScope",
           "weight": "Regular",
           "sizes": {
               "one": 11,
               "two": 12,
               ...

until and including:

     ...
     "approach_insets": {
           "extended_lines_lenght": 15,
           "extended_lines_ticks_spacing": 1,
           "extended_lines_color": {
               "r": 255,
               "g": 255,
               "b": 255
           },
           "runway_color": {
               "r": 0,
               "g": 0,
               "b": 0
           },
           "background_color": {
               "r": 127,
               "g": 122,
               "b": 122
           }
       }
   }

2. Add a comma after the last parenthesis (}) in the settings file.

3. Paste the copied data into the very end of the settings file just before the ending square bracket (]).

4. Make sure that the last parenthesis (}) in the file just before the ending square bracket (]) does not have a comma after it.

For example:

   },
]

Is wrong - it should be:

   }
]

Changing the Settings Values in a Profile

Within the settings file the settings take the format:

"<Setting Name>": "<Setting Value>"

Where <Setting Name> denotes an identifier for the setting and the <Setting Value> is what the setting is set to. There are also some grouped settings such as the font settings where a single setting name contains multiple sub settings. The following section will describe what effect changing each setting value will have on the behavior of the vSMR plugin when the profile whose settings have been changed are loaded.

Please note that the pro_mode and uncorrelated settings sections are currently not operational in the current vSMR public release version and are included for reference only.

• name - this controls the name of the vSMR profile - this name will be shown within the menu and will load the settings contained within this settings profile when selected.,

• font - a settings group that controls the properties of the font used by vSMR.

• use_custom_font - if this is set to true the custom font specified within the next options will be used, whereas if it is set to false the default font settings will be used instead. It is recommended that you do set this to true even if you don't have a custom font and use as a font EuroScope and as a weight Regular.

• font_name - the name of the font that will be used. This can be any font which is installed on your computer.

• weight - controls the font styling/weight, this can be set to Regular, Bold, or Italic.

• sizes - a sub-settings group that contains the various font sizes.

  • one - the default font size in pixels.
  • two - the next selectable font size in pixels.
  • three - the next selectable font size in pixels.
  • four - the next selectable font size in pixels.

• filters - a settings group that controls when aircraft are shown on the SMR screen.

• hide_above_alt - the maximum altitude (in feet) that aircraft can be at before they do not appear on the SMR screen.

• hide_above_spd - the maximum speed (in knots) that aircraft can be at before they do not appear on the SMR screen.

• radar_range_nm - the maximum range (in nautical miles) an aircraft can be from the airport being controlled before they do not appear on the SMR screen. 30 nm is a realistic value for an SMR.

• night_alpha_setting - the brightness of the SMR when the Night Mode option is selected from the menu as an alpha value when 255 will be normal brightness and 0 will be completely dark.

• pro_mode - a settings group controlling the Professional Simulation Mode settings.

  • enable - if this is set to true then the professional simulation mode for correlating aircraft primary targets to flightplan data is enabled, whereas if it is set to false then this is disabled and aircraft are always correlated to the correct flightplan data.
  • accept_pilot_squawk - if this is set to true then any aircraft that are squawking a code not listed in the do_not_autocorrelate_squawks will be automatically correlated to their correct flight data, otherwise if it is set to false this does not occur and any aircraft not squawking a controller assigned code will be treated as uncorrelated.
  • do_not_autocorrelate_squawks - if an aircraft is squawking a squawk code in this list and has not been assigned it by a controller then their flight data will not automatically be correlated to their target. This list is enclosed in square brackets ([ and ]) and each squawk in the list should be enclosed by quotation marks and separated from the next squawk by a comma e.g. ["2000", "2200", "1200"].

• labels - a settings group that controls the appearance of aircraft's tags.

• use_aspeed_for_gate - if this is set to true then the assigned speed of an aircraft within EuroScope will be used for the gate tag item, otherwise if it is set to false the scratchpad string will used for the gate tag item instead.

• squawk_error_color - a sub-settings group defining the colour of the sqerror tag item.

  • r - the red value of the RGB colour code from 0 to 255.
  • g - the green value of the RGB colour code from 0 to 255.
  • b - the blue value of the RGB colour code from 0 to 255.

• departure - a sub-settings group controlling the appearance of the tags of aircraft departing from the airfield that is being controlled.

  • two_lines_tag - if this is set to true then the tag will have two lines, whereas if it is set to false the tag will only have a single line.
  • line1 - any of the available tag items (with multiple tag items separated by a comma and a newline) declared within the square brackets ([ and ]) of this setting will be shown on the first line of the tag. Refer to the bottom of the page for the available tag items and their function.
  • line2 - any of the available tag items (with multiple tag items separated by a comma and a newline) declared within the square brackets ([ and ]) of this setting will be shown on the second line of the tag. Refer to the bottom of the page for the available tag items and their function. This will be ignored if the two_lines_tag property is set to false.
  • background_colour - this second sub-settings group defines the background colour of the tag.
    • r - the red value of the RGB colour code from 0 to 255.
    • g - the green value of the RGB colour code from 0 to 255.
    • b - the blue value of the RGB colour code from 0 to 255.
    • a - the alpha value code (controls the transparency) of the item from 0 to 255 where 0 is transparent and 255 is solid.
  • background_colour_on_runway - this second sub-settings group defines the background colour of the tag when an aircraft enters a runway monitored by RIMCAS (without an alert).
    • r - the red value of the RGB colour code from 0 to 255.
    • g - the green value of the RGB colour code from 0 to 255.
    • b - the blue value of the RGB colour code from 0 to 255.
    • a - the alpha value code (controls the transparency) of the item from 0 to 255 where 0 is transparent and 255 is solid.
  • text_color - this second sub-settings group defines the colour of the text on the aircraft's tag.
    • r - the red value of the RGB colour code from 0 to 255.
    • g - the green value of the RGB colour code from 0 to 255.
    • b - the blue value of the RGB colour code from 0 to 255.

• arrival - a sub-settings group controlling the appearance of the tags of aircraft arriving at the airfield that is being controlled.

  • two_lines_tag - if this is set to true then the tag will have two lines, whereas if it is set to false the tag will only have a single line.
  • line1 - any of the available tag items (with multiple tag items separated by a comma and a newline) declared within the square brackets ([ and ]) of this setting will be shown on the first line of the tag. Refer to the bottom of the page for the available tag items and their function.
  • line2 - any of the available tag items (with multiple tag items separated by a comma and a newline) declared within the square brackets ([ and ]) of this setting will be shown on the second line of the tag. Refer to the bottom of the page for the available tag items and their function. This will be ignored if the two_lines_tag property is set to false.
  • background_colour - this second sub-settings group defines the background colour of the tag.
    • r - the red value of the RGB colour code from 0 to 255.
    • g - the green value of the RGB colour code from 0 to 255.
    • b - the blue value of the RGB colour code from 0 to 255.
    • a - the alpha value code (controls the transparency) of the item from 0 to 255 where 0 is transparent and 255 is solid.
  • background_colour_on_runway - this second sub-settings group defines the background colour of the tag when an aircraft enters a runway monitored by RIMCAS (without an alert).
    • r - the red value of the RGB colour code from 0 to 255.
    • g - the green value of the RGB colour code from 0 to 255.
    • b - the blue value of the RGB colour code from 0 to 255.
    • a - the alpha value code (controls the transparency) of the item from 0 to 255 where 0 is transparent and 255 is solid.
  • text_color - this second sub-settings group defines the colour of the text on the aircraft's tag.
    • r - the red value of the RGB colour code from 0 to 255.
    • g - the green value of the RGB colour code from 0 to 255.
    • b - the blue value of the RGB colour code from 0 to 255.

• airborne - a sub-settings group controlling the appearance of the tags of aircraft currently in the air.

  • two_lines_tag - if this is set to true then the tag will have two lines, whereas if it is set to false the tag will only have a single line.
  • line1 - any of the available tag items (with multiple tag items separated by a comma and a newline) declared within the square brackets ([ and ]) of this setting will be shown on the first line of the tag. Refer to the bottom of the page for the available tag items and their function.
  • line2 - any of the available tag items (with multiple tag items separated by a comma and a newline) declared within the square brackets ([ and ]) of this setting will be shown on the second line of the tag. Refer to the bottom of the page for the available tag items and their function. This will be ignored if the two_lines_tag property is set to false.
  • background_colour - this second sub-settings group defines the background colour of the tag.
    • r - the red value of the RGB colour code from 0 to 255.
    • g - the green value of the RGB colour code from 0 to 255.
    • b - the blue value of the RGB colour code from 0 to 255.
    • a - the alpha value code (controls the transparency) of the item from 0 to 255 where 0 is transparent and 255 is solid.
  • background_colour_on_runway - this second sub-settings group defines the background colour of the tag when an aircraft enters a runway monitored by RIMCAS (without an alert).
    • r - the red value of the RGB colour code from 0 to 255.
    • g - the green value of the RGB colour code from 0 to 255.
    • b - the blue value of the RGB colour code from 0 to 255.
    • a - the alpha value code (controls the transparency) of the item from 0 to 255 where 0 is transparent and 255 is solid.
  • text_color - this second sub-settings group defines the colour of the text on the aircraft's tag.
    • r - the red value of the RGB colour code from 0 to 255.
    • g - the green value of the RGB colour code from 0 to 255.
    • b - the blue value of the RGB colour code from 0 to 255.

• uncorrelated - a sub-settings group controlling the appearance of the tags of aircraft whose flight plan data has not been correlated to the aircraft target.

  • two_lines_tag - if this is set to true then the tag will have two lines, whereas if it is set to false the tag will only have a single line.
  • line1 - any of the available tag items (with multiple tag items separated by a comma and a newline) declared within the square brackets ([ and ]) of this setting will be shown on the first line of the tag. Refer to the bottom of the page for the available tag items and their function.
  • line2 - any of the available tag items (with multiple tag items separated by a comma and a newline) declared within the square brackets ([ and ]) of this setting will be shown on the second line of the tag. Refer to the bottom of the page for the available tag items and their function. This will be ignored if the two_lines_tag property is set to false.
  • background_colour - this second sub-settings group defines the background colour of the tag.
    • r - the red value of the RGB colour code from 0 to 255.
    • g - the green value of the RGB colour code from 0 to 255.
    • b - the blue value of the RGB colour code from 0 to 255.
    • a - the alpha value code (controls the transparency) of the item from 0 to 255 where 0 is transparent and 255 is solid.
  • background_colour_on_runway - this second sub-settings group defines the background colour of the tag when an aircraft enters a runway monitored by RIMCAS (without an alert).
    • r - the red value of the RGB colour code from 0 to 255.
    • g - the green value of the RGB colour code from 0 to 255.
    • b - the blue value of the RGB colour code from 0 to 255.
    • a - the alpha value code (controls the transparency) of the item from 0 to 255 where 0 is transparent and 255 is solid.
  • text_color - this second sub-settings group defines the colour of the text on the aircraft's tag.
    • r - the red value of the RGB colour code from 0 to 255.
    • g - the green value of the RGB colour code from 0 to 255.
    • b - the blue value of the RGB colour code from 0 to 255.

• rimcas - a sub-settings group controlling the settings of the RIMCAS system.

• rimcas_label_only - If set to true, when a RIMCAS alert triggers, a third line with the color of the stage will appear above the tag with the word "ALERT", if set to false, then the background color of the tag will change.

• use_red_symbol_for_emergencies - If set to true, an aircraft squawking 7700 will have its leader line and symbol in red instead of white.

• short_timer - if this is set to true then the timer that shows the time until an arriving aircraft touches down will start showing aircraft when they are 60 seconds from touchdown, whereas if it is set to false then aircraft will first be shown when they are 120 seconds from touchdown. It is generally better to use the longer timer if the runway at the airport being controlled handles both arrivals and departures on the same runway and the shorter timer if the runway only handles arrivals.

• rimcas_stage_two_speed_threshold - if the speed of an aircraft is greater than the speed defined here (in knots) then stage two of the RIMCAS system will activate.

• background_color_stage_one - this second sub-settings group defines the colour of the background of an aircraft's tag when the RIMCAS stage one warning has activated for that aircraft.

  • r - the red value of the RGB colour code from 0 to 255.
  • g - the green value of the RGB colour code from 0 to 255.
  • b - the blue value of the RGB colour code from 0 to 255.
  • a - the alpha value code (controls the transparency) of the item from 0 to 255 where 0 is transparent and 255 is solid.

• background_color_stage_two - this second sub-settings group defines the colour of the background of an aircraft's tag when the RIMCAS stage two warning has activated for that aircraft.

  • r - the red value of the RGB colour code from 0 to 255.
  • g - the green value of the RGB colour code from 0 to 255.
  • b - the blue value of the RGB colour code from 0 to 255.
  • a - the alpha value code (controls the transparency) of the item from 0 to 255 where 0 is transparent and 255 is solid.

• targets - a sub-settings group controlling the appearance of the aircraft target symbols.

• show_primary_target - if this is set to true then the primary radar response aircraft target symbol is displayed to the user (this is a yellow aircraft symbol by default), whereas if this setting is set to false then this is not shown.

• target_color - this second sub-settings group defines the colour of the primary radar response aircraft target symbol.

  • r - the red value of the RGB colour code from 0 to 255.
  • g - the green value of the RGB colour code from 0 to 255.
  • b - the blue value of the RGB colour code from 0 to 255.
  • a - the alpha value code (controls the transparency) of the item from 0 to 255 where 0 is transparent and 255 is solid.

• history_one_color - this second sub-settings group defines the colour of the first history trail symbol of a primary radar response aircraft target.

  • r - the red value of the RGB colour code from 0 to 255.
  • g - the green value of the RGB colour code from 0 to 255.
  • b - the blue value of the RGB colour code from 0 to 255.
  • a - the alpha value code (controls the transparency) of the item from 0 to 255 where 0 is transparent and 255 is solid.

• history_two_color - this second sub-settings group defines the colour of the second history trail symbol of a primary radar response aircraft target.

  • r - the red value of the RGB colour code from 0 to 255.
  • g - the green value of the RGB colour code from 0 to 255.
  • b - the blue value of the RGB colour code from 0 to 255.
  • a - the alpha value code (controls the transparency) of the item from 0 to 255 where 0 is transparent and 255 is solid.

• history_three_color - this second sub-settings group defines the colour of the third history trail symbol of a primary radar response aircraft target.

  • r - the red value of the RGB colour code from 0 to 255.
  • g - the green value of the RGB colour code from 0 to 255.
  • b - the blue value of the RGB colour code from 0 to 255.
  • a - the alpha value code (controls the transparency) of the item from 0 to 255 where 0 is transparent and 255 is solid.

• approach_insets - a sub-settings group controlling the appearance of the approach inset windows.

• extended_lines_length - the length, in nautical miles, of the extended centerlines from each active runway on the approach inset display.

• extended_lines_ticks_spacing - the distance interval, in nautical miles, between each perpendicular 'tick' on the extended centerline from each active runway on the approach inset display.

• extended_lines_color - this second sub-settings group defines the colour of the extended centerlines from each active runway on the approach inset display.

  • r - the red value of the RGB colour code from 0 to 255.
  • g - the green value of the RGB colour code from 0 to 255.
  • b - the blue value of the RGB colour code from 0 to 255.
  • a - the alpha value code (controls the transparency) of the item from 0 to 255 where 0 is transparent and 255 is solid.

• runway_color - this second sub-settings group defines the colour of the runways shown on the approach inset display.

  • r - the red value of the RGB colour code from 0 to 255.
  • g - the green value of the RGB colour code from 0 to 255.
  • b - the blue value of the RGB colour code from 0 to 255.
  • a - the alpha value code (controls the transparency) of the item from 0 to 255 where 0 is transparent and 255 is solid.

• background_color - this second sub-settings group defines the background colour of the the approach inset display.

  • r - the red value of the RGB colour code from 0 to 255.
  • g - the green value of the RGB colour code from 0 to 255.
  • b - the blue value of the RGB colour code from 0 to 255.
  • a - the alpha value code (controls the transparency) of the item from 0 to 255 where 0 is transparent and 255 is solid.

Once you are finished changing your settings, validate your file using this website before using it with the plugin: jsonlint.com.

Available Tag Items

• callsign - Aircraft callsign with frequency state and communication type.
• actype - Aircraft type.
• sctype - Aircraft type that changes into squawk error.
• sqerror - Squawk error if there is one, or empty if there is not.
• systemid - The automatically generated system ID for the aircraft.
• deprwy - Departure runway.
• seprwy - Departure runway that changes to speed if speed > 25kts.
• gate - Gate, from the assigned speed or scratchpad.
• sate - Gate, from the assigned speed or scratchpad that changes to speed if speed > 25kts.
• flightlevel - Flightlevel/Pressure altitude of the aircraft.
• gs - Ground speed of the aircraft.
• tendency - Climbing or descending symbol.
• wake - Wake turbulence category.