AIRPORT XML PROPERTIES
This page lists most of the different elements and attributes required to generate properly formed XML for an airport. Most of the XML shown, is created for you when you use The Scenery Editor tool - included as part of the Developer Mode toolset within Microsoft Flight Simulator 2024. As such, we recommend that you use that tool instead of trying to create your own XML from scratch, and use this page as a reference if you need to edit the files the Scenery Editor creates.
IMPORTANT! When doing work on an already existing airport in the simulator, by default the behavior is to add the new set of data to the existing airport and not to replace the corresponding data. If the objective is to replace the previous set of data, then it is necessary to use a <DeleteAirport>
element to describe what is to be replaced.
Note that this page covers the XML required for the airport and some of it's facilities, but other things like runways and approach routes are not included here to keep the information in more manageable blocks. The links below cover the things that are not included on this page, and all of them would be used within the <Airport>
container element:
Finally, the XML document for an airport must have the following format:
<?xml version="1.0" encoding="utf-8"?>
<FSData version="9.0">
<Airport>
<!-- Airport Data Elements Here -->
</Airport>
</FSData>
The FSData
container element can only be version "9.0" and anything else will fail to parse.
<Airport>
The <Airport>
element is used to indicate the placement of airport facility information. Airports are placed according to their airport reference point and may contain a large amount of data, with the element containing one or more of the following sub-elements:
<AirportArchetype>
<Approach>
<ApronControl>
<Aprons>
<ApronEdgeLights>
<Arrival>
<Com />
<DeleteAirport>
<Departure>
<Helipad />
<HoldingPattern>
<Jetway>
<LightSupport>
<Ndb>
<PaintedElements>
<ProjectedMesh>
<Runway>
<RunwayAlias>
<Services>
<Start />
<TaxiwaySign />
<TextMarking>
<Tower>
<VectorPlacement>
<WasmModule>
The following are also part of an airport definition, but must be defined in the order given:
The <Airport>
element encloses all other elements for the airport definition and it has the following attributes, mainly to describe where it is and the information to be displayed on the world map:
Attribute | Description | Type | Required |
---|---|---|---|
|
The display name for the object in the Scenery Editor. NOTE: this is only used for ordering in the The Scenery Contents List |
String | No |
|
The ID of the parent group this object belongs to. NOTE: this is only used for ordering in the The Scenery Contents List |
Integer | No |
|
The group index of the object. NOTE: this is only used for ordering in the The Scenery Contents List |
Integer | No |
|
The group ID of the object. NOTE: this is only used for ordering in the The Scenery Contents List |
Integer | No |
|
Whether the group has been auto-generated or not. NOTE: this is only used for ordering in the The Scenery Contents List |
Boolean | No |
lat |
Latitude of the airport reference point, in degrees between -90.0° and 90.0°. |
Float |
Yes |
lon |
Longitude of the airport reference point, in degrees between -180.0° and 180.0°. | Float | Yes |
alt |
Altitude of the airport reference point, 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 |
ident |
This is the ICAO code for the Airport being defined, and is used to represent the airport in multiple places. Must be 3 or 4 characters long, eg: "UUWW". |
String | Yes |
name |
This is the name of the airport itself and will be displayed to the user. This string can be localised using the TT:<VARIABLE_NAME> format, as explained in the Localization (LOC Files) documentation. |
String | No |
city |
This is the name of the city that the airport is either in or nearest to. This string can be localised using the TT:<VARIABLE_NAME> format, as explained in the Localization (LOC Files) documentation. |
String | No |
state |
This is the name of the state the airport is in. This string can be localised using the TT:<VARIABLE_NAME> format, as explained in the Localization (LOC Files) documentation. |
String | No |
region |
The region the airport is in. Generally the region would be one of the following:
|
String | No |
country |
This is the name of the country the airport is in. This string can be localised using the TT:<VARIABLE_NAME> format, as explained in the Localization (LOC Files) documentation. |
String | No |
magvar |
Magnetic variation, the angle difference between the magnetic north and true north. Negative for value to the east and positive for value to the west, measured in degrees between -360.0° and 360.0°. | Float | No |
airportTestRadius |
Airport test radius in meters. You may add the "F" suffix to convert the value to feet, for example: "1300.0F". This is the distance around the airport reference point (location) that will be tested for airport object elements. Anything that is an airport element that is outside this area may cause build errors. | Float | No |
trafficScalar |
The volume of AI traffic that is appropriate for this airport. 1.0 would apply to major airports. NOTE: This is a deprecated feature and the value added for this attribute will have no effect in the simulation. |
Float | No |
isOnTIN |
Used to get a different ground materials behavior in certain area. | Boolean | No |
tinColorCorrection |
This option applies colour correction to certain airport features - mainly runways and aprons - to eliminate unnatural TIN colours bleeding into them. Mouse over the image below to see an example of the difference this option can make (note that the difference will depend on the location): This is enabled by default. |
Boolean | No |
onlyAddIfReplace |
Only adds the airport if it was already present in another package. Relevant if the data contained within <Airport> is only complementary and not meant to be used on its own. |
Boolean | No |
applyFlatten |
Generate flattening rectangles on the airport based on runways altitude and inclination. | Boolean | No |
starAirport |
Puts the airport forward on the world map. | Boolean | No |
closed |
Stop the airport from being accessible or interactive in any interface such as the world map, the instruments or the ATC system. The airport is only going to be rendered in the simulator.. | Boolean | No |
groundMergingTransfertBright |
Ground merging bright setting. | Float | No |
groundMergingTransfertDark |
Ground merging dark setting. | Float | No |
<AirportArchetype>
This a sub-element of the <Airport>
element and is used to
This element has the following attribute:
Attribute | Description | Type | Required |
---|---|---|---|
|
The GUID for this archetype override. | String | No |
<ParamOverride />
This is a self-closing sub-element of <AirportArchetype>
and is used to define a single parameter to override and the value to override it with. You may include multiple of these elements to override several of the available properties for any airport, for example:
<AirportArchetype>
<ParamOverride name="RunwayTireGumOpacity" value="0.0"/>
<ParamOverride name="RunwayCrackOpacity" value="0.0"/>
<ParamOverride name="RunwayPatchOpacity" value="0.0"/>
<ParamOverride name="RunwayGroovingOpacity" value="0.0"/>
<ParamOverride name="AsphaltDirtOpacity" value="0.000"/>
<ParamOverride name="TaxiwayTireStainOpacity" value="0.0"/>
</AirportArchetype>
This element has the following attributes:
Attribute | Description | Type | Required |
---|---|---|---|
|
The name of the parameter (as a string) to override the value of. See the Override Parameters List for all the available override parameters. | String | Yes |
value |
The value/string to override the base parameter with. | Mixed | Yes |
Override Parameters List
The table below lists all the parameters that can be used as override parameters in the <ParamOverride />
element:
Parameter String | Description | Type | Unit |
---|---|---|---|
TaxiwayTireGumOpacity |
This will change the opacity (alpha) of the tire gum decal, and should be between 0 (invisible) and 1 (fully opaque). Default value is 0. |
Float | Percent Over 100 |
TaxiwayTireGumMaterial |
This parameter lets you override the default tire gum material with another one from The Material Editor. You supply the GUID of the material to apply, as a string. | String | GUID |
TaxiwayTireGumTiling |
This parameter lets you change the amount that the tire gum decal material is tiled. Default value is 1. | Float | N/A |
TaxiwayTireGumMinCount |
This value sets the minimum number of tire gum decals that can be overlaid (the actual amount will be a random number between the min and max count values). Default value is 1. |
S32 Integer | N/A |
TaxiwayTireGumMaxCount |
This value sets the maximum number of tire gum decals that can be overlaid (the actual amount will be a random number between the min and max count values). Default value is 1. |
S32 Integer | N/A |
TaxiwayTireGumRandomRotation |
This value sets the variation in angle for each of the overlaid tire gum decals. Default value is 0. |
Float | Degrees |
TaxiwayTireGumRandomTranslate |
This value sets the variation in the translation offset for each of the overlaid tire gum decals. Default value is 0. |
Float | Meters |
TaxiwayTireGumMeanWidth |
This value can be used to control the mean/average width over which the tire gum decals will be applied. Default is 20. |
Float | Meters |
TaxiwayTireGumMinDensity |
This value sits the minimum density for the tire gum decals. Default value is 1. |
Float | N/A |
TaxiwayTireGumMaxDensity |
This value sits the maximum density for the tire gum decals. Default value is 1. |
Float | N/A |
RunwayTireGumOpacity |
This will change the opacity (alpha) of the decal, and should be between 0 (invisible) and 1 (fully opaque). | Float | Percent Over 100 |
RunwayTireGumMaterial |
This parameter lets you override the default material with another one from The Material Editor. You supply the GUID of the material to apply, as a string. | String | GUID |
RunwayTireGumWidth |
This parameter controls the relative width of the tire gum decal on the runway, where 1 is the un-scaled base decal width, 0.5 would be half the decal width, and 2 would double the decal width. Default value is 1. |
Float | Scalar |
RunwayTireGumTilingV |
This parameter sets the horizontal tiling amount for the tire gum decal material. Default value is 1. |
Float | N/A |
RunwayTireGumAimingPointRatio |
This parameter sets the distance ratio from the runway aiming point after which the tire gum decal should be stretched. A ratio of 1 will have the decal stretched after the aiming point the same amount as before, 0.5 will be half that distance, 2 will be double that distance. Default value is 1. |
Float | Scalar |
RunwayCrackOpacity |
This will change the opacity (alpha) of the decal, and should be between 0 (invisible) and 1 (fully opaque). Default value is 0. |
Float | Percent Over 100 |
RunwayCrackMaterial |
This parameter lets you override the default material with another one from The Material Editor. You supply the GUID of the material to apply, as a string. | String | GUID |
RunwayCrackMaterialTiling |
This parameter lets you change the amount that the decal material is tiled. Default value is 1. |
Float | N/A |
RunwayCrackMeshTiling |
This parameter will affect the way that the material texture is sampled and shown, as the simulation uses the mesh vertex count to define the "patches" within the decal to be displayed. A high density mesh (ie: lower values) will show a more "noisy" sample from the material, while a lower density mesh (ie: higher values) will show a less noisy sample. Default value is 1. |
Float | Meters |
RunwayCrackWidthMin |
This parameter sets the minimum width for the cracks mesh (the actual width will be a random number between the min and max values). Default value is 1. |
Float | Meters |
RunwayCrackWidthMax |
This parameter sets the maximum width for the cracks mesh (the actual width will be a random number between the min and max values). Default value is 1. |
Float | Meters |
RunwayCrackLengthMin |
This parameter sets the minimum length for the cracks mesh (the actual width will be a random number between the min and max values). Default value is 1. |
Float | Meters |
RunwayCrackLengthMax |
This parameter sets the maximum length for the cracks mesh (the actual width will be a random number between the min and max values). Default value is 1. |
Float | Meters |
RunwayCrackDensity |
This parameter sets the density of the cracks that will be added between the min/max length and width. Default value is 0. |
Float | N/A |
RunwayCrackProfile |
This paramter permits you to set a specific "damage profile" for where the cracks will be clustered. Default value is 0. |
Integer Constant |
|
RunwayCrackOverMarkings |
Setting this to 1 (TRUE) will force the cracks decals to be drawn over the runway markings. A value of 0 (FALSE) means that they will be under the runway markings. Default value is 0. |
Boolean | N/A |
SealedJointOpacity |
This will change the opacity (alpha) of the decal, and should be between 0 (invisible) and 1 (fully opaque). Default value is 0. |
Float | Percent Over 100 |
SealedJointBaseMaterial |
This parameter lets you override the default base material with another one from The Material Editor. You supply the GUID of the material to apply, as a string. | String | GUID |
SealedJointMaterial |
This parameter lets you override the default material with another one from The Material Editor. You supply the GUID of the material to apply, as a string. | String | GUID |
SealedJointMaterialTiling |
This parameter lets you change the amount that the decal material is tiled. Default value is 1. | Float | N/A |
SealedJointMeshTiling |
This parameter will affect the way that the material texture is sampled and shown, as the simulation uses the mesh vertex count to define the "patches" within the decal to be displayed. A high density mesh (ie: lower values) will show a more "noisy" sample from the material, while a lower density mesh (ie: higher values) will show a less noisy sample. Default value is 1. |
Float | Meters |
SealedJointWidthMin |
This parameter sets the minimum width for the sealed joint mesh (the actual width will be a random number between the min and max values). Default value is 1. |
Float | Meters |
SealedJointWidthMax |
This parameter sets the maximum width for the sealed joint mesh (the actual width will be a random number between the min and max values). Default value is 1. |
Float | Meters |
SealedJointLengthMin |
This parameter sets the minimum length for the sealed joint mesh (the actual length will be a random number between the min and max values). Default value is 1. |
Float | Meters |
SealedJointLengthMax |
This parameter sets the maximum length for the sealed joint mesh (the actual length will be a random number between the min and max values). Default value is 1. |
Float | Meters |
SealedJointDensity |
This parameter sets the density of the joints that will be added between the min/max length and width. Default value is 0. |
Float | N/A |
SealedJointProfile |
This parameter permits you to set a specific "damage profile" for where the sealed joint decals will be clustered. | Integer Constant |
|
SealedJointOverMarkings |
Setting this to 1 (TRUE) will force the sealed joints decals to be drawn over the runway markings. A value of 0 (FALSE) means that they will be under the runway markings. Default value is 0. |
Boolean | N/A |
RunwayPatchOpacity |
This will change the opacity (alpha) of the decal, and should be between 0 (invisible) and 1 (fully opaque). Default value is 0. |
Float | Percent Over 100 |
RunwayPatchMaterial |
This parameter lets you override the default material with another one from The Material Editor. You supply the GUID of the material to apply, as a string. | String | GUID |
RunwayPatchColorFade |
This parameter (between 0 and 1) sets how much of the albedo texture colour for the patch materials will be blended with the underlying runway material colour. At 0, no colour from the patch will be used, and at 1, only the patch material colour will be used. Default value is 0. |
Float | Percent Over 100 |
RunwayPatchSizeMin |
This parameter sets the minimum size of the patch decal (the actual size will be a random number between the min and max values). Default value is 0. |
Float | Meters |
RunwayPatchSizeMax |
This parameter sets the maximum size of the patch decal (the actual size will be a random number between the min and max values). Default value is 0. |
Float | Meters |
RunwayPatchDensity |
This parameter sets the density of the patches that will be added between the min/max length and width. Default value is 0. |
Float | N/A |
RunwayPatchProfile |
This parameter permits you to set a specific "damage profile" for where the patch decals will be clustered. | Integer Constant |
|
RunwayGroovingOpacity |
This will change the opacity (alpha) of the grooving decal, and should be between 0 (invisible) and 1 (fully opaque). Default value is 0. |
Float | Percent Over 100 |
RunwayGroovingMaterial |
This parameter lets you override the default grooving material with another one from The Material Editor. You supply the GUID of the material to apply, as a string. | String | GUID |
RunwayGroovingTilingU |
Sets the horizontal tiling amount (along the width of the runway). Defualt value is 1. |
Float | Meters |
RunwayGroovingTilingV |
Sets the horizontal tiling amount (along the length of the runway). Defualt value is 1. |
Float | Meters |
RunwayGroovingMinLength |
Sets the minimum length that the runway needs to be to have the runway groove decals applied (in meters). Default value is 2500. |
Float | Meters |
AsphaltDirtOpacity |
This will change the opacity (alpha) of the decal, and should be between 0 (invisible) and 1 (fully opaque). Default value is 0. |
Float | Percent Over 100 |
AsphaltDirtMaterial |
This parameter lets you override the default material with another one from The Material Editor. You supply the GUID of the material to apply, as a string. | String | GUID |
TaxiwayTireStainOpacity |
This will change the opacity (alpha) of the decal, and should be between 0 (invisible) and 1 (fully opaque). Default value is 0. |
Float | Percent Over 100 |
TaxiwayTireStainMaterial |
This parameter lets you override the default material with another one from The Material Editor. You supply the GUID of the material to apply, as a string. | String | GUID |
ApronPatchOpacity |
This will change the opacity (alpha) of the decal, and should be between 0 (invisible) and 1 (fully opaque). Default value is 0. |
Float | Percent Over 100 |
ApronPatchMaterial |
This parameter lets you override the default material with another one from The Material Editor. You supply the GUID of the material to apply, as a string. | String | GUID |
ApronPatchColorFade |
This parameter (between 0 and 1) sets how much of the albedo texture colour for the patch materials will be blended with the underlying runway material colour. At 0, no colour from the patch will be used, and at 1, only the patch material colour will be used. Default value is 0. |
Float | Percent Over 100 |
ApronPatchSizeMin |
This parameter sets the minimum size of the patch decal (the actual size will be a random number between the min and max values). Default value is 0. |
Float | Meters |
ApronPatchSizeMax |
This parameter sets the maximum size of the patch decal (the actual size will be a random number between the min and max values). Default value is 0. |
Float | Meters |
ApronPatchDensity |
This parameter sets the density of the patches that will be added over the whole apron. Default value is 0. |
Float | N/A |
ApronStainOpacity |
This will change the opacity (alpha) of the stain decal, and should be between 0 (invisible) and 1 (fully opaque). Default value is 0. |
Float | Percent Over 100 |
ApronStainMaterial |
This parameter lets you override the default material with another one from The Material Editor. You supply the GUID of the material to apply, as a string. | String | GUID |
ApronStainColorFade |
This parameter (between 0 and 1) sets how much of the albedo texture colour for the stain materials will be blended with the underlying runway material colour. At 0, no colour from the stain will be used, and at 1, only the stain material colour will be used. Default value is 0. |
Float | Percent Over 100 |
ApronStainSizeMin |
This parameter sets the minimum size of the stain decal (the actual size will be a random number between the min and max values). Default value is 0. |
Float | Meters |
ApronStainSizeMax |
This parameter sets the maximum size of the stain decal (the actual size will be a random number between the min and max values). Default value is 0. |
Float | Meters |
ApronStainDensity |
This parameter sets the density of the stains that will be added over the whole apron. Default value is 0. |
Float | N/A |
ApronCarTireMarkOpacity |
This will change the opacity (alpha) of the decal, and should be between 0 (invisible) and 1 (fully opaque). Default value is 0. |
Float | Percent Over 100 |
ApronCarTireMarkMaterial |
This parameter lets you override the default material with another one from The Material Editor. You supply the GUID of the material to apply, as a string. | String | GUID |
ApronCarTireMarkColorFade |
This parameter (between 0 and 1) sets how much of the albedo texture colour for the tire mark materials will be blended with the underlying runway material colour. At 0, no colour from the tire mark will be used, and at 1, only the tire mark material colour will be used. Default value is 0. |
Float | Percent Over 100 |
ApronCarTireMarkSizeMin |
This parameter sets the minimum size of the tire mark decal (the actual size will be a random number between the min and max values). Default value is 0. |
Float | Meters |
ApronCarTireMarkSizeMax |
This parameter sets the maximum size of the tire mark decal (the actual size will be a random number between the min and max values). Default value is 0. |
Float | Meters |
ApronCarTireMarkDensity |
This parameter sets the density of the cracks that will be added over the whole apron. Default value is 0. |
Float | N/A |
ApronCrackOpacity |
This will change the opacity (alpha) of the decal, and should be between 0 (invisible) and 1 (fully opaque). Default value is 0. |
Float | Percent Over 100 |
ApronCrackMaterial |
This parameter lets you override the default material with another one from The Material Editor. You supply the GUID of the material to apply, as a string. | String | GUID |
ApronCrackMaterialTiling |
This parameter lets you change the amount that the decal material is tiled. Default value is 1. | Float | N/A |
ApronCrackMeshTiling |
This parameter will affect the way that the material texture is sampled and shown, as the simulation uses the mesh vertex count to define the "patches" within the decal to be displayed. A high density mesh (ie: lower values) will show a more "noisy" sample from the material, while a lower density mesh (ie: higher values) will show a less noisy sample. Default value is 1. |
Float | Meters |
ApronCrackWidthMin |
This parameter sets the minimum width for the cracks mesh (the actual width will be a random number between the min and max values). Default value is 1. |
Float | Meters |
ApronCrackWidthMax |
This parameter sets the maximum width for the cracks mesh (the actual width will be a random number between the min and max values). Default value is 1. |
Float | Meters |
ApronCrackLengthMin |
This parameter sets the minimum length for the cracks mesh (the actual width will be a random number between the min and max values). Default value is 1. |
Float | Meters |
ApronCrackLengthMax |
This parameter sets the maximum length for the cracks mesh (the actual width will be a random number between the min and max values). Default value is 1. |
Float | Meters |
ApronCrackDensity |
This parameter sets the density of the cracks that will be added between the min/max length and width. Default value is 0. |
Float | N/A |
<ApronControl>
This a sub-element of the <Airport>
element and is used to add one or more Airline Codes for airport services. Each airline code registers a new Apron Control Unit for use at the airport and enables the airport and other objects to request and use the advanced services that can interact with other airport objects and aircraft. If you do not supply an Apron Control airline code, then this will mean that the airport has to use "fallback" services, which aren't as comprehensive. Note that you can add multiple <ApronControl>
elements and each one will create a new apron control unit with the designated airline code. Normally, this is the procedure for airports with multiple gates and aircraft parking spots, as you would want to have one control unit per gate (or cluster of gates).
For more information on the advanced setup of Apron Services, please see here:
This element has the following attribute:
Attribute | Description | Type | Required |
---|---|---|---|
|
Here you can give an airline code which is used to identify the airport service to be associated with the airport. |
String | No |
<Aprons>
This a sub-element of the <Airport>
element and is used to add aprons to an airport. The element has no attributes but can contain one or more <apron>
sub-element, explained below.
<Apron>
This element is used to add an apron to the <Aprons>
list of an airport. This element usually contains multiple <Vertex />
sub-elements and can also contain a <Coloration />
element. It has the following attributes:
Attribute | Description | Type | Required |
---|---|---|---|
surface |
The surface material type to use. |
String:
|
Yes |
drawSurface |
Whether to draw the underlying surface or not. |
Bool |
No |
drawDetail |
Whether to draw the detail texture surface or not | Bool | No |
|
When this attribute is set to "TRUE", the surface material will be applied to the local coordinates of the apron. This means that moving the apron will also move the surface material, keeping it aligned with the position of the apron. When set to "FALSE", moving the apron will not change the position of the surface material. Default value is "TRUE". |
Bool | No |
|
When this attribute is set to "TRUE", the surface material will be stretched to fit within the bounds of the apron area, such that changing the apron scale will also change the scale of the material being applied. When set to "FALSE", the material will not be stretched when you change the size of the apron object. Note that if this is "TRUE" then the Default value is "FALSE". |
Bool | No |
|
When this attribute is "TRUE", the UV coordinates for the texture that the applied material is using will be flipped. Default value is "FALSE". |
Bool | No |
|
When this attribute is "TRUE", the apron is considered a rectangular area. Default value is "FALSE". |
Bool | No |
|
This attribute sets the render priority for the apron. If you have overlapping aprons and want one to render over another one, then you will need to change this value. Higher priority values will render over lower priorities, for example, an apron with priority 1 will render over one with priority 0, which in turn will render over one with priority -1. Note that the render pipeline cannot guarantee the render order for aprons with the same priority, so if you need something to always render over or under something else, you need to set this value. Default value is 0. |
Float | No |
|
This attribute permits you to change the tiling scale for the applied material texture. Note that if this is included in the XML then the Default value is 1. |
Float | No |
|
This attribute permits you to offset the texture alignment along the U axis, and should only be included int he XML is the tiling attribute has been set. Default value is 0. |
Float | No |
|
This attribute permits you to offset the texture alignment along the V axis, and should only be included int he XML is the tiling attribute has been set.
Default value is 0. |
Float | No |
|
This attribute rotates the surface material texture within the apron area, changing it's orientation without changing the orientation of the apron itself. Default value is 0. |
Float | No |
|
This attribute can be used to "feather" the edges of the apron, removing the hard edge where the apron ends and the terrain begins. The value given should be in meters. Default value is 0. |
Float | No |
|
This attribute can be used to make the apron surface texture more or less transparent. You give a value between 0 and 1, where 0 is fully transparent, and 1 is fully opaque. Default value is 1. |
Float | No |
|
When set to "TRUE", this attribute will merge the terrain textures with the material texture that is used for the apron. Default value is "FALSE". |
Bool | No |
|
When set to "TRUE", this attribute will remove any vegetation that is near the edge of the taxiway path object. Default value is "FALSE". |
Bool | No |
|
When set to "TRUE", this attribute will remove any vegetation that is within the bounds of the taxiway path object. Default value is "TRUE". |
Bool | No |
<ApronEdgeLights>
This a sub-element of the <Airport>
element and is used to define the edge lights to the apron of an airport. Note that this element is defined under the main <Airport>
element, and not as part of the <Apron>
sub-element, and it usually contains multiple <EdgeLights>
sub-elements and has no attributes.
<EdgeLights>
This element is used to add edge lights to the <ApronEdgeLights>
list of an airport. This will contain multiple <Vertex />
sub-elements - where each vertex corresponds to a position between which lights will be drawn - and has no attributes.
<Com />
This a sub-element of the <Airport>
element and is used to add a COM (communication) frequency to an airport. Note that this is a self-closing element and has the following attributes:
Attribute | Description | Type | Required |
---|---|---|---|
frequency |
Frequency for COM in MHz, between 108.0 to 136.992. | Float | Yes |
type |
The type of COM frequency. |
Enum:
|
Yes |
name |
Friendly name for COM frequency (48 characters max) | String | Yes |
NOTE: Editing COM 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
<DeleteAirport>
This a sub-element of the <Airport>
element and is used to remove certain features from the area the airport occupies. Since most of the airports that are going to be edited are preexisting airports within the simulator, it is important to understand the behavior behind the <DeleteAirport>
structure: when loading two packages that cover the same airport, the simulator will load both versions of the airport from each package, adding the data from each package together, rather than overriding one package with another. In the case that this is not what you want, you need to use this element to remove features from any previously loaded airport (including those that are defined as part of the base sim).
This element can have the following attributes:
Attribute | Description | Type | Required |
---|---|---|---|
deleteAllApproaches |
Remove all data coming from <Approach> fields |
Boolean | No |
deleteAllApronLights |
Remove all data coming from <ApronEdgeLights> field |
Boolean | No |
deleteAllAprons |
Remove all data coming from <Aprons> field |
Boolean | No |
deleteAllArrivals |
Remove all data coming from <Arrival> fields |
Boolean | No |
deleteAllControlTowers |
Remove all data coming from <Tower> fields |
Boolean | No |
deleteAllDepartures |
Remove all data coming from <Departure> fields |
Boolean | No |
deleteAllFrequencies |
Remove all data coming from <Com> fields |
Boolean | No |
deleteAllHelipads |
Remove all data coming from <Helipad> field |
Boolean | No |
deleteAllILSs |
Remove all data coming from <ILs> fields |
Boolean | No |
deleteAllJetways |
Remove all data coming from <Jetway> fields |
Boolean | No |
deleteAllLightSupports |
Remove all data coming from <LightSupport> fields |
Boolean | No |
deleteAllPaintedElements |
Remove all data coming from <PaintedElements> fields |
Boolean | No |
deleteAllRunways |
Remove all data coming from <Runway> field |
Boolean | No |
deleteAllStarts |
Remove all data coming from <Start> field |
Boolean | No |
deleteAllTaxiways |
Remove all data coming from <TaxiwayPoint> , <TaxiwayParking> , <TaxiwayPath> and <TaxiwayName> fields |
Boolean | No |
deleteAllTaxiwaySigns |
Remove all data coming from <TaxiwaySign> fields |
Boolean | No |
deleteAllTerminalNDBs |
Remove all data coming from <Ndb> fields |
Boolean | No |
deleteAllTerminalWaypoints |
Remove all data coming from <Waypoint> fields |
Boolean | No |
deleteAllVectorPlacement |
Remove all data coming from <VectorPlacement> fields |
In addition to these attributes, there exist other sub-elements which can be contained within the <DeleteAirport>
structure in order to have a more refined deletion of certain objects. These are listed below.
<DeleteRunway />
The purpose of the <DeleteRunway />
element is to delete a specific runway from an airport. Note that this is a self-closing element and has the following attributes:
Attribute | Description | Type | Required |
---|---|---|---|
surface |
GUID or Name of the surface of the runway to delete | GUID or String | Yes |
number |
Number of the runway to delete. Note that you do not suffix the designator onto this value, but instead define it separately in the designator attribute. |
Integer:
or Enum:
|
Yes |
designator |
Designator of the runway to delete |
Enum:
|
Yes |
<DeleteStart />
The purpose of the <DeleteStart />
element is to delete a start location from an airport. This element is available but rarely required. Note that this is a self-closing element and has the following attributes:
Attribute | Description | Type | Required |
---|---|---|---|
type |
Type of start to delete |
ENUM:
|
Yes |
number |
Number of the runway where the start is found |
Integer:
or Enum:
|
Yes |
designator |
Designator of the runway where the start is found |
Enum:
|
Yes |
<Helipad />
This a sub-element of the <Airport>
element and can be used to define one or more helipads within an airport facility.
NOTE: If you wish the helipad to be available as a starting location for helicopter flights, then you also need to define a <Start />
element of the type "HELIPAD".
This is a self-closing element and has the following attributes:
Attribute | Description | Type | Required |
---|---|---|---|
lat |
Latitude of the helipad, in degrees between -90.0° and 90.0°. |
Float |
Yes |
lon |
Longitude of the helipad, in degrees between -180.0° and 180.0°. | Float | Yes |
alt |
Altitude of the helipad, in meters. You may add the "F" suffix to convert the value to feet, for example: "13.0F". |
Float |
Yes |
alt_type |
This is used to determine the referential for the alt field |
Enum:
|
No |
surface |
Surface material to apply to the helipad |
String:
|
No |
heading |
Facing angle for the helipad. Value between 0° and 360°. | Float | Yes |
length |
Length of the helipad. Length is in meters, but you can suffix the value with "F" for feet, eg: "2000F". | Float | Yes |
width |
Width of the helipad. Length is in meters, but you can suffix the value with "F" for feet, eg: "2000F". Float Yes | Float | Yes |
type |
The type of helipad. Note that if you enter type as CIRCLE or SQUARE and the length and width are not identical, then the shape of the helipad will be an ellipse or rectangle, respectively. |
Enum:
|
Yes |
closed |
Boolean indicating whether the helipad is closed (TRUE) or not (FALSE) | Boolean | No |
transparent |
Boolean indicating that the helipad should be drawn without pavement (markings only) | Boolean | No |
|
This attribute will add a Final Approach and Takeoff (FATO) area to the helipad of the given length, in meteres. Default value is 0. |
Float | No |
|
This attribute will add a Final Approach and Takeoff (FATO) area to the helipad of the given width, in meteres. Default value is 0. |
Float | No |
|
This attribute tells the simulation to display the FATO area markings for a runway when set to "TRUE". Default value is "FALSE". |
Boolean | No |
|
This attribute, when included in the XML will display the given value as a runway number within the Final Approach and Takeoff (FATO) markings. Default value is 0. |
Integer | No |
|
This attribute, when set to "TRUE", will prefix the runway numbers 1 - 9 with a 0, as done in European airports. default value is "FALSE" |
Boolean | No |
|
This is the index of the Apron Controller to be assigned to this taxiway stand service location. IMPORTANT! This index value cannot be set in the XML and is assigned by the The Scenery Editor when you assign an Apron Control to a helipad. |
Integer | No |
<HoldingPattern>
<Jetway>
Jetway elements are part of an <Airport>
element, and must contain a single
element. One jetway can service at most one parking spot. A jetway will be animated and will usually come in to the main exit on the left side of the aircraft. AI controlled aircraft will also trigger the animation of the jetway. To replace jetways at an airport, use the <DeleteAirport>
element with the <deleteAllJetways>
field set to "TRUE", then enter the new jetway elements. Note that all parking spots do not require jetways.
The available attributes for jetways are as follows:
Attribute | Description | Type | Required |
---|---|---|---|
gateName |
Gate or parking spot name. All Jetways require a name and a |
Enum:
|
Yes |
parkingNumber |
The number for the parking spot. All Jetways require a number and a |
String | Yes |
suffix |
Suffix to be added to the jetway parking name and number. |
Enum:
|
<LightSupport>
This a sub-element of the <Airport>
element and is for adding a rectangular surface (sloped or flat) that will determine the altitude of all lights within the defined rectangle. Note that this is a self-closing element and has the following attributes:
Attribute | Description | Type | Required |
---|---|---|---|
latitude |
Latitude of the light support object, in degrees between -90.0° and 90.0°. |
Float |
Yes |
longitude |
Longitude of the light support object, in degrees between -180.0° and 180.0°. | Float | Yes |
altitude |
Initial altitude of the light support rectangle (in meters). | Float | Yes |
altitude2 |
Final altitude of the light support rectangle (in meters). | Float | Yes |
heading |
Facing angle for the support rectangle. Value between 0° and 360°. | Float | Yes |
width |
The width of the rectangle in meters. | Float | Yes |
length |
The length of the rectangle in meters | Float | Yes |
excludeLights |
Whether to exclude lights in the rectangle or not (this will exclude the lights, and the light model objects) | Bool | No |
excludeLightObjects |
Whether to exclude only the light objects or not (if set to TRUE, then the lights will still appear as "floating" bright points without their object model). | Bool | No |
<PaintedElements>
This a sub-element of the <Airport>
element and permits you to define the different painted lines and other things that are on the airport ground. It has no attributes and can contain the following sub-elements:
<PaintedPolygon>
This element is a sub-element of <PaintedElements>
and is used to paint a polygon area within an airport, and as such uses the <Vertex />
sub-element to define the area being painted (minimum required is three vertices). It has the following attributes to define the color that is to be used:
Attribute | Description | Type | Required |
---|---|---|---|
red |
Red component of the paint (between 0 and 255). | Integer | Yes |
green |
Green component of the paint (between 0 and 255). | Integer | Yes |
blue |
Blue component of the paint (between 0 and 255). | Integer | Yes |
alpha |
Alpha component of the paint (between 0 and 255). | Integer | No |
<PaintedLine>
This element is a sub-element of <PaintedElements>
and is used to paint a line, and as such it requires at least two <Vertex />
sub-elements to define the start and end points of the line, although you can define more vertices if required between those points. It has the following attributes to define the type of line to be painted:
Attribute | Description | Type | Required |
---|---|---|---|
type |
The type of line to be painted. |
Enum:
|
Yes |
trueAngle |
Set the true angle type. |
Enum:
|
Yes |
surface |
Material to apply to the line. |
String:
|
Yes |
<PaintedHatchedArea>
This element is a sub-element of <PaintedElements>
and is used to paint a cross hatched polygon, and as such uses the <Vertex />
sub-element to define the area being painted (minimum required is three vertices). It has the following attributes to define the area that is to be used:
Attribute | Description | Type | Required |
---|---|---|---|
heading |
Facing angle for the hatching. Value between 0° and 360°. | Float | Yes |
spacing |
The distance between the lines of the hatching. The distance is in meters, but you can suffix the value with "F" for feet, eg: "2F". |
Float | Yes |
type |
The type of line to be used for the hatching. |
Enum:
|
Yes |
<RunwayAlias>
This a sub-element of the <Airport>
element and is used when replacing components inside of an airport (like taxiways), but the intent is not to replace the actual runways. This element serves as a note to the compiler that the old runway definition is to be preserved. This is a self-closing element and has the following attributes:
Attribute | Description | Type | Required |
---|---|---|---|
number |
Number of the runway. Note that you do not suffix the designator onto this value, but instead define it separately in the designator attribute. |
Integer:
or Enum:
|
Yes |
designator |
Designator of the runway. |
Enum:
|
No |
<Services>
This a sub-element of the <Airport>
element and has no attributes, It is used as a container for the self-closing <Fuel />
element
<Fuel />
This element has the following attributes:
Attribute | Description | Type | Required |
---|---|---|---|
type |
The type of fuel the service offers. |
Enum:
|
Yes |
availability |
The fuel availability. |
Enum:
|
Yes |
Note that this element can also be used in the deprecated legacy element
.
<Start />
This a sub-element of the <Airport>
element and is used to add a start location to the airport in general. Note that this is a self-closing element and has the following attributes:
Attribute | Description | Type | Required |
---|---|---|---|
type |
Type of start point. If it's a helipad, then you must also define an <Helipad /> element, and for all the others a <Runway> element. |
Enum:
|
Yes |
lat |
Latitude of the start position, in degrees between -90.0° and 90.0°. |
Float |
Yes |
lon |
Longitude of the start position, in degrees between -180.0° and 180.0°. | Float | Yes |
alt |
Altitude of the start position, in meters. You may add the "F" suffix to convert the value to feet, for example: "13.0F". |
Float |
Yes |
alt_type |
This is used to determine the referential for the alt field |
Enum:
|
No |
heading |
Facing angle for the start position. Value between 0° and 360°. | Float | Yes |
number |
Number of the runway to start on. Note that you do not suffix the designator onto this value, but instead define it separately in the designator attribute. |
Integer:
or Enum:
|
No |
designator |
Designator of the runway chosen to start on. |
Enum:
|
No |
<TextMarking>
This element is a sub-element of the <Airport>
element, and is used to add a text object to the airport facility. This element can contain the following sub-elements:
<ColorText />
(required)<ColorBackground />
<ColorOutline />
The element has the following attributes:
Attribute | Description | Type | Required |
---|---|---|---|
lat |
Latitude of the text marking, in degrees between -90.0° and 90.0°. | Float | Yes |
lon |
Longitude of the text marking, in degrees between -180.0° and 180.0°. | Float | |
heading |
Facing angle for the text marking. Value between 0° and 360°. | Float | |
scale |
The scale multiplier for the text marking. A value of 1 is the default scale. | Float | |
letterSpacing |
The horizontal spacing offset between the letters of the text. Setting this to 0 uses the default spacing, while larger numbers will increase the spacing and lower numbers will decrease it. | Float | |
lineSpacing |
The vertical spacing offset between the lines of the text. Setting this to 0 uses the default spacing, while larger numbers will increase the spacing and lower numbers will decrease it. | Float | |
paddingX |
Sets the visual padding around the text on the horizontal axis. Setting this to 0 uses the default padding, while larger numbers will increase the padding and lower numbers will decrease it. The effect of this value is only visible when you have set either drawBackground or drawOutline (or both) to "true". |
Float | |
paddingY |
Sets the visual padding around the text on the vertical axis. Setting this to 0 uses the default padding, while larger numbers will increase the padding and lower numbers will decrease it. The effect of this value is only visible when you have set either drawBackground or drawOutline (or both) to "true". |
Float | |
outlineThickness |
Sets the thickness of the text object outline. The default value is 0.1, and note that this will only be visible if the drawOutline attribute is "true". |
Float | |
drawBackground |
Sets whether there should be a background to the text ("true") or not ("false"). If set to "true" then you can include the <ColorBackground /> element to set the background colour. |
Boolean | |
drawOutline |
Sets whether there should be a background to the text ("true") or not ("false"). If set to "true" then you can include the <ColorBackground /> element to set the background colour. |
Boolean | |
center |
When this is set to "true" text will be centered within the marking area, while setting it to "false" means that all text will be left-justified. | Boolean | |
label |
This is the text that will be displayed in the marking. See the section below on Label Contents. | String |
Label Contents
The contents of the label
attribute can can be any upper or lower case letter (A
- Z
, a
- z
), any numerical digit (0
- 9
), or any one of the following characters:
Character | Symbol Description | Example |
---|---|---|
* |
The next letter will be half height. For example: AB*CD |
|
** |
All subsequent letters will be half height until For example: A**BCD |
|
[,[[,[[[ |
Roman numerals for 1, 2, and 3. | |
< |
Left Arrow | |
^ |
Up Arrow | |
> |
Right Arrow | |
! |
Down Arrow | |
^< |
Up-Left Arrow | |
^> |
Up-Right Arrow | |
!< |
Down-Left Arrow | |
!> |
Down-Right Arrow | |
/\.,-'# |
Special Characters | |
$ |
New line. |
<ColorText />
This is a self-closing sub-element of <TextMarking>
and is used to set the colour of the text within the text marking object. This element must be included to set the text colour, and has the following attributes:
Attribute | Description | Type | Required |
---|---|---|---|
red | The red component of the text colour, expressed as a value between 0 and 255. | Integer | Yes |
green | The green component of the text colour, expressed as a value between 0 and 255. | ||
blue | The blue component of the text colour, expressed as a value between 0 and 255. | ||
alpha | The alpha component of the text colour, expressed as a value between 0 and 255. |
<ColorBackground />
This is an optional, self-closing, sub-element of <TextMarking>
and is used to set the colour of the text marking background. The element has the following attributes:
Attribute | Description | Type | Required |
---|---|---|---|
red | The red component of the text background colour, expressed as a value between 0 and 255. | Integer | Yes |
green | The green component of the text background colour, expressed as a value between 0 and 255. | ||
blue | The blue component of the text background colour, expressed as a value between 0 and 255. | ||
alpha | The alpha component of the text background colour, expressed as a value between 0 and 255. |
<ColorOutline />
This is an optional, self-closing, sub-element of <TextMarking>
and is used to set the colour of the text marking outline. The element has the following attributes:
Attribute | Description | Type | Required |
---|---|---|---|
red | The red component of the text outline colour, expressed as a value between 0 and 255. | Integer | Yes |
green | The green component of the text outline colour, expressed as a value between 0 and 255. | ||
blue | The blue component of the text outline colour, expressed as a value between 0 and 255. | ||
alpha | The alpha component of the text outline colour, expressed as a value between 0 and 255. |
<Tower>
This a sub-element of the <Airport>
element and is used to place an air traffic control tower location at an airport. This element must contain a single
element, and has the following attributes:
Attribute | Description | Type | Required |
---|---|---|---|
lat |
Latitude of the tower location, in degrees between -90.0° and 90.0°. | Float | Yes |
lon |
Longitude of the tower location, in degrees between -180.0° and 180.0°. | Float | Yes |
alt |
Altitude of the tower location, in meters. You may add the "F" suffix to convert the value to feet, for example: "13.0F". | Float | Yes |
alt_type |
This is used to determine the referential for the alt field |
Enum:
|
No |
overrideSize |
Used to override the default size. |
Enum:
|
No |
overrideLevel |
Used to override the default level (values from 0 - 255 only). | Integer | No |
<Waypoint>
This a sub-element of the <Airport>
element and is used to add a waypoint to the airport facility database.
NOTE: Editing Waypoint 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
This element may contain the optional sub-element <Route>
, but if it has no sub-elements it can be self-closing. The element has the following attributes:
Attribute | Description | Type | Required |
---|---|---|---|
lat |
Latitude of the waypoint, in degrees between -90.0° and 90.0°. |
Float |
Yes |
lon |
Longitude of the waypoint, in degrees between -180.0° and 180.0°. | Float | Yes |
waypointType |
The type of waypoint. |
Enum: |
Yes |
waypointRegion |
The waypoint region code (maximum 3 characters, based on iso-3166-2). | String | Yes |
waypointIdent |
The identity for this waypoint, with a maximum of five characters. | String | Yes |
magvar |
Magnetic variation, the angle difference between the magnetic north and true north. Negative for value to the east and positive for value to the west, measured in degrees between -360.0° and 360.0°. | Float | No |
<Route>
This element is used to add a route designation to a waypoint. The element has the following attributes:
Attribute | Description | Type | Required |
---|---|---|---|
routeType |
Latitude of the airport reference point, in degrees between -90.0° and 90.0°. |
Enum:
|
Yes |
name |
The name of the route (maximum 8 characters). | String | Yes |
<VectorPlacement>
This a sub-element of the <Airport>
element and is for adding in a series of points that will be connected by a vector path and then have a model placed along the path, useful for creating things like fences or power-lines, etc... This element requires at least two <Vertex />
sub-elements to define the points between which the models will be placed.
NOTE: This element replaces the deprecated elements.
The element has the following parameters:
Attribute | Description | Type | Required |
---|---|---|---|
profile |
This is the GUID of the model that will be used to populate the vector path. |
String |
Yes |
snapToVertices |
When this attribute is set to "TRUE" the chosen model will only be placed on the single vertices (points) that make up the vector path, instead of being placed along the lengths of the vectors. Default value is "FALSE". | Bool | No |
spacing |
This sets the spacing (in meters) between the models as they are placed along the vector path. This set to a value that brings the object models closer together to keep continuity between them. | Float | Yes |
heading |
This attribute can be used to modify the orientation (heading) of the model by a value in degrees. This will be a relative orientation if the rotation attribute is set to "Follow edge" or "Random", and an absolute orientation if the attribute is "Same". |
Float | Yes |
scale |
This attribute is used to scale the model up or down. The base value is 1, and a value less than one will scale it down and a value greater than 1 will scale it up. This will also be cummulative with the scale applied if the scaleDelta option is greater than 0. |
Float | Yes |
scaleDelta |
This attribute will add a random variation in scale to each model placed along the vector path. The default value is 0, which is no random variation, and any value greater than 0 will be used to apply a random variation in size to each model using the given value as a magnitude for the variation. This variation will be cumulative with the scale setting. |
Float | Yes |
rotation |
With this attribute you can change the way the model rotation will be handled by the simulation. It can be one of the following strings:
|
String | Yes |
avoidDiscontinuity |
This attribute can be set to "TRUE" to have the scenery editor try and ensure that the models used match up correctly at the corners of the vector path. If set to "FALSE" then the model may overrun the length of the vectors. | Bool | Yes |
castShadow |
If this attribute is set to "TRUE" the models used will cast a shadow, and if set to "FALSE" they won't. | Bool | No |
<WasmModule>