GENERAL ENVIRONMENT XML PROPERTIES
While most XML files will have elements that are unique to the type of environmental content being created, there are some elements that are more general in use, and these can be used in multiple different contexts within the different XML files. This page documents these general elements and lists all the places where they can be used.
<Vertex />
This sub-element is used to add a vertex position to another element either as a fixed point or as a bias . Note that you should only use one of the following set of attributions for a single vertex, and that this is a self-closing element:
Attribute | Description | Type | Required |
---|---|---|---|
lat |
Latitude of the vertex, in degrees between -90.0° and 90.0°. | Float |
Yes (only if |
lon |
Longitude of the vertex, in degrees between -180.0° and 180.0°. | Float |
Yes (only if |
biasX |
Bias from airport reference along the longitudinal axis in meters. |
Float |
Yes (only if |
biasZ |
Bias from airport reference along the latitudinal axis in meters. | Float |
Yes (only if |
spline |
If this attribute is set to "TRUE", then the vertex being definied will be considred a point on a spline, creating a "smooth" curved corner between the other vertices. | Bool | No |
This element can be used in the following places:
<VisualModel>
This element is used to add a single visual model to an element. This element may also contain <BiasXYZ />
data and can have the following attributes:
Attribute | Description | Type | Required |
---|---|---|---|
heading |
Heading of the model placement, between 0.0° and 360.0°. |
Float |
No |
imageComplexity |
Minimum image complexity setting in Microsoft Flight Simulator 2024 for the objects to appear. For example, objects set at NORMAL will appear if the setting is DENSE, but not appear if the setting is SPARSE. IMPORTANT! This element is DEPRECATED in Microsoft Flight Simulator 2024. It should not be used and is only listed here for legacy context. |
Enum:
|
No |
name |
GUID of desired model object. You can find more information on GUID's here: GUIDs | GUID | Yes |
instanceId |
Optional GUID used to identify this instance of the VisualModel element. You can find more information on GUID's here: GUIDs | GUID | No |
This element is used in the following places:
<BiasXYZ />
This element is used to add an X, Y, Z bias in meters to the placement of an object. The acceptable range of values is unbound, but it is recommended that biases only be applied for small distances.
Attribute | Description | Type | Required |
---|---|---|---|
biasX |
Bias along the longitudinal axis in meters. | Float | Yes |
biasY |
Altitude bias in meters. | Float | Yes |
biasZ |
Bias along the latitudinal axis in meters. | Float |
Yes |
This element is used in the following places:
<Coloration />
This element can be used to change the color blending for an element. Note that this is a self-closing element and has the following attributes:
Attribute | Description | Type | Required |
---|---|---|---|
red |
Red component of the coloration (between 0 and 255). | Integer | Yes |
green |
Green component of the coloration (between 0 and 255). | Integer | Yes |
blue |
Blue component of the coloration (between 0 and 255). | Integer | Yes |
alpha |
Alpha component of the coloration (between 0 and 255). | Integer | No |
override |
Override any base color already added. | Boolean | No |
This element is used in the following places:
<Material />
This element can be used to change the material used for another element. Note that this is a self-closing element and has the following attributes:
Attribute | Description | Type | Required |
---|---|---|---|
guid |
The unique GUID of the material to use. You can find more information on GUID's here: GUIDs | String | Yes |
type |
The type of blending to use for the material. |
String:
|
Yes |
tilingU |
The texture tiling along the width of the runway | Float | Yes |
tilingV |
The texture tiling along the height of the runway | Float | Yes |
width |
Ratio of the width of the item being textured with the material. A value of 1 would be full width. | Float | No |
falloff |
The distance in meters of alpha blending at the edges. Note this does not permit any suffixes like other distance values and is in meters only. | Float | No |
opacity |
The material opacity from 0 - 255. | Integer | No |
This element is used in the following places:
<WorldScript />
This element can be used to define a script file that is attached to the scene elements. Note that this is a self-closing element and has the following attribute:
Attribute | Description | Type | Required |
---|---|---|---|
containerTitle |
The container title of the SimObject to use. | String | Yes |
This element can be used in the following places:
<ObjectReferenceList>
This is a container element for a list of different <ObjectReference>
sub-elements. The element has no attributes and you can only have one <ObjectReferenceList>
element within each element. This element can be used in the following places:
<ObjectReference>
A reference to a single Action to be executed when the service enters this state. You can have multiple <ObjectReference>
definitions within a single <ObjectReferenceList>
element, and they can have the following attributes:
Attribute | Description | Type | Required |
---|---|---|---|
id |
Informal description of the action. Not an actual identifier, but designed to make scripts much more readable. | String | Yes |
InstanceId |
Reference to the GUID of the corresponding action. You can find more information on GUID's here: GUIDs | String | Yes |
<Ndb>
This element is either used to define general NDB navigation beacons, or - when used as a sub-element of the <Airport>
element - it is used to add an NDB to the airport facility database.
NOTE: Editing NDB data may prevent the simulation performing further automatic updates to the NavData for the airport. Please see the following section for more information: Note On Navigation Data
For example:
<?xml version="1.0" encoding="UTF-8"?>
<FSData version="9.0">
<Ndb lat="-31.28611115" lon="-64.20872218" alt="1604F" type="H" frequency="262.0" magvar="2.00000000" region="SA" ident="H" name="CORDOBA" >
<VisualModel name="{2fb72c66-290c-4727-b970-da20984cee83}" />
</Ndb>
</FSData>
This element may contain a <VisualModel>
sub-element and has the following attributes:
Attribute | Description | Type | Required |
---|---|---|---|
lat |
Latitude of the NDB beacon, in degrees between -90.0° and 90.0°. |
Float |
Yes |
lon |
Longitude of the NDB beacon, in degrees between -180.0° and 180.0°. | Float | Yes |
alt |
Altitude of the NDB beacon, in meters. You may add the "F" suffix to convert the value to feet, for example: "13.0F". |
Float |
Yes |
altType |
This is used to determine the referential for the alt field. |
Enum:
|
No |
type |
The type of NDB being used. |
Enum:
|
Yes |
frequency |
The NDB frequency in KHz, from 0.0 to 1737.0. | String | Yes |
range |
Range of NDB in meters or nautical miles. If no suffix is supplied, then the range will be set in meters, however using the "N" suffix converts the range into nautical miles, eg: "45N". If this attribute is not set, it will default to "27N". | String | No |
magvar |
Magnetic variation at the NDB to True North in degrees. Negative for values to the east and positive for values to the west, measured in degrees between -360.0° and 360.0°. | Float | Yes |
region |
The beacon region code (maximum 3 characters, based on iso-3166-2). | String | Yes |
ident |
ICAO code identity for this beacon, with a maximum of five characters. | String | Yes |
name |
Friendly name for ILS beacon. | String | No |
<Vor>
This element is either used to define VOR navigation beacons in the world.
NOTE: Editing VOR data may prevent the simulation performing further automatic updates to the NavData for the world. Please see the following section for more information: Note On Navigation Data
This element may contain the following sub-elements:
For example:
<?xml version="1.0" encoding="UTF-8"?>
<FSData version="9.0">
<Vor lat="-41.14027786" lon="-71.18877770" alt="2800.00000000F" type="HIGH" frequency="117.40" magvar="-9.00000000" region="SA" ident="BAR" name="SAN CARLOS DE BARILOCHE" nav="TRUE" dmeOnly="FALSE" dme="TRUE" >
<Dme lat="-41.14027786" lon="-71.18877770" alt="2800.00000000F" />
<VisualModel name="{c0b537c3-808a-48ba-8eff-e1ca1a872e84}" />
</Vor>
</FSData>
It has the following attributes:
Attribute | Description | Type | Required |
---|---|---|---|
lat |
Latitude of the VOR beacon, in degrees between -90.0° and 90.0°. |
Float |
Yes |
lon |
Longitude of the VOR beacon, in degrees between -180.0° and 180.0°. | Float | Yes |
alt |
Altitude of the VOR beacon, in meters. You may add the "F" suffix to convert the value to feet, for example: "13.0F". |
Float |
Yes |
altType |
This is used to determine the referential for the alt field. |
Enum:
|
No |
type |
The type of VOR being used. |
Enum:
|
Yes |
frequency |
The VOR frequency in MHz, from 108.0 to 117.95. | String | Yes |
magvar |
Magnetic variation at the VOR to True North in degrees. Negative for values to the east and positive for values to the west, measured in degrees between -360.0° and 360.0°. | Float | Yes |
range |
Range of the VOR in meters or nautical miles. If no suffix is supplied, then the range will be set in meters, however using the "N" suffix converts the range into nautical miles, eg: "45N". If this attribute is not set, it will default to "27N". | String | No |
region |
The beacon region code (maximum 3 characters, based on iso-3166-2). | String | Yes |
ident |
ICAO code identity for this beacon, with a maximum of five characters. | String | Yes |
name |
Friendly name for the beacon. | String | Yes |
nav |
Boolean | Yes | |
dmeOnly |
Sets whether the beacon should be considered as only DME. If set to "TRUE" then the dme attribute should also be "TRUE" and a <Dme /> element should be added. |
Boolean | Yes |
dme |
Sets whether the beacon should also have DME. If "TRUE" then a <Dme /> element should be added. |
Boolean | Yes |
tacan |
Sets whether the VOR is part of a Tacan system or not. | Boolean | No |
<Dme />
This is a sub-element of <Vor>
and is used to set up the DME for the beacon. It is a self-closing element and can have the following attributes:
Attribute | Description | Type | Required |
---|---|---|---|
lat |
Latitude of the DME, in degrees between -90.0° and 90.0°. |
Float |
Yes |
lon |
Longitude of the DME, in degrees between -180.0° and 180.0°. | Float | Yes |
alt |
Altitude of the DME, in meters. You may add the "F" suffix to convert the value to feet, for example: "13.0F". |
Float |
Yes |
altType |
This is used to determine the referential for the alt field. |
Enum:
|
No |
range |
Range of the DME in meters or nautical miles. If no suffix is supplied, then the range will be set in meters, however using the "N" suffix converts the range into nautical miles, eg: "45N". If this attribute is not set, it will default to "27N". | String | Yes |