# Scenery XML Properties<no value>
The Scenery XML file is generated by the [Scenery Editor](../../../devmode/editors/scenery-editor/the-scenery-editor/) and defines all the scenery objects, rectangles, polygons, etc... that make up the scenery within a package. The `<scene_filename>.xml` file should be formatted as follows:

``` xml
<?xml version="1.0" encoding="UTF-8"?>
<FSData version="9.0">
    <SceneryObject [attributes]>
        
    </SceneryObject>
    
</FSData>
```

 

{{< callout context="caution" title="IMPORTANT!" icon="outline/alert-triangle" >}}

The file details given here are meant purely for reference purposes and we do not recommend that you manually create these files but instead always use [The Scenery Editor](../../../devmode/editors/scenery-editor/the-scenery-editor/).

{{< /callout >}}

 

 

### &lt;FSData&gt;

The `<FSData>` element is the top level container which contains the different scenery object sub-elements (and can also contain the [Airport XML](../airports-and-facilities/airport-xml-properties/) element). It has the following possible attributes:

 

<table><thead><tr class="header"><th>Attribute</th><th>Description</th><th>Type</th><th>Required</th></tr></thead><tbody><tr class="odd"><td><p><code>version</code></p></td><td><p>The current version of the XML file.</p><p><strong>IMPORTANT!</strong> The <code>FSData</code> container element <strong>can only be version "9.0"</strong> and anything else will fail to parse.</p></td><td>String</td><td>Yes</td></tr><tr class="even"><td><p><code>timestamp</code></p></td><td>The file timestamp.</td><td>String</td><td>No</td></tr><tr class="odd"><td><p><code>patch</code></p></td><td>The patch number for the file.</td><td>String</td><td>No</td></tr><tr class="even"><td><p><code>source</code></p></td><td>The original source of the file.</td><td>String</td><td>No</td></tr></tbody></table>

 

This element can have all of the following sub-elements:

`<Airport><Location><Marker /><Waypoint><Boundary><Vor><Ndb><SceneryObject><ExtrusionBridge><ModelData><GLTFData><GeoPol><ExclusionRectangle /><Reward><TimeZone /><Polygon><Rectangle><Group><DeleteNavigation><LandmarkLocation><AiracCycle /><ProjectedMesh><Tree /><VectorPlacement>`

 

 

### &lt;Location&gt;

This is a sub-element of `<FSData>` and was used to define an airport location. However this element is no longer used by the simulation and should never be included in your scenery XML.

 

 

### &lt;Marker /&gt;

This is a sub-element of `<FSData>` and is used to define a navigation data marker.

{{< callout context="note" title="NOTE" icon="outline/bulb" >}}

Editing Waypoint data may prevent the simulation performing further automatic updates to the navigation data for the airport. Please see the following section for more information: [Note On Navigation Data](../airports-and-facilities/airports-and-facilities/#note-on-navigation-data)

{{< /callout >}}

It is a self-closing element with the following attributes:

 

<table><thead><tr class="header"><th>Attribute</th><th>Description</th><th>Type</th><th>Required</th></tr></thead><tbody><tr class="odd"><td><code>lat</code></td><td>Latitude of the airport reference point, in degrees between -90.0° and 90.0°.</td><td><p>Float</p></td><td>Yes</td></tr><tr class="even"><td><code>lon</code></td><td>Longitude of the airport reference point, in degrees between -180.0° and 180.0°.</td><td>Float</td><td>Yes</td></tr><tr class="odd"><td><code>alt</code></td><td>Altitude of the airport reference point, in meters. You may add the "F" suffix to convert the value to feet, for example: "13.0F".</td><td><p>Float</p></td><td>Yes</td></tr><tr class="even"><td><code>altType</code></td><td>This is used to determine the referential for the <code>alt</code> field.</td><td><p>Enum:</p><ol><li>GEOID</li><li>ELLIPSOID</li></ol></td><td>No</td></tr><tr class="odd"><td><code>type</code></td><td>The marker type.</td><td><p>String:</p><p>"BACKCOURSE" / "BC"</p><p>"I" / "INNER"</p><p>"M" / "MIDDLE" </p><p>"O" / "OUTER"</p></td><td>No</td></tr><tr class="even"><td><code>heading</code></td><td>The marker heading, in degrees.</td><td>Float</td><td>No</td></tr><tr class="odd"><td><code>ident</code></td><td></td><td>String</td><td>No</td></tr><tr class="even"><td><code>region</code></td><td>The <a href="https://www.avcodes.co.uk/icaonat.asp">ICAO region/country</a> code for the marker.</td><td>String</td><td>No</td></tr><tr class="odd"><td><code>name</code></td><td>The name of the marker.</td><td>String</td><td>No</td></tr></tbody></table>

 

 

### &lt;Boundary&gt;

This is a sub-element of `<FSData>` and is used to define a navigation data boundary. It can have the following sub-elements:

1.  `<Com />`
2.  `<Origin />`
3.  `<Circle />`
4.  `<BoundaryStart />`
5.  `<Line />`
6.  `<Arc />`

 

In general you will have either:

-   An *origin* and a *circle* to define a circular boundary. For example:

    ``` xml
    <Boundary type="PROHIBITED" name="HYDERABAD" region="VO">
        <Origin lat="17.866666666666667" lon="80.86666666666666" />
        <Circle index="0" radius="1N" altitudeMinimum="0F" minimumAltitudeType="MEAN_SEA_LEVEL" altitudeMaximum="5000F" maximumAltitudeType="MEAN_SEA_LEVEL" />
    </Boundary>
    ```

 

-   A *boundary start* with 2 or more *lines* to define a polygonal boundary. For example:

    ``` xml
    <Boundary type="PROHIBITED" name="KAIGA" region="VO">
        <BoundaryStart lat="14.8" lon="74.38333333333334" altitudeMinimum="0F" minimumAltitudeType="MEAN_SEA_LEVEL" altitudeMaximum="5000F" maximumAltitudeType="MEAN_SEA_LEVEL" />
        <Line lat="14.9" lon="74.38333333333334" />
        <Line lat="14.9" lon="74.48333333333333" />
        <Line lat="14.8" lon="74.48333333333333" />
        <Line lat="14.8" lon="74.38333333333334" />
    </Boundary>
    ```

 

-   A *boundary start*, an *origin*, an *arc*, and a *line* to define a curved boundary. For example:

    ``` xml
      <Boundary type="PROHIBITED" name="ARVANKADU" region="VO">
        <BoundaryStart lat="11.376019444444445" lon="76.78164722222222" altitudeMinimum="0F" minimumAltitudeType="MEAN_SEA_LEVEL" altitudeMaximum="17500F" maximumAltitudeType="MEAN_SEA_LEVEL" />
        <Origin lat="11.365555555555556" lon="76.76327777777777" />
        <Arc index="0" type="CLOCKWISE" lat="11.344944444444446" lon="76.76696111111112" />
        <Line lat="11.28311388888889" lon="76.77800555555555" />
        <Origin lat="11.365555555555556" lon="76.76327777777777" />
        <Arc index="1" type="CLOCKWISE" lat="11.407402777777778" lon="76.83675833333332" />
        <Line lat="11.376019444444445" lon="76.78164722222222" />
      </Boundary>
    ```

 

The element also has the following attributes:

 

<table><thead><tr class="header"><th>Attribute</th><th>Description</th><th>Type</th><th>Required</th></tr></thead><tbody><tr class="odd"><td><code>type</code></td><td>The boundary type.</td><td><p>String:</p><p>"NONE"  

"CENTER"  

"CLASS_A"  

"CLASS_B"  

"CLASS_C"  

"CLASS_D"  

"CLASS_E"  

"CLASS_F"  

"CLASS_G"  

"TOWER"  

"CLEARANCE"  

"GROUND"  

"DEPARTURE"  

"APPROACH"  

"MOA"  

"RESTRICTED"  

"PROHIBITED"  

"WARNING"  

"ALERT"  

"DANGER"  

"NATIONAL_PARK"  

"MODE_C"  

"RADAR"  

"TRAINING"  

"CLASS_UNDEFINED"</p></td><td>No</td></tr><tr class="even"><td><code>name</code></td><td>The boundary name.</td><td>String</td><td>No</td></tr><tr class="odd"><td><code>center</code></td><td></td><td>String</td><td>No</td></tr><tr class="even"><td><code>ControlledType</code></td><td></td><td>String</td><td>No</td></tr><tr class="odd"><td><code>region</code></td><td>The <a href="https://www.avcodes.co.uk/icaonat.asp">ICAO region/country</a> code for the boundary (2 characters).</td><td>String</td><td>No</td></tr></tbody></table>

 

 

#### &lt;Origin /&gt;

This is a sub-element of `<Boundary>` and is used to define the origin for a circular boundary or an arc boundary (and so requires either the `<Circle />` or `<Arc />` element to be used along with it). This is a self-closing element with the following attributes:

 

{{< table-wrapper >}}

| Attribute | Description                                                                                                                                                          | Type  | Required |
|-----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|:--------:|
| `lat`     | Latitude of the boundary center, in degrees between -90.0° and 90.0°.                                                                                                | Float |    Yes   |
| `lon`     | Longitude of the boundary center, in degrees between -180.0° and 180.0°.                                                                                             | Float |    Yes   |
| `spline`  | If this attribute is set to "TRUE", then the origin being defined will be considered a point on a spline, creating a "smooth" curved corner between the other lines. | Bool  |    No    |

{{< /table-wrapper >}}


 

 

#### &lt;Circle /&gt;

This is a sub-element of `<Boundary>` and is used to define the circular radius of the boundary, and requires the `<Origin />` element to be included with it. This is a self-closing element with the following attributes:

 

<table><thead><tr class="header"><th>Attribute</th><th>Description</th><th>Type</th><th>Required</th></tr></thead><tbody><tr class="odd"><td><code>index</code></td><td></td><td>Integer</td><td>No</td></tr><tr class="even"><td><code>radius</code></td><td>The radius of the boundary circle, in <a href="#" class="glossterm">ft</a>.</td><td>Float</td><td>No</td></tr><tr class="odd"><td><code>altitudeMinimum</code></td><td>The minimum altitude, in <a href="#" class="glossterm">ft</a>. This is given as a string and should be formatted with a trailing "F", for example "1000F"</td><td>String</td><td>No</td></tr><tr class="even"><td><code>minimumAltitudeType</code></td><td>This is used to determine base reference for the <code>altitudeMinimum</code> field.</td><td><p>Enum:</p><ol><li>ABOVE_GROUND_LEVEL / AGL</li><li>MEAN_SEA_LEVEL / MSL</li><li>UNKNOWN</li><li>UNLIMITED</li></ol></td><td>No</td></tr><tr class="odd"><td><code>altitudeMaximum</code></td><td>The minimum altitude, in <a href="#" class="glossterm">ft</a>. This is given as a string and should be formatted with a trailing "F", for example "3000F"</td><td>String</td><td>No</td></tr><tr class="even"><td><code>maximumAltitudeType</code></td><td>This is used to determine base reference for the <code>altitudeMaximum</code> field.</td><td><p>Enum:</p><ol><li>ABOVE_GROUND_LEVEL / AGL</li><li>MEAN_SEA_LEVEL / MSL</li><li>UNKNOWN</li><li>UNLIMITED</li></ol></td><td>No</td></tr></tbody></table>

 

 

#### &lt;BoundaryStart /&gt;

This is a sub-element of `<Boundary>` and is used to define the start point of the boundary shape. The element should also be accompanied by at least two `<Line />` elements to create a complete shape, and can have additional `<Origin />` and `<Arc />` elements if any of the sides of the boundary should be curved.

 

This is a self-closing element with the following attributes:

 

<table><thead><tr class="header"><th>Attribute</th><th>Description</th><th>Type</th><th>Required</th></tr></thead><tbody><tr class="odd"><td><code>lat</code></td><td>Latitude of the boundary start, in degrees between -90.0° and 90.0°.</td><td><p>Float</p></td><td>No</td></tr><tr class="even"><td><code>lon</code></td><td>Longitude of the boundary start, in degrees between -180.0° and 180.0°.</td><td>Float</td><td>No</td></tr><tr class="odd"><td><code>altitudeMinimum</code></td><td>The minimum altitude, in <a href="#" class="glossterm">ft</a>. This is given as a string and should be formatted with a trailing "F", for example "1000F"</td><td>String</td><td>No</td></tr><tr class="even"><td><code>minimumAltitudeType</code></td><td>This is used to determine base reference for the <code>altitudeMinimum</code> field.</td><td><p>Enum:</p><ol><li>ABOVE_GROUND_LEVEL / AGL</li><li>MEAN_SEA_LEVEL / MSL</li><li>UNKNOWN</li><li>UNLIMITED</li></ol></td><td>No</td></tr><tr class="odd"><td><code>altitudeMaximum</code></td><td>The minimum altitude, in <a href="#" class="glossterm">ft</a>. This is given as a string and should be formatted with a trailing "F", for example "3000F"</td><td>String</td><td>No</td></tr><tr class="even"><td><code>maximumAltitudeType</code></td><td>This is used to determine base reference for the <code>altitudeMaximum</code> field.</td><td><p>Enum:</p><ol><li>ABOVE_GROUND_LEVEL / AGL</li><li>MEAN_SEA_LEVEL / MSL</li><li>UNKNOWN</li><li>UNLIMITED</li></ol></td><td>No</td></tr></tbody></table>

 

 

#### &lt;Line /&gt;

This is a sub-element of `<Boundary>` and is used to define the edges of the boundary shape. This element requires a `<BoundaryStart />` to be included in the XML and at least one other `<Line />` element. Id only line elements are used, the edges of the boundary will be calculated as straight lines between each of the line positions, however you may also include `<Origin />` and `<Arc />` elements to create a curved line.

 

This is a self-closing element with the following attributes:

 

{{< table-wrapper >}}

| Attribute | Description                                                                                                                                                     | Type  | Required |
|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|:--------:|
| `lat`     | Latitude of the boundary center, in degrees between -90.0° and 90.0°.                                                                                           | Float |    No    |
| `lon`     | Longitude of the boundary center, in degrees between -180.0° and 180.0°.                                                                                        | Float |    No    |
| `spline`  | If this attribute is set to "TRUE", then the line being defined will be considered part of a spline, creating a "smooth" curved corner between the other lines. | Bool  |    No    |

{{< /table-wrapper >}}


 

 

#### &lt;Arc /&gt;

This is a sub-element of `<Boundary>` and is used to define the communication frequency for the boundary. This is a self-closing element with the following attributes:

 

<table><thead><tr class="header"><th>Attribute</th><th>Description</th><th>Type</th><th>Required</th></tr></thead><tbody><tr class="odd"><td><code>index</code></td><td></td><td>Integer</td><td>No</td></tr><tr class="even"><td><code>type</code></td><td>The type attribute defines the direction of the arc between the start or line element and the next line element.</td><td><p>Enum:</p><ol><li>CW / CLOCKWISE</li><li>CC / CCW / COUNTERCLOCKWISE</li></ol></td><td>No</td></tr><tr class="odd"><td><code>lat</code></td><td>Latitude of the boundary center, in degrees between -90.0° and 90.0°.</td><td><p>Float</p></td><td>No</td></tr><tr class="even"><td><code>lon</code></td><td>Longitude of the boundary center, in degrees between -180.0° and 180.0°.</td><td>Float</td><td>No</td></tr></tbody></table>

 

 

### &lt;SceneryObject&gt;

This element is used in multiple different places to add a scenery object to the simulation. This element can contain the following sub-elements:

`<BiasXYZ /><NoAutogenSuppresion /><NoCrash /><NoFog /><NoShadow /><NoZWrite /><NoZTest /><HideOnTIN /><LowResAltitude /><NoSnow /><NoDecal /><SnapToBuilding /><UseInstancing /><Beacon /><Effect /><GenericBuilding><LibraryObject /><VisualEffectObject /><Trigger><Windsock><SimObject /><WorldScript /><CarParking><SimPropContainer /><Decal />`

{{< callout context="note" title="NOTE" icon="outline/bulb" >}}

The `<AttachedObject>` element should always be defined *last*.

{{< /callout >}}

 

This element is used in the following places:

1.  `<Tower>`
2.  `<Jetway>`
3.  `<ProjectedMesh>`
4.  `<VDGS>`

  

This element can have the following attributes:

 

<table><thead><tr class="header"><th>Attribute</th><th>Description</th><th>Type</th><th>Required</th></tr></thead><tbody><tr class="odd"><td><code>instanceId</code></td><td><a href="../Shared_XML_Properties/#" class="glossterm">GUID</a> used to identify this instance of the element. You can find more information on GUID's here: <a href="../../../1_Introduction/Using_The_SDK/#GUIDs">GUIDs</a></td><td>String</td><td>Yes</td></tr><tr class="even"><td><code>lat</code></td><td>Latitude of the center point of the object, in degrees between -90.0° and 90.0°.</td><td>Float</td><td>Yes</td></tr><tr class="odd"><td><code>lon</code></td><td>Longitude of the center point of the object, in degrees between -180.0° and 180.0°.</td><td>Float</td><td>Yes</td></tr><tr class="even"><td><code>alt</code></td><td>Altitude of the center point of the object, in meters. You may add the "F" suffix to convert the value to feet, for example: "13.0F".</td><td>Float</td><td>Yes</td></tr><tr class="odd"><td><code>snapToGround</code></td><td>Whether to snap the object to the ground (TRUE) or not (FALSE).</td><td>Bool</td><td>No</td></tr><tr class="even"><td><code>snapToNormal</code></td><td>Whether to snap the object to the terrain normal (TRUE) or not (FALSE).</td><td>Bool</td><td>No</td></tr><tr class="odd"><td><code>altitudeIsAgl</code></td><td>Indicate whether altitude is <a href="../Shared_XML_Properties/#" class="glossterm">AGL</a> (TRUE) or <a href="../Shared_XML_Properties/#" class="glossterm">MSL</a> (FALSE)</td><td>Bool</td><td>Yes</td></tr><tr class="even"><td><code>pitch</code></td><td>The pitch of the object, from 0.0° to 360.0°.</td><td>Float</td><td>Yes</td></tr><tr class="odd"><td><code>bank</code></td><td>The bank of the object, from 0.0° to 360.0°.</td><td>Float</td><td>Yes</td></tr><tr class="even"><td><code>heading</code></td><td>The facing heading of the object, from 0.0° to 360.0°.</td><td>Float</td><td>Yes</td></tr><tr class="odd"><td><code>imageComplexity</code></td><td><p>Minimum image complexity setting in the sim for the objects to appear.</p><p> <strong>IMPORTANT!</strong> This element is DEPRECATED in Microsoft Flight Simulator 2024. It should <strong>not</strong> be set to anything other than "VERY_SPARSE" and is only listed here for legacy context.</p></td><td><p>Enum:</p><ol><li>VERY_SPARSE</li><li>SPARSE</li><li>NORMAL</li><li>DENSE</li><li>VERY_DENSE</li><li>EXTREMELY_DENSE</li></ol></td><td>Yes</td></tr></tbody></table>

 

 

#### &lt;NoAutogenSuppresion /&gt;

This element has no attributes, and is a self-closing sub-element of `<SceneryObject>` used to disable the auto-generation suppression system.

{{< callout context="note" title="NOTE" icon="outline/bulb" >}}

This element is no longer used in Microsoft Flight Simulator 2024

{{< /callout >}}

 

 

#### &lt;NoCrash /&gt;

This element has no attributes, and is a self-closing sub-element of `<SceneryObject>` used to tell the simulation that there should be no crash detection between the object and the user aircraft.

{{< callout context="note" title="NOTE" icon="outline/bulb" >}}

This element is no longer used in Microsoft Flight Simulator 2024

{{< /callout >}}

 

 

#### &lt;NoFog /&gt;

This element has no attributes, and is a self-closing sub-element of `<SceneryObject>` used to disable environmental fog around the object.

{{< callout context="note" title="NOTE" icon="outline/bulb" >}}

This element is no longer used in Microsoft Flight Simulator 2024

{{< /callout >}}

 

 

#### &lt;NoShadow /&gt;

This element is a self-closing sub-element of `<SceneryObject>` and requires no attributes. The element is used to indicate that the scenery object should not cast any shadows. You can find an example of this element being used [here](scenery-object-example/).

 

 

#### &lt;NoZWrite /&gt;

This element has no attributes, and is a self-closing sub-element of `<SceneryObject>` used to disable Z-writing for the object.

{{< callout context="note" title="NOTE" icon="outline/bulb" >}}

This element is no longer used in Microsoft Flight Simulator 2024

{{< /callout >}}

 

 

 

#### &lt;NoZTest /&gt;

This element has no attributes, and is a self-closing sub-element of `<SceneryObject>` used to disable Z-testing for the object.

{{< callout context="note" title="NOTE" icon="outline/bulb" >}}

This element is no longer used in Microsoft Flight Simulator 2024

{{< /callout >}}

 

 

#### &lt;HideOnTIN /&gt;

This element is a self-closing sub-element of `<SceneryObject>` and requires no attributes. The element is used hide the associated scenery object element unless the {{< glossterm >}}tin{{< /glossterm >}} data is unavailable, for example when the user is offline, at which point it will be visible. You can find an example of this element being used [here](scenery-object-example/).

 

 

#### &lt;LowResAltitude /&gt;

The element is a self-closing sub-element of `<SceneryObject>` and requires no attributes. This element is used to force the simulation to use a lower resolution altitude calculation when calculating the placement of the object in relation to the camera. In general this element only needs to be included when the object is placed on a slope and you can see it "bounce" up or down in altitude as the camera gets closer/farther from it, and adding this element should stop this changing visual altitude.

 

 

#### &lt;NoSnow /&gt;

This element is a self-closing sub-element of `<SceneryObject>` and requires no attributes. The element is used to indicate that the scenery object should not be affected by snow, ie: when snow is present, it will not be rendered on the object. You can find an example of this element being used [here](scenery-object-example/).

 

 

#### &lt;NoDecal /&gt;

This element is a self-closing sub-element of `<SceneryObject>` and requires no attributes. The element is used to indicate to the simulation that no decals should be drawn on the object. Note that if this is included then you should not be including the `<Decal />` element.

 

 

#### &lt;SnapToBuilding /&gt;

This element is a self-closing sub-element of `<SceneryObject>` and requires no attributes. The element is used to indicate to the simulation that the scenery object should snap to the height of any procedural building that is at the position where it has been placed.

 

 

#### &lt;UseInstancing /&gt;

This element is a self-closing sub-element of `<SceneryObject>` and requires no attributes. This element can be used to enable *object instancing* for the scenery object being placed. This means that each time the object is placed in the scene, the simulation will be adding an "instance", and all instances will be batched and drawn in a single draw call. For an object to be instanced, it cannot be animated nor have multiple nodes, although it can use fast lights.

 

 

#### &lt;Beacon /&gt;

This element is a self-closing sub-element of `<SceneryObject>` and `<AttachedObject>`, and is used to add a beacon to the scene. Beacons can be added as stand-alone objects, but are usually added as objects attached to control towers (see `<Tower>`). This element has the following attributes:

 

<table><thead><tr class="header"><th>Attribute</th><th>Description</th><th>Type</th><th>Required</th></tr></thead><tbody><tr class="odd"><td><code>type</code></td><td>The type of beacon being used.</td><td><p>Enum:</p><ol><li>CANADIAN</li><li>MILITARY</li><li>CIVILIAN</li></ol></td><td>Yes</td></tr><tr class="even"><td><code>baseType</code></td><td>Latitude of the center point of the object, in degrees between -90.0° and 90.0°.</td><td><p>Enum:</p><ol><li>AIRPORT</li><li>HELIPORT</li><li>SEA_BASE</li></ol></td><td>Yes</td></tr></tbody></table>

 

Note that this element may also be used in non-airport [Scenery Objects](scenery-objects/).

 

 

#### &lt;Effect /&gt;

This element is a self-closing sub-element of `<SceneryObject>` and `<AttachedObject>`, and is used to add a scenery effect to the scene. This element has the following attributes:

 

{{< table-wrapper >}}

| Attribute      | Description                                   | Type   | Required |
|----------------|-----------------------------------------------|--------|:--------:|
| `effectName`   | The name of the effect (up to 80 characters). | String |    Yes   |
| `effectParams` | Parameters for the effect.                    | String |    No    |

{{< /table-wrapper >}}


 

 

#### &lt;GenericBuilding&gt;

This element is a sub-element of `<SceneryObject>` and is used to add a generic building to the scene.

{{< callout context="note" title="NOTE" icon="outline/bulb" >}}

This element is no longer used in Microsoft Flight Simulator 2024

{{< /callout >}}

This element has the following sub-elements:

1.  
2.  
3.  

 

This element has the following attributes:

 

{{< table-wrapper >}}

| Attribute       | Description                                                                              | Type    | Required |
|-----------------|------------------------------------------------------------------------------------------|---------|:--------:|
| `scale`         | The building scale                                                                       | Float   |    No    |
| `windowTexture` | An integer that identifies which base texture to use for the windows.                    | Integer |    No    |
| `bottomTexture` | An integer that identifies which base texture to use for the lower part of the building. | Integer |    No    |
| `topTexture`    | An integer that identifies which base texture to use for the upper part of the building. | Integer |    No    |
| `roofTexture`   | An integer that identifies which base texture to use for the roof.                       | Integer |    No    |

{{< /table-wrapper >}}


 

 

##### &lt;RectangularBuilding /&gt;

This is a sub-element of `<GenericBuilding>` and is used to define a rectangular generic building. It has no sub-elements, and the following attributes:

`roofTypesizeXsizeZsizeBottomYtextureIndexBottomXtextureIndexBottomZsizeWindowYtextureIndexWindowXtextureIndexWindowYtextureIndexWindowZsizeTopYtextureIndexTopXtextureIndexTopZtextureIndexRoofXtextureIndexRoofZsizeRoofYtextureIndexRoofYgableTexturetextureIndexGableYtextureIndexGableZfaceTexturetextureIndexFaceXtextureIndexFaceY`

 

 

##### &lt;PyramidalBuilding /&gt;

This is a sub-element of `<GenericBuilding>` and is used to define a pyramidal generic building. It has no sub-elements, and the following attributes:

`sizeXsizeZsizeTopXsizeTopZsizeBottomYtextureIndexBottomXtextureIndexBottomZsizeWindowYtextureIndexWindowXtextureIndexWindowYtextureIndexWindowZsizeTopYtextureIndexTopXtextureIndexTopZtextureIndexRoofXtextureIndexRoofZ`

 

 

##### &lt;MultiSidedBuilding /&gt;

This is a sub-element of `<GenericBuilding>` and is used to define a multi-sided generic building. It has no sub-elements, and the following attributes:

`roofTypebuildingSidessmoothingsizeXsizeZsizeBottomYtextureIndexBottomXsizeWindowYtextureIndexWindowXtextureIndexWindowYsizeTopYtextureIndexTopXsizeRoofYtextureIndexRoofXtextureIndexRoofZtextureIndexRoofZ`

 

 

#### &lt;LibraryObject /&gt;

This element is a self-closing sub-element of `<SceneryObject>` used to add a library object to the scene. Note that this is a self-closing element and has the following attributes:

 

{{< table-wrapper >}}

| Attribute | Description                                                                                                                                                                                                | Type   | Required |
|-----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------|:--------:|
| `name`    | The [GUID](../shared-xml-properties/#) of the object to be modeled. You can find more information on GUID's here: [GUIDs](../../../introduction/using-the-sdk/#GUIDs) | String |    Yes   |
| `scale`   | The scale to be applied to the object (1.0 is no scaling, 0.5 would be half and 2.0 would be double).                                                                                                      | Float  |    Yes   |

{{< /table-wrapper >}}


 

Library objects are those that are included with the *base* installation of Microsoft Flight Simulator 2024 and are generally those that are shown when opening the [Objects](../../../devmode/editors/scenery-editor/menus/the-view-menu/#objects) window in [The Scenery Editor](../../../devmode/editors/scenery-editor/the-scenery-editor/). To get the GUID for these library objects, add the object to a scene, then check the [Properties](../../../devmode/editors/scenery-editor/menus/the-view-menu/#properties) window, where the GUID will be listed.

 

 

#### &lt;VisualEffectObject /&gt;

This element is a self-closing sub-element of `<SceneryObject>` and `<AttachedObject>`, and is used to add a visual effect to the scene. Note that this is a self-closing element and has the following attributes:

 

<table><thead><tr class="header"><th>Attribute</th><th>Description</th><th>Type</th><th>Required</th></tr></thead><tbody><tr class="odd"><td><code>name</code></td><td><p>The <a href="../Shared_XML_Properties/#" class="glossterm">GUID</a> for the VFX to be used. This attribute should only be used if you are <em>not</em> supplying the <code>effectname</code> attribute. This should be enclosed in <code>{}</code>, for example:</p><pre class="language-xml"><code>name=&quot;{A04B772A-6BBF-4103-B263-D479BCCE71F5}&quot;</code></pre><p>You can find more information on GUID's here: <a href="../../../1_Introduction/Using_The_SDK/#GUIDs">GUIDs</a></p></td><td>String</td><td>Yes</td></tr><tr class="even"><td><code>effectname</code></td><td><p>The name or package/name of the VFX to use. The name is the name of the effect file without the file extension, or you can supply the package name and the effect file name in case the file name alone conflicts with another file. For example:</p><pre class="language-xml"><code>effectName=&quot;Smoke_SOS&quot;
effectName=&quot;Base/Smoke_SOS&quot;</code></pre><p>This attribute should only be used if you are <em>not</em> supplying the <code>name</code> attribute.</p></td><td><p>String</p></td><td>Yes</td></tr><tr class="odd"><td><code>scale</code></td><td>The scale to be applied to the effect (1.0 is no scaling, 0.5 would be half and 2.0 would be double).</td><td>Float</td><td>Yes</td></tr><tr class="even"><td><code>spawnlifetime</code></td><td>When specified, this is used to limit how long the particles from the effect will spawn. The value is given in seconds.</td><td>Float</td><td>No</td></tr></tbody></table>

 

VFX objects are those that are included with the *base* installation of Microsoft Flight Simulator 2024 or that are created as part of a VFX package. To get the GUID or the name for these VFX objects, you can check the [Template/Instance Debugger](../../../devmode/editors/vfx-editor/menus/#h4) window, as explained in the section on [Using Effects In The World](../../../devmode/editors/vfx-editor/the-visual-effects-editor/#h2). You can find an example of using these objects in a scene here: [Effects Objects](scenery-object-example/#h).

 

 

#### &lt;Trigger&gt;

This element is a sub-element of `<SceneryObject>` used to add a trigger to the scene. Triggers are used to define regions in the world that will cause an event when the user's aircraft enters that region. Triggers can presently be used to specify refueling stations and weather areas (like thermals or ridge lifts). This element may contain `<Fuel />`, `<Vertex />` and `<TriggerWeatherData>` elements, and these elements *must be listed in that order*.

{{< callout context="caution" title="IMPORTANT!" icon="outline/alert-triangle" >}}

This and the listed sub-element `<TriggerWeatherData>` are deprecated in Microsoft Flight Simulator 2024. They should **not** be used and are only listed here for legacy context.

{{< /callout >}}

This element can have the following attributes:

 

<table><thead><tr class="header"><th>Attribute</th><th>Description</th><th>Type</th><th>Required</th></tr></thead><tbody><tr class="odd"><td><code>type</code></td><td>The type of trigger.</td><td><p>Enum:</p><ol><li>REFUEL_REPAIR</li><li>WEATHER</li></ol></td><td>Yes</td></tr><tr class="even"><td><code>triggerHeight</code></td><td>Height of trigger in meters (must be positive).</td><td>Float</td><td>Yes</td></tr></tbody></table>

 

 

##### &lt;TriggerWeatherData&gt;

This is a sub-element of `<Trigger>` and is used to define a weather effect trigger. It has no sub-elements, and the following attributes:

`typeheadingscalar`

 

 

#### &lt;Windsock&gt;

This element is a self-closing sub-element of `<SceneryObject>` used to add a windsock to the scene. This element may contain `<PoleColor />` and `<SockColor />` sub-elements, which must be defined in that order if they are used (they are *optional*, the default colors are gray and orange respectively).

 

This element can have the following attributes:

 

{{< table-wrapper >}}

| Attribute        | Description                                                                                                    | Type   | Required |
|------------------|----------------------------------------------------------------------------------------------------------------|--------|:--------:|
| `poleHeight`     | Height of pole in meters.                                                                                      | Float  |    No    |
| `sockLength`     | Length of sock in meters.                                                                                      | Float  |    No    |
| `lighted`        | Indicating whether the windsock is lit (TRUE) or not (FALSE).                                                  | Bool   |    No    |
| `containerTitle` | The container title of the SimObject to use (for the generic built-in windsock, use "Windsock" for the title). | String |    Yes   |
| `containerPath`  | The container file path. **DEPRECATED** (do not use)                                                           | String |    No    |

{{< /table-wrapper >}}


 

 

##### &lt;PoleColor /&gt;

##### &lt;SockColor /&gt;

These are sub-elements of and are used to define the colour to use for the windsok pole and cloth sock, respectively. They both have the same attributes:

 

{{< table-wrapper >}}

| 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   |

{{< /table-wrapper >}}


 

 

#### &lt;SimObject /&gt;

This element is a self-closing sub-element of `<SceneryObject>` and `<AttachedObject>`, and is used to to add a [simulated object](../../../devmode/editors/scenery-editor/objects/simobj-objects/) to the scene. Note that this is a self-closing element and has the following attributes:

 

<table><thead><tr class="header"><th>Attribute</th><th>Description</th><th>Type</th><th>Required</th></tr></thead><tbody><tr class="odd"><td><code>containerTitle</code></td><td>The container title of the SimObject to use.</td><td>String</td><td>Yes</td></tr><tr class="even"><td><code>liveryName</code></td><td>The name of the livery that the SimObject should use.</td><td>String</td><td>No</td></tr><tr class="odd"><td><code>containerPath</code></td><td>The container file path.</td><td>String</td><td>No</td></tr><tr class="even"><td><code>scale</code></td><td><p>The scale to be applied to the object (1.0 is no scaling, 0.5 would be half and 2.0 would be double).</p><p><strong>IMPORTANT!</strong> When using this parameter to scale <strong>JetWay</strong> sim objects, <strong>the scaling is only done on the mesh and not on the bones</strong> so that, even if the object is visually bigger, in the simulation the contact points will be the same as before. Therefor, you generally want to avoid using the scale attribute for JetWays, and rather scale the object in your 3D software before exporting it.</p></td><td>Float</td><td>No</td></tr></tbody></table>

 

 

#### &lt;CarParking&gt;

This element is a sub-element of `<SceneryObject>` used to define a car park area within a scene. It requires 3 or more `<Vertex />` sub-elements to define the area, and has the following attributes:

 

{{< table-wrapper >}}

| Attribute     | Description                                                                                                                                                                                    | Type  | Required |
|---------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|:--------:|
| `isRectangle` | This attribute is only used by the Scenery Editor and when set to "TRUE" the carparking object has different edition options. When set to "FALSE" it will be treated as a polygon-type object. | Bool  |    No    |
| `carsHeading` | The heading for the cars in degrees (0-360).                                                                                                                                                   | Float |    No    |

{{< /table-wrapper >}}


 

 

#### &lt;SimPropContainer /&gt;

This element is a self-closing sub-element of `<SceneryObject>` used to add a [SimPropContainer object](../../../devmode/editors/scenery-editor/objects/simpropcontainer-objects/) to the scene. Note that this is a self-closing element and has the following attributes:

 

{{< table-wrapper >}}

| Attribute | Description                                                                                                                                                                                                   | Type   | Required |
|-----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------|:--------:|
| `guid`    | The [GUID](../shared-xml-properties/#) of the SimPropContainer to use. You can find more information on GUID's here: [GUIDs](../../../introduction/using-the-sdk/#GUIDs) | String |    Yes   |
| `scale`   | The scale to be applied to the object (1.0 is no scaling, 0.5 would be half and 2.0 would be double).                                                                                                         | Float  |    No    |

{{< /table-wrapper >}}


 

 

#### &lt;Decal /&gt;

This element is a self-closing sub-element of `<SceneryObject>` used to define a [decal object](../../../devmode/editors/scenery-editor/objects/decal-objects/) that to be used as a decorative element within a scene. Note that if this is included then you should not be including the `<NoDecal />` element. This element has the following attributes:

 

Attribute

Description

Type

Required

`materialGuid`

{{< glossterm >}}guid{{< /glossterm >}} used to identify the material that is used by this element. You can find more information on GUID's here: [GUIDs](../../../introduction/using-the-sdk/#GUIDs)

String

Yes

`sizeX`

Sets the size of the decal bounding box along the X-axis.

Float

`sizeY`

Sets the size of the decal bounding box along the Y-axis.

Float

`sizeZ`

Sets the size of the decal bounding box along the Z-axis.

Float

`opacity`

Sets the opacity (alpha) of the decal. Note that normally you would have a value between 0 and 1 here, but you can use higher values. Values greater than 1 will raise the opacity threshold and gradually force the alpha of ALL pixels towards 1, so transparent and semi-transparent areas will become more opaque the higher the value.

Float

`fadeAngle`

This value can be used to set the fade out range of the decal based on the angle between the decal's backward direction and the vertex normal of the receiving surface.

Float

`fadeDepth`

This value is used to control how quickly the decal will fade it's opacity relative to the the center plane of the bounding box. A value of 1 will show the decal almost from the moment the bounding box intersects the opposing plane, while a value of 0 will fade the decal in/out as the bounding box moves through the opposing plane.

Float

`channelFlags`

This value defines what the decal is being applied to.

Integer

1.  **4**: Nothing (it will appear in the scene but not interact with anything)
2.  **5**: Will be applied to Scenery
3.  **6**: Will be applied to the Ground
4.  **7**: Will be applied to both Scenery and Ground

`priority`

With this value you can set the priority of the decal. This is important if you have multiple decal objects that are overlapping, as it permits you to set the render order based on the priority.

Integer

`overrideNormal`

When this is "true", the scenery/ground normal map will be overridden by the normal map for the decal object.

Bool

 

You can find an example of the generated XML for this object here: [Decal Objects](scenery-object-example/#decal)

 

 

#### &lt;AttachedObject&gt;

This element is a sub-element of `<SceneryObject>` used to attach another object to a scenery object.

{{< callout context="caution" title="IMPORTANT!" icon="outline/alert-triangle" >}}

This element must **always be the last element defined** in the scenery object XML.

{{< /callout >}}

 

This element is allowed to contain the following, which - if included as some are optional - must be added in the exact order given:

`<RandomAttach /><BiasXYZ /><Beacon /><Effect /><LibraryObject /><VisualEffectObject /><SimObject /><WorldScript />`

 

Note that attached objects are subject to any rotations or displacements applied to the *base* object, or any animated parts. Nesting of attached objects is supported but is not encouraged (for example, a library object can be placed that has a control tower attached to it and the attached control tower has a beacon attached to it).

 

This element can have the following attributes:

{{< table-wrapper >}}

| Attribute         | Description                                                                                                                                                                                                              | Type   | Required |
|-------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------|:--------:|
| `attachpointName` | Name of the attach point in the model for the object.                                                                                                                                                                    | String |    No    |
| `instanceId`      | [GUID](../shared-xml-properties/#) used to identify this instance of the element. You can find more information on GUID's here: [GUIDs](../../../introduction/using-the-sdk/#GUIDs) | String |    No    |
| `pitch`           | The pitch of the object, from 0.0° to 360.0°.                                                                                                                                                                            | Float  |    No    |
| `bank`            | The bank of the object, from 0.0° to 360.0°.                                                                                                                                                                             | Float  |    No    |
| `heading`         | The facing heading of the object, from 0.0° to 360.0°.                                                                                                                                                                   | Float  |    No    |

{{< /table-wrapper >}}


 

 

##### &lt;RandomAttach /&gt;

This element is a sub-element of `<AttachedObject>` and is used to apply some randomness to `<AttachedObject>` elements. Note that this is a self-closing element and has the following attributes:

 

<table><thead><tr class="header"><th>Attribute</th><th>Description</th><th>Type</th><th>Required</th></tr></thead><tbody><tr class="odd"><td><code>randomness</code></td><td>When the attached object is to appear. LOCATION_RANDOM will generate a random number based on the location, and so will always be the same. PURE_RANDOM will generate a new random each time the section of scenery is created.</td><td><p>Enum:</p><ol><li>ALWAYS_DISPLAY</li><li>LOCATION_RANDOM</li><li>PURE_RANDOM</li></ol></td><td>Yes</td></tr><tr class="even"><td><code>probability</code></td><td>The probability of the attached object appearing, calculated using a value from 0.0 (never) to 1.0 (always).</td><td>Float</td><td>Yes</td></tr></tbody></table>

 

 

### &lt;ExtrusionBridge&gt;

This is a sub-element of `<FSData>` and is used to define a bridge that will be extruded from the landscape. It needs the `<AltitudeSampleLocationList>`, `<PolylinePointList>`, `<PolylineObjectPlacementList>`, and `<BankShearList>`, sub-elements, and has the following attributes:

`probabilitysuppressPlatforminstanceIdimageComplexityroadWidthextrusionProfilematerialSet`

 

 

#### &lt;AltitudeSampleLocationList&gt;

This is a sub-element of `<ExtrusionBridge>` and is a container for one or more &lt;`AltitudeSampleLocation>` elements.

 

 

#### &lt;PolylinePointList&gt;

This is a sub-element of `<ExtrusionBridge>` and is a container for one or more `<PolylinePoint>` elements.

 

 

#### &lt;PolylineObjectPlacementList&gt;

This is a sub-element of `<ExtrusionBridge>` and is a container for one or more `<PolylineObjectPlacement>` elements.

 

 

#### &lt;BankShearList&gt;

This is a sub-element of `<ExtrusionBridge>` and is a container for one or more `<BankShearEntry>` elements.

 

 

### &lt;ModelData&gt;

This is a sub-element of `<FSData>` and is used to store data about the models in the scene. **This is auto-generated and should *not be edited manually*.** It has the following attributes:

 

{{< table-wrapper >}}

| Attribute    | Description                  | Type    | Required |
|--------------|------------------------------|---------|:--------:|
| `sourceFile` | Source file path.            | String  |    Yes   |
| `fileOffset` | Offset into the source file. | Integer |    No    |

{{< /table-wrapper >}}


 

 

### &lt;GLTFData&gt;

This is a sub-element of `<FSData>` and is used to store data about the GLTF files used in the scene. **This is auto-generated and should *not be edited manually*.** It has the following attribute:

 

{{< table-wrapper >}}

| Attribute    | Description       | Type   | Required |
|--------------|-------------------|--------|:--------:|
| `sourceFile` | Source file path. | String |    Yes   |

{{< /table-wrapper >}}


 

 

### &lt;GeoPol&gt;

This is a sub-element of `<FSData>` and is used to set up geographic locations on the map. It requires at least three `<Vertex />` sub-elements, and has the following attribute:

 

<table><thead><tr class="header"><th>Attribute</th><th>Description</th><th>Type</th><th>Required</th></tr></thead><tbody><tr class="odd"><td><code>type</code></td><td>The type of geopol object.</td><td><p>Enum:</p><ol><li>COASTLINE</li><li>BOUNDARY</li><li>DASHED_BOUNDARY</li></ol></td><td>No</td></tr></tbody></table>

 

 

### &lt;ExclusionRectangle /&gt;

This is a sub-element of `<FSData>` and is used to define a rectangular area which can be used to exclude specific elements. The elements to be excluded are supplied as attributes to the element and are listed in the table below.

{{< callout context="caution" title="IMPORTANT!" icon="outline/alert-triangle" >}}

This element will **not** exclude anything from the current package being edited. It is **only** valid for removing things from a previously loaded package, and is dependent on the package load order. So, packages loaded after the package with the `<ExclusionRectangle>` will be rendered as normal, and packages loaded before the package with the `<ExclusionRectangle>` will have elements excluded.

{{< /callout >}}

{{< callout context="note" title="NOTE" icon="outline/bulb" >}}

Exclusion rectangles will only apply to SimObjects placed via the Scenery Editor. They will not apply to BGL traffic or SimObjects spawned using SimConnect.

{{< /callout >}}

 

This element has no children and is self closing, and it uses the attributes listed below:

 

Attribute

Description

Type

Required

`displayName`

The display name for the object in the Scenery Editor.

{{< callout context="note" title="NOTE" icon="outline/bulb" >}}

this is only used for ordering in the [The Scenery Contents List](../../../devmode/editors/scenery-editor/the-scenery-editor/#the-scenery-contents-list)

{{< /callout >}}

String

No

`parentGroupID`

The ID of the parent group this object belongs to.

{{< callout context="note" title="NOTE" icon="outline/bulb" >}}

this is only used for ordering in the [The Scenery Contents List](../../../devmode/editors/scenery-editor/the-scenery-editor/#the-scenery-contents-list)

{{< /callout >}}

Integer

No

`groupIndex`

The group index of the object.

{{< callout context="note" title="NOTE" icon="outline/bulb" >}}

this is only used for ordering in the [The Scenery Contents List](../../../devmode/editors/scenery-editor/the-scenery-editor/#the-scenery-contents-list)

{{< /callout >}}

Integer

No

`latitudeMinimum`

The minimum latitude for one side of the rectangle.

Float

Yes

`latitudeMaximum`

The maximum latitude for one side of the rectangle.

Float

Yes

`longitudeMinimum`

The minimum longitude for one side of the rectangle.

Float

Yes

`longitudeMaximum`

The maximum longitude for one side of the rectangle.

Float

Yes

`excludeAllObjects`

Setting this will exclude all objects within the rectangular area (in which case none of the other attributes are necessary).

Bool

No

`excludeBeaconObjects`

Setting this will exclude any beacons within the rectangular area.

`excludeEffectObjects`

Setting this will exclude any legacy effect objects within the rectangular area.

`excludeExtrusionBridgeObjects`

Setting this will exclude any extruded bridges within the rectangular area.

`excludeGenericBuildingObjects`

Setting this will exclude any generic buildings within the rectangular area.

`excludeLibraryObjects`

Setting this will exclude any library objects within the rectangular area.

`excludeTaxiwaySignObjects`

Setting this will exclude any taxiway signs within the rectangular area.

`excludeTriggerObjects`

Setting this will exclude any mission trigger objects within the rectangular area.

`excludeWindsockObjects`

Setting this will exclude any windsocks within the rectangular area.

`excludeSimObjects`

Setting this will exclude any SimObjects within the rectangular area.

`excludeWorldScripts`

Setting this will exclude any world script objects within the rectangular area.

`excludeCarParking`

Setting this will exclude any car park objects within the rectangular area.

`excludeRectangles`

Setting this will exclude any rectangles within the rectangular area.

`excludePolygons`

Setting this will exclude any polygons within the rectangular area.

`excludeVisualEffectsObjects`

Setting this will exclude any Visual Effect objects within the rectangular area.

`excludeProjectedMesh`

Setting this will exclude any projected meshes within the rectangular area.

`excludeAirports`

Setting this will exclude the [airport](../airports-and-facilities/airport-xml-properties/) that it has been placed over. This requires that the exclusion rectangle covers the *center* point of the airport, and will prevent *all* airport objects from spawning, including towers, runways, aprons, etc... Note that this will not change any ground textures, and so - if the airport being excluded exists in the real world - there may still be airport areas visible in the {{< glossterm >}}tin{{< /glossterm >}}.

`excludeDecal`

Setting this will exclude any decals within the rectangular area.

`excludeSimPropContainer`

Setting this will exclude any SimProp containers within the rectangular area.

`excludeVFX`

Setting this will exclude any visual effects within the rectangular area.

`excludeTreeObjects`

Setting this will exclude any trees within the rectangular area.

 

 

### &lt;Reward&gt;

This is a sub-element of `<FSData>` and is used to setup a mission reward related to the scenery. It requires the `<Criteria>` sub-element, and has the following attributes:

 

<table><thead><tr class="header"><th>Attribute</th><th>Description</th><th>Type</th><th>Required</th></tr></thead><tbody><tr class="odd"><td><code>rewardId</code></td><td>The reward GUID.</td><td>GUID</td><td>Yes</td></tr><tr class="even"><td><code>type</code></td><td>The type of reward.</td><td><p>Enum:</p><ol><li>BADGE</li><li>CERTIFICATE</li><li>MEDAL</li><li>PLAYERLV</li><li>POSTCARD</li><li>SPECIAL_ITEM</li><li>TROPHY</li></ol></td><td>Yes</td></tr><tr class="odd"><td><code>name</code></td><td>The name of the reward.</td><td>String</td><td>No</td></tr><tr class="even"><td><code>description</code></td><td>A short description of the reward.</td><td>String</td><td>No</td></tr><tr class="odd"><td><code>bitmap</code></td><td>An image to be associated with the award.</td><td>String</td><td>Yes</td></tr><tr class="even"><td><code>rewardDetailBitmap</code></td><td>An image associated with the reward details.</td><td>String</td><td>No</td></tr><tr class="odd"><td><code>rewardDetailDescription</code></td><td>A detailed description of the reward.</td><td>String</td><td>No</td></tr></tbody></table>

 

 

#### &lt;Criteria&gt;

This is a sub-element of `<Reward>` and is used to define the criteria for the reward. It has the following attributes:

`landingsdifferentAirportsairportIcao`

It requires the following sub-elements:

1.  `<RewardHours />`
2.  `<RewardAirport />`
3.  `<DependantRewardId />`

 

 

##### &lt;RewardHours /&gt;

This is a sub-element of `<Criteria>` and is used to set a specific number of hours required for the reward. It is a self-closing element with the following attributes:

1.  `hours`
2.  `hoursType`

 

 

##### &lt;RewardAirport /&gt;

This is a sub-element of `<Criteria>` and is used to set a specific airport required for the reward. It is a self-closing element with the following attributes:

1.  `ident`

 

 

##### &lt;DependantRewardId /&gt;

This is a sub-element of `<Criteria>` and is used to set a dependancy for the reward. It is a self-closing element with the following attributes:

1.  `ident`

 

 

### &lt;TimeZone /&gt;

This is a sub-element of `<FSData>` and is used to define a timezone for the scenery area. It is a self-closing element with the following attributes:

 

<table><thead><tr class="header"><th>Attribute</th><th>Description</th><th>Type</th><th>Required</th></tr></thead><tbody><tr class="odd"><td><code>latitudeMinimum</code></td><td>The minimum latitude for the timezone.</td><td>Float</td><td>Yes</td></tr><tr class="even"><td><code>latitudeMaximum</code></td><td>The maximum latitude for the timezone.</td><td>Float</td><td>Yes</td></tr><tr class="odd"><td><code>longitudeMinimum</code></td><td>The minimum longitude for the timezone.</td><td>Float</td><td>Yes</td></tr><tr class="even"><td><code>longitudeMaximum</code></td><td>The maximum longitude for the timezone.</td><td>Float</td><td>Yes</td></tr><tr class="odd"><td><code>timedeviation</code></td><td>The deviation from UTC for the timezone.</td><td>Float</td><td>Yes</td></tr><tr class="even"><td><code>priority</code></td><td>The priority of this timezone.</td><td>Integer</td><td>Yes</td></tr><tr class="odd"><td><code>daylightSavings</code></td><td>Whether the timezone has daylight savings ("TRUE") or not ("FALSE").</td><td>Bool</td><td>No</td></tr><tr class="even"><td><code>daylightSavingsTimeShift</code></td><td>The deviation from the timezone time when daylight savings is active.</td><td>Float</td><td>No</td></tr><tr class="odd"><td><code>daylightSavingsStartDayOfYearBase</code></td><td></td><td>Integer</td><td>No</td></tr><tr class="even"><td><code>daylightSavingEndDayOfYearBase</code></td><td></td><td>Integer</td><td>No</td></tr><tr class="odd"><td><code>daylightSavingsEndDayOfTheWeek</code></td><td></td><td><p>Enum:</p><ol><li>ANY</li><li>SUNDAY</li><li>MONDAY</li><li>TUESDAY</li><li>WEDNESDAY</li><li>THURSDAY</li><li>FRIDAY</li><li>SATURDAY</li></ol></td><td>No</td></tr><tr class="even"><td><code>dstStartMonth</code></td><td></td><td>Float</td><td>No</td></tr><tr class="odd"><td><code>dstStartDayOfTheWeek</code></td><td></td><td>Float</td><td>No</td></tr><tr class="even"><td><code>dstStartDatOfTheMonth</code></td><td></td><td>Float</td><td>No</td></tr><tr class="odd"><td><code>dstStartRule</code></td><td></td><td><p>Enum:</p><ol><li>DST_RULE_NONE</li><li>DST_RULE_FIXED_DAY</li><li>DST_RULE_LAST_OF_DAY</li><li>DST_RULE_ON_OR_AFTER_DAY</li><li>DST_RULE_ON_OR_BEFORE_DAY</li></ol></td><td>No</td></tr><tr class="even"><td><code>dstEndMonth</code></td><td></td><td>Float</td><td>No</td></tr><tr class="odd"><td><code>dstEndDayOfTheWeek</code></td><td></td><td>Float</td><td>No</td></tr><tr class="even"><td><code>dstEndDatOfTheMonth</code></td><td></td><td>Float</td><td>No</td></tr><tr class="odd"><td><code>dstEndRule</code></td><td></td><td><p>Enum:</p><ol><li>DST_RULE_NONE</li><li>DST_RULE_FIXED_DAY</li><li>DST_RULE_LAST_OF_DAY</li><li>DST_RULE_ON_OR_AFTER_DAY</li><li>DST_RULE_ON_OR_BEFORE_DAY</li></ol></td><td>No</td></tr><tr class="even"><td><code>slANATimeZoneID</code></td><td></td><td>String</td><td>No</td></tr><tr class="odd"><td><code>dstTimeDiffDuringDST</code></td><td></td><td>Float</td><td>No</td></tr><tr class="even"><td><code>dstTimeDiffOutsideDST</code></td><td></td><td>Float</td><td>No</td></tr></tbody></table>

 

  

### &lt;Polygon&gt;

This is a sub-element of `<FSData>` and is used to define a polygonal surface in a scene. It has multiple possible uses, for example:

-   flatten terrain
-   exclude auto-generated buildings
-   force or exclude vegetation
-   change vegetation type
-   specify airport zones (changes the type of auto-generated buildings)
-   apply a material to the ground
-   add or remove water

 

This element can have the following sub-elements, which are required to define the polygon shape:

1.  `<Attribute />`
2.  `<Vertex />`

 

The polygon object will need at least 3 `<Vertex />` definitions to be valid, and can have no more that 65536 vertices total, otherwise the simulation will not display it. This element has the following attributes:

 

<table><thead><tr class="header"><th>Attribute</th><th>Description</th><th>Type</th><th>Required</th></tr></thead><tbody><tr class="odd"><td><code>version</code></td><td>This can be used to give a version number to the polygon object.</td><td>String</td><td>No</td></tr><tr class="even"><td><p><code>displayName</code></p></td><td><p>The display name for the object in the Scenery Editor.</p><p><strong>NOTE</strong>: this is only used for ordering in the <a href="../../../2_DevMode/Scenery_Editor/The_Scenery_Editor/#contents_list">The Scenery Contents List</a></p></td><td>String</td><td>No</td></tr><tr class="odd"><td><p><code>parentGroupID</code></p></td><td><p>The ID of the parent group this object belongs to.</p><p><strong>NOTE</strong>: this is only used for ordering in the <a href="../../../2_DevMode/Scenery_Editor/The_Scenery_Editor/#contents_list">The Scenery Contents List</a></p></td><td>Integer</td><td>No</td></tr><tr class="even"><td><p><code>groupIndex</code></p></td><td><p>The group index of the object.</p><p><strong>NOTE</strong>: this is only used for ordering in the <a href="../../../2_DevMode/Scenery_Editor/The_Scenery_Editor/#contents_list">The Scenery Contents List</a></p></td><td>Integer</td><td>No</td></tr><tr class="odd"><td><code>altitude</code></td><td>The altitude of the polygon object, in meters.</td><td>Float</td><td>No</td></tr></tbody></table>

 

 

#### &lt;Attribute /&gt;

This element is used within the `<Polygon>` object - sometimes multiple times - to define the features of the polygon. The element is self-closing and has the following attributes:

Attribute

Description

Type

Required

`name`

The name of the attribute that is being added to the polygon object. You may include multiple `<Attribute />` tags in a single polygon definition if it requires multiple attributes. See the table below for more information on the attribute types. You can find an example of a polygon using multiple attributes [here](scenery-object-example/#polygon).

String

No

`GUID`

A {{< glossterm >}}guid{{< /glossterm >}}-formatted string to identify the attribute. You can find more information on GUID's here: [GUIDs](../../../introduction/using-the-sdk/#GUIDs)

Yes

`type`

The type of value to be expected for the attribute.

`value`

The value for the named attribute.

 

The table below shows the possible name attributes and their corresponding types and values:

 

<table><thead><tr class="header"><th><code>name</code></th><th><code>GUID</code></th><th>Description</th><th><code>type</code></th><th><code>value</code></th></tr></thead><tbody><tr class="odd"><td><code>Version</code></td><td>{CE85242F-4110-4706-8344-1F3A8EE422BE}</td><td>A version number for the polygon.</td><td>STRING</td><td>A version number.</td></tr><tr class="even"><td><code>UniqueGUID</code></td><td>{359C73E8-06BE-4FB2-ABCB-EC942F7761D0}</td><td>The <a href="#" class="glossterm">GUID</a>-formatted <strong>Instance ID</strong> unique to the specific instance of the polygon object placed within the simulation.</td><td>GUID</td><td>GUID String, eg:  

"{6A44EFFC-195D-4E43-A2B2-62B0E285062A}"</td></tr><tr class="odd"><td><code>Texture</code></td><td>{1B6A15BB-05FB-4401-A8D1-BB520E84904C}</td><td>The <a href="#" class="glossterm">GUID</a>-formatted <strong>Texture ID</strong> to be used with the polygon.</td><td>GUID</td><td>GUID String, eg:  

"{6A44EFFC-195D-4E43-A2B2-62B0E285062A}"</td></tr><tr class="even"><td><code>FlattenFalloff</code></td><td>{5548fdb5-2267-4328-8e6f-fd0a45adec8f}</td><td>This sets the distance around the polygon which will be "feathered", smoothing the difference in altitude between the polygon terraformer and the surrounding terrain.</td><td>FLOAT32</td><td>A value in meters.</td></tr><tr class="odd"><td><code>FlattenMode</code></td><td>{065e9d4d-6984-4d2a-91fd-3c33c4f53b22}</td><td>Sets whether the polygon should flatten the terrain it is placed on or not.</td><td>UINT8</td><td>Integer, either 0 (enabled) or 1 (disabled).</td></tr><tr class="even"><td><code>ExcludeDetectedBuildings</code></td><td>{5C1A2387-1F07-47DF-A569-962CF6258E55}</td><td>Convert the polygon into an exclusion polygon which will exclude buildings created algorithmically from the aerial image data.</td><td>UINT8</td><td>Integer, either 0 (false) or 1 (true).</td></tr><tr class="odd"><td><code>ExcludeOSMBuildings</code></td><td>{F3C2635D-9F2F-458F-8663-90B3837BED09}</td><td>Convert the polygon into an exclusion polygon which will exclude buildings created from the data supplied by <a href="https://www.openstreetmap.org/">Open Street Maps</a>.</td><td>UINT8</td><td>Integer, either 0 (false) or 1 (true).</td></tr><tr class="even"><td><code>ExcludeMSBuildings</code></td><td>{F78A3074-8AD5-4B8B-92C4-C1C948BB7AA5}</td><td>Convert the polygon into an exclusion polygon which will exclude buildings generated from open-source data for North America that comes from Microsoft.</td><td>UINT8</td><td>Integer, either 0 (false) or 1 (true).</td></tr><tr class="odd"><td><code>ExcludeTIN</code></td><td>{18B58CBF-AE02-4A19-8AA9-3809E8E73400}</td><td>Convert the polygon into an exclusion polygon which will exclude the <a href="#" class="glossterm">TIN</a> data streamed from Bing Maps, which may include buildings as well as other things.</td><td>UINT8</td><td>Integer, either 0 (false) or 1 (true).</td></tr><tr class="even"><td><code>ExclusionFlags</code></td><td>{4CACC252-E6DC-419A-B20C-16EC601DF70E}</td><td>A single value used to represent multiple possible exclusions for the polygon, summed together.</td><td>UINT32</td><td><p>Integer, a combination of the following (summed together):</p><ol><li>1: roads</li><li>2: street lights</li><li>4: power lines</li><li>8: feature points</li></ol></td></tr><tr class="odd"><td><code>BuildingOnTIN</code></td><td>{4c252581-63e9-4c22-8a3d-14b31f3c8157}</td><td>This can be used when you have excluded <a href="#" class="glossterm">TIN</a> data, but want to still have <a href="#" class="glossterm">TIN</a> generated buildings present.</td><td>UINT8</td><td>Integer, either 0 (false) or 1 (true).</td></tr><tr class="even"><td><code>ForceDetectedBuilding</code></td><td>{69A63EDD-FBE5-4F0D-88E6-6FA01963D613}</td><td>This option can be used to force the rendering of detected buildings for an area.</td><td>UINT8</td><td>Integer, either 0 (false) or 1 (true).</td></tr><tr class="odd"><td><code>BiomeName</code></td><td>{E5FA1B20-BB2F-40D5-913B-480C547CC9B8}</td><td>This option permits you to select a different biome to be used for the vegetation within the polygon area. Note that when this attribute is included, any Material you have defined will no longer be shown.</td><td>STRING</td><td><p>String to define the biome, one of the following:</p><p>None  

Andean_Mountains  

Baobab_Madagascar  

Cedrus_Lebanon  

Chaparral_Deciduous  

Chaparral_Evergreen  

Chaparral_Tropical  

CherryBlossom  

Conifer_Cold_2024  

Conifer_Cold_SouthCentralRockies  

Conifer_Cold_CaledonConifer  

Conifer_Warm  

Conifer_Warm_Evergreen  

Conifer_Warm_CanaryIslands  

Conifer_Warm_Tropical  

Date_Tree  

Deciduous_2024  

Deciduous_NorthAmerica  

Desert  

Desert_JoshuaTree  

Desert_Saguaro  

Desert_Socotra  

Desert_Yucca  

Eucalyptus_Evergreen  

Eucalyptus_Deciduous  

Everglades  

Evergreen_Generic  

Mangrove  

Mineral  

Mixed_Cold  

Mixed_Cold_NorthAmerica  

Mixed_Cold_Alps  

Mixed_Cold_Pyrenees  

Mixed_Warm  

Mixed_Warm_Himalaya  

Mixed_Warm_CantabrianMixedForest  

Mixed_Warm_Evergreen  

Moor  

RainForest  

Riviera  

Savanna  

Savanna_Flooded  

Semi-Desert  

Semi-Desert_GrandCanyon  

Semi-Desert_Eucalyptus  

Sequoia  

Steppe  

SubTropical  

Taiga  

Tropical</p></td></tr><tr class="even"><td><code>LandClassRemap</code></td><td>{0a685eb0-0e01-44fe-b9ef-bfffbc968ade}</td><td>This is used to flag the polygon as belonging to an aitport.</td><td>UINT8</td><td>Integer, either 0 (false) or 2 (true).</td></tr><tr class="odd"><td><code>VegetationScale</code></td><td>{6a043f59-e6f2-4117-a2e4-d510e7317c29}</td><td>This sets the scale of the vegetation within the polygon.</td><td>UINT32</td><td>A value between 0 and 255, mapped to a scale of 0 and 1, respectively.</td></tr><tr class="even"><td><code>VegetationDensity</code></td><td>{41EFF715-C392-4B31-A457-50A504353A90}</td><td>This sets the density of vegetation within the polygon.</td><td>UINT32</td><td>Value between 0 and 62, where 31 is 100%, 0 is 0% and 62 is 200%.</td></tr><tr class="odd"><td><code>VegetationFalloff</code></td><td>{E82ABE17-FB4C-4F67-A28C-ED41969AEAD6}</td><td>This sets the distance around the polygon in which the vegetation will be "feathered" between the edge and the surrounding terrain.</td><td>FLOAT32</td><td>Value is in meters.</td></tr><tr class="even"><td><code>TreeBrightnessFactor</code></td><td>{63040596-0B21-48FD-8B5F-A9E84A5B7BC9}</td><td>This setting is for changing the brightness of the vegetation color.</td><td>UINT32</td><td>Value between 0 and 255, where 127 is 100%, 0 is 0% and 255 is 200%.</td></tr><tr class="odd"><td><code>MaterialGUID</code></td><td>{cd28efd0-d3f0-43b6-9f88-4e4707344a04}</td><td>The <a href="#" class="glossterm">GUID</a>-formatted <strong>ID</strong> unique to the material to use with the polygon object. You can find more information on GUID's here: <a href="../../../1_Introduction/Using_The_SDK/#GUIDs">GUIDs</a></td><td>GUID</td><td>GUID String, eg:  

"{6A44EFFC-195D-4E43-A2B2-62B0E285062A}"</td></tr><tr class="even"><td><code>MaterialTiling</code></td><td>{58d2d4ff-1657-4ab0-bdb2-09b2d8a77688}</td><td>This sets the tiling scale for the texture used by the material. Will have no effect if <code>MaterialStretchUV</code> is used.</td><td>FLOAT32</td><td>Value is in meters.</td></tr><tr class="odd"><td><code>MaterialFalloff</code></td><td>{c17ebbde-627d-4585-94f0-7c329cd69c4e}</td><td>This sets the distance around the polygon in which the material will be "feathered" to smooth the transition between the polygon material and the terrain.</td><td>FLOAT32</td><td>Value is in meters.</td></tr><tr class="even"><td><code>MaterialRotation</code></td><td>{a27e9c0f-d3f5-4fb2-b020-82179bdb622d}</td><td>This sets the angle at which the material texture will be rendered.</td><td>FLOAT32</td><td>Value between 0 and 6.283185 (angle expressed in radians).</td></tr><tr class="odd"><td><code>MaterialOpacity</code></td><td>{591218a9-7b17-40cc-b38c-57a201a20c1d}</td><td>This is for changing the transparency of the material.</td><td>UINT8</td><td>A value between 0 and 255, mapped to a scale of 0 and 1, respectively.</td></tr><tr class="even"><td><code>MaterialColoration</code></td><td>{b140b3cc-5887-449c-95ce-98d9e900cb58}</td><td>This permits you to add a colored "tint" to the material. Setting the RGB values to (0, 0, 0) will remove all tinting.</td><td>UINT32</td><td><p>An unsigned integer that can be represented in hexadecimal with the format "RRGGBBAA". EG:</p><ol><li>Red = FF0000FF = 4278190335</li><li>Green = 00FF00FF = 16711935</li><li>Blue = 0000FFFF = 65535</li></ol><p>Note that the alpha component is always 255.</p></td></tr><tr class="odd"><td><code>MaterialStretchUV</code></td><td>{f0de1339-8268-4476-af0e-e97fef943117}</td><td>Flags the material as being streteched over the whole polygon, rather than being tiled. If this is set to 1, then <code>MaterialTiling</code> will have no effect.</td><td>UINT8</td><td>Either 0 (disabled) or 1 (enabled).</td></tr><tr class="even"><td><code>MaterialUOffset</code></td><td>{b3915523-b259-484e-9256-c5413739cd98}</td><td>Sets an offset on the U-axis for the material texture within thew polygon.</td><td>FLOAT32</td><td>Value should be between 0 and 1.</td></tr><tr class="odd"><td><code>MaterialVOffset</code></td><td>{970da755-0f77-40af-be89-8a977d7c2958}</td><td>Sets an offset on the V-axis for the material texture within thew polygon.</td><td>FLOAT32</td><td>Value should be between 0 and 1.</td></tr><tr class="even"><td><code>Layer</code></td><td>{9E2B4C3E-7D84-453F-9DCC-B6498FF46703}</td><td>This option sets the render priority for the polygon. The default render priority is 0, which for most cases is fine. However, if you have overlapping polygons and want one to render over another one, then you will need to change this value.</td><td>UINT32</td><td>A render priority value. Higher priority values will render over lower priorities, for example, a polygon with priority 1 will render over one with priority 0, which in turn will render over one with priority -1. Note that the engine cannot guarantee the render order for polygons with the same priority, so if you need something to always render over or under something else, you need to set this value.</td></tr><tr class="odd"><td><code>IsWater</code></td><td>{684AFC09-9B38-4431-8D76-E825F54A4DFF}</td><td>Selecting this option tells the simulation that the polygon is defining an area of water.</td><td>UINT8</td><td>Integer, either 0 (false) or 1 (true).</td></tr><tr class="even"><td><code>WaterType</code></td><td>{3F8514F8-FAA8-4B94-AB7F-DC2078A4B888}</td><td>Sets the type of water that you are defining with the polygon.</td><td>UINT32</td><td><p>Integer, where:</p><ol><li>0: River</li><li>1: Waste Water</li><li>2: Generic Water</li><li>3: Pond</li><li>4: Lake</li><li>5: Ocean</li></ol></td></tr><tr class="odd"><td><code>IsWaterExclusion</code></td><td>{972B7BAC-F620-4D6E-9724-E70BF8A450DD}</td><td>Selecting this option tells the simulation that the polygon is defining an area that excludes water.</td><td>UINT8</td><td>Integer, either 0 (false) or 1 (true).</td></tr><tr class="even"><td><code>AirportSize</code></td><td>{86A147E9-ACF2-4780-9D3C-416373ECB451}</td><td>This option will affect the size and type of buildings that may be auto-generated in the area as well as certain airport models like ATC Towers.</td><td>UINT8</td><td><p>Value between 0 and 6, corresponding to:</p><ol><li>0: Unkown</li><li>1: XS</li><li>2: S</li><li>3: M</li><li>4: L</li><li>5: XL</li><li>6: XXL</li></ol></td></tr><tr class="odd"><td><code>IsAirportInternational</code></td><td>{F8A7B13F-BD91-48F8-AC66-6C8601A2F1C6}</td><td>This option tells the simulation that the area is part of an airport.</td><td>UINT8</td><td>Integer, either 0 (false) or 1 (true).</td></tr><tr class="even"><td><code>SubjectPhotoGUID</code></td><td>{390e5e85-c2f5-4648-842b-77c475c7d961}</td><td>The <a href="#" class="glossterm">GUID</a>-formatted <strong>ID</strong> used in mission files for <a href="#" class="glossterm">POI</a> photography.</td><td>STRING</td><td>GUID String, eg:  

"{6A44EFFC-195D-4E43-A2B2-62B0E285062A}"</td></tr><tr class="odd"><td><code>PreciseTerraforming</code></td><td>{4D2A51D4-91AC-412F-833E-212CC10E5FBC}</td><td>Sets whether the polygon terraforming should use the old render pipeline or the new one. By default, the modern rendering will always be used, but for legacy airports and scenery files, you may wish to set this to 0 (false).</td><td>UINT8</td><td>Integer, either 0 (disabled) or 1 (enabled)</td></tr><tr class="even"><td><code>AffectRocks</code></td><td>{F60DBBC7-DE6F-4FEA-BE7E-AFB1D73D57E7}</td><td>Sets whether the polygon should affect any rocks in the area.</td><td>UINT8</td><td>Integer, either 0 (disabled) or 1 (enabled)</td></tr><tr class="odd"><td><code>ExcludeRocks</code></td><td>{f104723a-d6d1-4b2e-9b44-accd8ab372dc}</td><td>Sets whether the polygon should exclude any rocks in the area. Requires <code>AffectRocks</code> to be enabled.</td><td>UINT8</td><td>Integer, either 0 (disabled) or 1 (enabled)</td></tr><tr class="even"><td><code>RocksScale</code></td><td>{d5f9fe69-ebd5-44df-9acb-155063b5b9c5}</td><td>Sets the size scale of any rocks in the polygon area. Requires <code>AffectRocks</code> to be enabled.</td><td>UINT32</td><td>Scale value between 0 and 127 <em>only</em>, where 64 is the "default" scale.</td></tr><tr class="odd"><td><code>RocksDensity</code></td><td>{dc8f839b-a39d-4c23-b01f-c175cfd69e45}</td><td>Sets the density of any rocks in the polygon area. Requires <code>AffectRocks</code> to be enabled.</td><td>UINT32</td><td>Density value, between 0 (minimum density) and 255 (maximum density) <em>only</em>.</td></tr><tr class="even"><td><code>RocksFallOff</code></td><td>{dd4b2a9e-138e-446f-8de6-4a0ce227b3ca}</td><td>This sets the distance around the polygon in which rocks will be "feathered" to smooth the transition between the polygon edge and the rest of the terrain. Requires <code>AffectRocks</code> to be enabled.</td><td>FLOAT32</td><td>Value is in meters, and must be positive.</td></tr><tr class="odd"><td><code>GeomeName</code></td><td>{f0b11821-16fc-407b-be5a-dbeb67a77571}</td><td>Give the name of the geome to use for the rocks in the polygon area.</td><td>STRING</td><td><p>The name of the geome to use, one of the following:</p><ol><li>Granite</li><li>Limestone</li><li>Sandstone</li><li>Shale</li><li>Volcanic</li><li>Default</li></ol></td></tr><tr class="even"><td><code>UseOldFalloff</code></td><td>{1a383a76-dff0-4ac2-8d11-6b2f2595f771}</td><td>Tells the polygon to use the legacy falloff method for rendering the edges of the heightmap. Only valid when <code>FlattenMode</code> is enabled.</td><td>UINT8</td><td>Integer, either "0" (disabled) or "1" (enabled).</td></tr><tr class="odd"><td><code>ExcludeSecondaryHeightmap</code></td><td>{10ac14e9-4656-4480-aa8c-3563ee6d127f}</td><td>When enabled, it will exclude any secondary heightmaps that overlap with the polygon object.</td><td>UINT8</td><td>Integer, either "0" (disabled) or "1" (enabled).</td></tr><tr class="even"><td><code>ForceElevation</code></td><td>{9460843d-964b-4e45-ac49-634856fb6e1c}</td><td>When enabled, this option will force the ground to be at the same elevation as the terraformer, creating a perfectly flat surface. Only valid when <code>FlattenMode</code> is enabled.</td><td>UINT8</td><td>Integer, either "0" (disabled) or "1" (enabled).</td></tr></tbody></table>

 

 

### &lt;Rectangle&gt;

This is a sub-element of `<FSData>` and is used to define a rectangular surface in a scene. It is generally used for terraforming an area and for changing the surface material within the rectangle. The rectangle is defined by supplying two sets of coordinates for latitude, longitude and altitude, which will set the positions for two sides of the rectangle, while the width value sets how wide the rectangular area will be between those points. The diagram below helps illustrate this:

{{< image-center
    src="images/5_Content_Config/Environment/Scenery_Objects/scenery_rectangle.png"
    alt="Scenery Rectangle Being Defined" >}}

 

This element can contain the `<RunwayDeformation />` (to apply a slope) as well as the `<Heightmap />` (to add deformation) sub-elements, and takes the following attributes:

 

<table><thead><tr class="header"><th>Attribute</th><th>Description</th><th>Type</th><th>Required</th></tr></thead><tbody><tr class="odd"><td><p><code>displayName</code></p></td><td><p>The display name for the object in the Scenery Editor.</p><p><strong>NOTE</strong>: this is only used for ordering in the <a href="../../../2_DevMode/Scenery_Editor/The_Scenery_Editor/#contents_list">The Scenery Contents List</a></p></td><td>String</td><td>No</td></tr><tr class="even"><td><p><code>parentGroupID</code></p></td><td><p>The ID of the parent group this object belongs to.</p><p><strong>NOTE</strong>: this is only used for ordering in the <a href="../../../2_DevMode/Scenery_Editor/The_Scenery_Editor/#contents_list">The Scenery Contents List</a></p></td><td>Integer</td><td>No</td></tr><tr class="odd"><td><p><code>groupIndex</code></p></td><td><p>The group index of the object.</p><p><strong>NOTE</strong>: this is only used for ordering in the <a href="../../../2_DevMode/Scenery_Editor/The_Scenery_Editor/#contents_list">The Scenery Contents List</a></p></td><td>Integer</td><td>No</td></tr><tr class="even"><td><code>width</code></td><td>The total width of the rectangular area, in meters.</td><td>Float</td><td>Yes</td></tr><tr class="odd"><td><code>falloff</code></td><td>Defines the range of terrain affected by the flattening of the rectangular area, higher value meaning an increase range.</td><td>Float</td><td>Yes</td></tr><tr class="even"><td><code>surface</code></td><td>Material to apply to the rectangular surface. If not supplied, then the original terrain surface material will be used.</td><td></td><td>No</td></tr><tr class="odd"><td><code>latitude</code></td><td>Latitude of the first side of the rectangular area.</td><td>Float</td><td>Yes</td></tr><tr class="even"><td><code>longitude</code></td><td>Longitude of the first side of the rectangular area.</td><td>Float</td><td>Yes</td></tr><tr class="odd"><td><code>altitude</code></td><td>Altitude of the first side of the rectangular area, in meters. Please note that the referential for this value is always ELLIPSOID.</td><td>Float</td><td>Yes</td></tr><tr class="even"><td><code>latitude2</code></td><td>Latitude of the second side of the rectangular area.</td><td>Float</td><td>Yes</td></tr><tr class="odd"><td><code>longitude2</code></td><td>Longitude of the second side of the rectangular area.</td><td>Float</td><td>Yes</td></tr><tr class="even"><td><code>altitude2</code></td><td>Altitude of the second side of the rectangular area, in meters. Please note that the referential for this value is always ELLIPSOID.</td><td>Float</td><td>Yes</td></tr><tr class="odd"><td><code>priority</code></td><td>This value is used to define the order in which the terraforming rectangles should be applied.</td><td>Integer</td><td>No</td></tr><tr class="even"><td><code>precision</code></td><td>When set to "TRUE" the modern terrain precision model will be used for heightmaps and terrain changes. WHen set to "FALSE" the legacy terrain precision will be used.</td><td>Bool</td><td>No</td></tr><tr class="odd"><td><code>forceElevation</code></td><td>When enabled (set to "TRUE") this option will force the ground to be at the same elevation as the terraformer, creating a perfectly flat surface.</td><td>Bool</td><td>No</td></tr></tbody></table>

 

 

#### &lt;Heightmap /&gt;

This sub-element can be added to a `<Rectangle>` to define a set of heightmap values to the area being terraformed. This element takes two attributes:

 

<table><thead><tr class="header"><th>Attribute</th><th>Description</th><th>Type</th><th>Required</th></tr></thead><tbody><tr class="odd"><td><code>width</code></td><td>The width of the data grid.</td><td>Integer</td><td>Yes</td></tr><tr class="even"><td><code>data</code></td><td><p>A list of altitude values, where each value is separated by a space, eg:</p><p><code>data="49.393673 49.393929 49.394184 49.394440"</code></p></td><td>String</td><td>Yes</td></tr></tbody></table>

 

The heightmap will be applied to the entire rectangle, and the attributes are basically defining a grid of values where:

number\_of\_data\_values = width \* length

 

For example, say we want to apply a heightmap of 9 points to the defined rectangle. We'd use this element like this:

``` xml
<Heightmap width="3" data="val1 val2 val3 val4 val5 val6 val7 val8 val9" />
```

This would then be applied to the rectangle like this:

{{< image-center
    src="images/5_Content_Config/Environment/Scenery_Objects/scenery_heightmap.png"
    alt="Heightmap Element Example Illustration" >}}

 

 

### &lt;Group&gt;

This is a sub-element of `<FSData>` and is used to define a group of Scenery Objects in the [Scenery Editor](../../../devmode/editors/scenery-editor/the-scenery-editor/). It requires one or more `<SceneryObject>` sub-elements and will be added to the XML automatically by the editor, if required. As such, **this element should never be added manually**, otherwise errors could occur. This element has the following attributes:

 

<table><thead><tr class="header"><th>Attribute</th><th>Description</th><th>Type</th><th>Required</th></tr></thead><tbody><tr class="odd"><td><code>name</code></td><td>A unique name for the group.</td><td>String</td><td>No</td></tr><tr class="even"><td><p><code>displayName</code></p></td><td><p>The display name for the object in the Scenery Editor.</p><p><strong>NOTE</strong>: this is only used for ordering in the <a href="../../../2_DevMode/Scenery_Editor/The_Scenery_Editor/#contents_list">The Scenery Contents List</a></p></td><td>String</td><td>No</td></tr><tr class="odd"><td><p><code>parentGroupID</code></p></td><td><p>The ID of the parent group this object belongs to.</p><p><strong>NOTE</strong>: this is only used for ordering in the <a href="../../../2_DevMode/Scenery_Editor/The_Scenery_Editor/#contents_list">The Scenery Contents List</a></p></td><td>Integer</td><td>No</td></tr><tr class="even"><td><p><code>groupIndex</code></p></td><td><p>The group index of the object.</p><p><strong>NOTE</strong>: this is only used for ordering in the <a href="../../../2_DevMode/Scenery_Editor/The_Scenery_Editor/#contents_list">The Scenery Contents List</a></p></td><td>Integer</td><td>No</td></tr><tr class="odd"><td><code>groupID</code></td><td>The group ID.</td><td>GUID</td><td>No</td></tr><tr class="even"><td><code>groupGenerated</code></td><td>Whether the group is auto generated (TRUE) or not (FALSE).</td><td>Bool</td><td>No</td></tr></tbody></table>

 

 

### &lt;DeleteNavigation&gt;

This is a sub-element of `<FSData>` and is used to define the parts of the Navigation Data to be removed from the scene.

{{< callout context="caution" title="IMPORTANT!" icon="outline/alert-triangle" >}}

Before editing any navigation data please read the [Note On Navigation Data](../airports-and-facilities/airports-and-facilities/#note-on-navigation-data).

{{< /callout >}}

 

This is a self-closing sub-element, with no children, and using the following attributes:

 

{{< table-wrapper >}}

| Attribute                    | Description                                                                | Type | Required |
|------------------------------|----------------------------------------------------------------------------|------|:--------:|
| `deleteAllWaypoints`         | Delete all waypoints from the world.                                       | Bool |    No    |
| `deleteAllVORs`              | Delete all {{< glossterm >}}vor{{< /glossterm >}} from the world.           | Bool |    No    |
| `deleteAllNDBs`              | Delete all {{< glossterm >}}ndb{{< /glossterm >}} from the world.           | Bool |    No    |
| `deleteAllTerminalWaypoints` | Delete all terminal waypoints from the world.                              | Bool |    No    |
| `deleteAllTerminalNDBs`      | Delete all terminal {{< glossterm >}}ndb{{< /glossterm >}}s from the world. | Bool |    No    |
| `deleteAllILSs`              | Delete all {{< glossterm >}}ils{{< /glossterm >}} from the world.           | Bool |    No    |
| `deleteAllApproaches`        | Delete all approach legs from the world.                                   | Bool |    No    |
| `deleteAllDepartures`        | Delete all departure waypoints from the world.                             | Bool |    No    |
| `deleteAllArrivals`          | Delete all arrival waypoints from the world.                               | Bool |    No    |
| `deleteAllFrequencies`       | Delete all frequencies from the world.                                     | Bool |    No    |

{{< /table-wrapper >}}


 

 

### &lt;LandmarkLocation&gt;

This sub-element of `<FSData>` is used to designate a particular location as a "landmark", which will then be shown to the user both in the world map and in the world itself when flying around. It can have the `<LandmarkDeparture />` sub-element, or it can be self-closing.

{{< callout context="note" title="NOTE" icon="outline/bulb" >}}

This element can only be used when the parent elements are **not** part of an airport.

{{< /callout >}}

 

This element has the following attributes:

 

<table><thead><tr class="header"><th>Attribute</th><th>Description</th><th>Type</th><th>Required</th></tr></thead><tbody><tr class="odd"><td><code>instanceId</code></td><td><a href="#" class="glossterm">GUID</a> used to identify this instance of the element. You can find more information on GUID's here: <a href="../../../1_Introduction/Using_The_SDK/#GUIDs">GUIDs</a></td><td>String</td><td>Yes</td></tr><tr class="even"><td><p><code>displayName</code></p></td><td><p>The display name for the object in the Scenery Editor.</p><p><strong>NOTE</strong>: this is only used for ordering in the <a href="../../../2_DevMode/Scenery_Editor/The_Scenery_Editor/#contents_list">The Scenery Contents List</a></p></td><td>String</td><td>No</td></tr><tr class="odd"><td><p><code>parentGroupID</code></p></td><td><p>The ID of the parent group this object belongs to.</p><p><strong>NOTE</strong>: this is only used for ordering in the <a href="../../../2_DevMode/Scenery_Editor/The_Scenery_Editor/#contents_list">The Scenery Contents List</a></p></td><td>Integer</td><td>No</td></tr><tr class="even"><td><p><code>groupIndex</code></p></td><td><p>The group index of the object.</p><p><strong>NOTE</strong>: this is only used for ordering in the <a href="../../../2_DevMode/Scenery_Editor/The_Scenery_Editor/#contents_list">The Scenery Contents List</a></p></td><td>Integer</td><td>No</td></tr><tr class="odd"><td><code>lat</code></td><td>The latitude where the landmark appears.</td><td>Float</td><td>Yes</td></tr><tr class="even"><td><code>lon</code></td><td>The longitude where the landmark appears.</td><td>Float</td><td>Yes</td></tr><tr class="odd"><td><code>alt</code></td><td>The altitude where the landmark appears.</td><td>Float</td><td>Yes</td></tr><tr class="even"><td><code>name</code></td><td>The name of the landmark. This string can be localised.</td><td>String</td><td>Yes</td></tr><tr class="odd"><td><code>type</code></td><td><p>The type of landmark object marker to use. One of the following:</p><ol><li><strong>"City"</strong>: This marks a particular city. Landmark cities are only shown on the World Map.</li><li><strong>"Fauna"</strong>: This marks an area of fauna. Landmark fauna areas are shown on the World Map and in the world during a flight.</li><li><strong>"Natural"</strong>: This is for marking some natural phenomenon or area. Landmark natural areas are only shown on the World Map.</li><li><strong>"POI"</strong>: This marks a "Point Of Interest". Landmark <a href="../../../2_DevMode/Scenery_Editor/Objects/LandmarkLocation_Objects/#" class="glossterm">POI</a> are shown on the World Map and in the world during a flight.</li><li><strong>"Star landmark"</strong>: This marks a special landmark with a "Star" marker. Landmark star points are shown on the World Map and in the world during a flight.</li></ol></td><td>String</td><td>Yes</td></tr><tr class="even"><td><code>offset</code></td><td>This is an offset for the height of the landmark marker. Normally this is simply left at 0, but if you have multiple landmarks in a similar area, you can use this offset value to ensure that all the markers are seen without any overlap.</td><td>Float</td><td>No</td></tr><tr class="odd"><td><code>owner</code></td><td>The "owner" can be the name of the user that is creating the asset or a company name.</td><td>String</td><td>No</td></tr><tr class="even"><td><code>distToShowMarker</code></td><td>This sets the distance from the user aircraft outside of which the landmark marker will not be shown, in meters.</td><td>Float</td><td>No</td></tr><tr class="odd"><td><code>altitudeToSpawn</code></td><td>This sets the altitude above the ground at which the user aircraft will be spawned when the POI has been selected from the world map as the departure point. Set to -1 to use the default altitude. Value is in meters.</td><td>Float</td><td>No</td></tr><tr class="even"><td><code>geoNameId</code></td><td>Integer ID of the record in <a href="https://www.geonames.org/">GeoNames</a> database.</td><td>Integer</td><td>No</td></tr><tr class="odd"><td><code>geoNameFeatureClass</code></td><td>This is the class of geographic feature at the landmark location. It will be used to set world map flags for the feature if included.</td><td><p>String:</p><ol><li>"A" - Administrative Boundary Features</li><li>"H" - Hydrographic Features</li><li>"L" - Area Features</li><li>"P" - Populated Place Features</li><li>"R" - Road / Railroad Features</li><li>"S" - Spot Features</li><li>"T" - Hypsographic Features</li><li>"U" - Undersea Features</li><li>"V" - Vegetation Features</li></ol></td><td>No</td></tr><tr class="even"><td><code>geoNameFeatureCode</code></td><td>This is a 2-5 letter code that refines the feature class down to a specific type of feature. See <a href="Landmark_Feature_Classes.htm">Landmark Feature Classes</a> for more information.  

<strong>NOTE</strong>: This is currently not used in the simulation.</td><td>String</td><td>No</td></tr></tbody></table>

 

You can find an example of the generated XML for this object here: [LandmarkLocation Objects](scenery-object-example/#landmarks).

 

 

#### &lt;LandmarkDeparture /&gt;

This is an optional sub-element of `<LandmarkLocation>` used to define the spawn location for any aircraft departing from this landmark location. This element has the following attributes:

 

{{< table-wrapper >}}

| Attribute | Description                                   | Type  | Required |
|-----------|-----------------------------------------------|-------|:--------:|
| `lat`     | The latitude where the aircraft will depart.  | Float |    Yes   |
| `lon`     | The longitude where the aircraft will depart. | Float |    Yes   |
| {{< input "Alt" />}}     | The altitude where the aircraft will depart.  | Float |    Yes   |
| `heading` | The heading for the aircraft on departure.    | Float |    Yes   |

{{< /table-wrapper >}}


 

 

### &lt;AiracCycle /&gt;

This sub-element of `<FSData>` is used to define the current AIRAC Cycle. It is a self closing element with no sub-elements.

{{< callout context="caution" title="IMPORTANT!" icon="outline/alert-triangle" >}}

This is generated by the simulation developers and should not be edited. The section here is for **information only**.

{{< /callout >}}

This element has the following attributes:

 

{{< table-wrapper >}}

| Attribute     | Description                                                            | Type   | Required |
|---------------|------------------------------------------------------------------------|--------|:--------:|
| `cycleBegin`  | The date the cycle begins, givens in the following format: "DD-MM-YY". | String |    Yes   |
| `cycleEnd`    | The date the cycle ends, given in the following format: "DD-MM-YY".    | String |    Yes   |
| `cycleNumber` | The cycle number, given as a two digit string: "XX".                   | String |    Yes   |

{{< /table-wrapper >}}


 

 

### &lt;ProjectedMesh&gt;

This element is used to add a [ProjectedMesh Object](../../../devmode/editors/scenery-editor/objects/projectedmesh-objects/) to a scene, although it can *also* be used to add a projected mesh object to an airport by adding it as a sub-element of `<Airport>`. Each projected mesh element requires a `<SceneryObject>` sub-element to define the object that belongs to it.

 

The element has the following attributes:

 

<table><thead><tr class="header"><th>Attribute</th><th>Description</th><th>Type</th><th>Required</th></tr></thead><tbody><tr class="odd"><td><p><code>displayName</code></p></td><td><p>The display name for the object in the Scenery Editor.</p><p><strong>NOTE</strong>: this is only used for ordering in the <a href="../../../2_DevMode/Scenery_Editor/The_Scenery_Editor/#contents_list">The Scenery Contents List</a></p></td><td>String</td><td>No</td></tr><tr class="even"><td><p><code>parentGroupID</code></p></td><td><p>The ID of the parent group this object belongs to.</p><p><strong>NOTE</strong>: this is only used for ordering in the <a href="../../../2_DevMode/Scenery_Editor/The_Scenery_Editor/#contents_list">The Scenery Contents List</a></p></td><td>Integer</td><td>No</td></tr><tr class="odd"><td><p><code>groupIndex</code></p></td><td><p>The group index of the object.</p><p><strong>NOTE</strong>: this is only used for ordering in the <a href="../../../2_DevMode/Scenery_Editor/The_Scenery_Editor/#contents_list">The Scenery Contents List</a></p></td><td>Integer</td><td>No</td></tr><tr class="even"><td><code>priority</code></td><td>This option sets the <strong>render priority</strong> for the projected mesh object. The default render priority is 0, which for most cases is fine. However, if you have overlapping meshes and want one to render over another one, then you will need to change this value to make it a higher or lower priority. Higher priority values will render <em>over</em> lower priorities, for example, a mesh with priority 1 will render over one with priority 0, which in turn will render over one with priority -1. Note that <strong>the engine cannot guarantee the render order for meshes with the <em>same</em> priority</strong>, so if you need something to always render over or under something else, you need to set this value.</td><td>Integer</td><td>No</td></tr><tr class="odd"><td><code>drawOrder</code></td><td><p>This option permits you to place meshes into the render hierarchy so that they are drawn under or over different elements. To use this attribute, you must supply one of the given strings, and the projectd mesh will be rendered after the given element has been rendered but <em>before</em> the next element (the element strings are listed in render order). For example, if you select "MARKING", then the projected mesh will be rendered over Aprons, Taxiways and Runways, but under Markings, Runway Markings and Marking Text.</p></td><td><p>String (listed in order of rendering):</p><ol><li>"APRON"</li><li>"TAXIWAY"</li><li>"RUNWAY"</li><li>"MARKING"</li><li>"RUNWAY_MARKING"</li><li>"MARKING_TEXT"</li></ol></td><td>No</td></tr><tr class="even"><td><code>surface</code></td><td>This option permits you to select from a list of default surface types that can be applied to the projected mesh. These surfaces will be merged with the mesh texture to add further visual variety and better integrate the mesh with the terrain and surrounding elements.</td><td></td><td>No</td></tr><tr class="odd"><td><code>groundMerging</code></td><td>Set this attribute to "TRUE" to have the projected mesh object be merged with the underlying ground, or set it to "FALSE" otherwise. You can see a visual example of this effect here: <a href="../../../2_DevMode/Scenery_Editor/Objects/ProjectedMesh_Objects/#ground_merging">Ground Merging</a></td><td>Boolean</td><td>No</td></tr></tbody></table>

 

 

### &lt;Tree /&gt;

 

The element has the following attributes:

 

<table><thead><tr class="header"><th>Attribute</th><th>Description</th><th>Type</th><th>Required</th></tr></thead><tbody><tr class="odd"><td><p><code>displayName</code></p></td><td><p>The display name for the object in the Scenery Editor.</p><p><strong>NOTE</strong>: this is only used for ordering in the <a href="../../../2_DevMode/Scenery_Editor/The_Scenery_Editor/#contents_list">The Scenery Contents List</a></p></td><td>String</td><td>No</td></tr><tr class="even"><td><p><code>parentGroupID</code></p></td><td><p>The ID of the parent group this object belongs to.</p><p><strong>NOTE</strong>: this is only used for ordering in the <a href="../../../2_DevMode/Scenery_Editor/The_Scenery_Editor/#contents_list">The Scenery Contents List</a></p></td><td>Integer</td><td>No</td></tr><tr class="odd"><td><p><code>groupIndex</code></p></td><td><p>The group index of the object.</p><p><strong>NOTE</strong>: this is only used for ordering in the <a href="../../../2_DevMode/Scenery_Editor/The_Scenery_Editor/#contents_list">The Scenery Contents List</a></p></td><td>Integer</td><td>No</td></tr><tr class="even"><td><code>specieName</code></td><td>The name of the tree species being placed. There is no set list of species available as it will depend on the packages installed, however you can find a list from the Scenery Editor by checking the <a href="../../../2_DevMode/Scenery_Editor/Objects/Tree_Objects.htm">Tree Objects</a>.</td><td>String</td><td>Yes</td></tr><tr class="odd"><td><code>modelGUID</code></td><td>The GUID of the tree model to use.</td><td>GUID</td><td>Yes</td></tr><tr class="even"><td><code>lat</code></td><td>Latitude of the tree object, in degrees between -90.0° and 90.0°.</td><td><p>Float</p></td><td>No</td></tr><tr class="odd"><td><code>lon</code></td><td>Longitude of the tree object, in degrees between -180.0° and 180.0°.</td><td>Float</td><td>No</td></tr><tr class="even"><td><code>altitude</code></td><td>Altitude of the treee object, in <a href="#" class="glossterm">ft</a>.</td><td>Float</td><td>False</td></tr><tr class="odd"><td><code>heading</code></td><td>The tree heading, in degrees, used to adjust the tree rotation.</td><td>Float</td><td>False</td></tr><tr class="even"><td><code>scale</code></td><td>The tree scale, where 1 is the default value.</td><td>Float</td><td>False</td></tr><tr class="odd"><td><code>snapToGround</code></td><td>This option will "snap" the tree to the ground so that - regardless of the terrain height - the element will always be at ground level.</td><td>Bool</td><td>False</td></tr></tbody></table>

 

 

### &lt;VectorPlacement&gt;

This element 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... It can be used as a general scenery element, or within an `<Airport>` element.

 

This element requires at *least* two `<Vertex />` sub-elements to define the points between which instances of the given model will be placed, as well as one or more `<Model />` sub-elements to define the models that are used.

{{< callout context="note" title="NOTE" icon="outline/bulb" >}}

This element replaces the deprecated `<BoundaryFence>` and `<BlastFence>` elements.

{{< /callout >}}

 

The element has the following parameters:

 

<table><thead><tr class="header"><th>Attribute</th><th>Description</th><th>Type</th><th>Required</th></tr></thead><tbody><tr class="odd"><td><p><code>displayName</code></p></td><td><p>The display name for the object in the Scenery Editor.</p><p><strong>NOTE</strong>: this is only used for ordering in the <a href="../../../2_DevMode/Scenery_Editor/The_Scenery_Editor/#contents_list">The Scenery Contents List</a></p></td><td>String</td><td>No</td></tr><tr class="even"><td><p><code>parentGroupID</code></p></td><td><p>The ID of the parent group this object belongs to.</p><p><strong>NOTE</strong>: this is only used for ordering in the <a href="../../../2_DevMode/Scenery_Editor/The_Scenery_Editor/#contents_list">The Scenery Contents List</a></p></td><td>Integer</td><td>No</td></tr><tr class="odd"><td><p><code>groupIndex</code></p></td><td><p>The group index of the object.</p><p><strong>NOTE</strong>: this is only used for ordering in the <a href="../../../2_DevMode/Scenery_Editor/The_Scenery_Editor/#contents_list">The Scenery Contents List</a></p></td><td>Integer</td><td>No</td></tr><tr class="even"><td><code>instanceId</code></td><td>The unique <a href="../Airports_And_Facilities/Airport_XML_Properties/#" class="glossterm">GUID</a> for this instance of the vector placement object.</td><td>String</td><td>No</td></tr><tr class="odd"><td><code>profile</code></td><td>This is the <a href="../Airports_And_Facilities/Airport_XML_Properties/#" class="glossterm">GUID</a> of the model that will be used to populate the vector path.</td><td><p>String</p></td><td>Yes</td></tr><tr class="even"><td><code>snapToVertices</code></td><td>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".</td><td>Bool</td><td>No</td></tr><tr class="odd"><td><code>spacing</code></td><td>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.</td><td>Float</td><td>Yes</td></tr><tr class="even"><td><code>heading</code></td><td>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 <code>rotation</code> attribute is set to "Follow edge" or "Random", and an absolute orientation if the attribute is "Same".</td><td>Float</td><td>Yes</td></tr><tr class="odd"><td><code>scale</code></td><td>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 cumulative with the scale applied if the <code>scaleDelta</code> option is greater than 0.</td><td>Float</td><td>Yes</td></tr><tr class="even"><td><code>scaleDelta</code></td><td>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 <code>scale</code> setting.</td><td>Float</td><td>Yes</td></tr><tr class="odd"><td><code>rotation</code></td><td><p>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:</p><ul><li><code>"Follow edge"</code>: The models will be orientated relative to the direction of the vector path it follows</li><li><code>"Same"</code>: All the models will be orientated in the same, single direction, which can be edited using the <code>heading</code> parameter.</li><li><code>"Random"</code>: Each model will be given it's own random orientation regardless of the position it occupies along the vector path.</li></ul></td><td>String</td><td>Yes</td></tr><tr class="even"><td><code>avoidDiscontinuity</code></td><td>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.</td><td>Bool</td><td>Yes</td></tr><tr class="odd"><td><code>castShadow</code></td><td>If this attribute is set to "TRUE" the models used will cast a shadow, and if set to "FALSE" they won't.</td><td>Bool</td><td>No</td></tr><tr class="even"><td><code>forcedAltitude</code></td><td>If this attribute is set to "TRUE", it will force the vector placement models to be snapped to the altitude of the object, rather than the ground.</td><td>Float</td><td>No</td></tr></tbody></table>

 

 

#### &lt;Model /&gt;

This sub-element is used to define a model to be used by the parent element object. It can be used in the following object elements:

1.  `<VectorPlacement>`
2.  `<BlastFence>`
3.  `<BoundaryFence>`

 

It is a self-closing element with the following attributes:

 

{{< table-wrapper >}}

| Attribute     | Description                                                                                                                                                                  | Type   | Required |
|---------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------|:--------:|
| `modelGUID`   | The unique [GUID](../airports-and-facilities/airport-xml-properties/#) of the model that is to be used for the vector placement object.      | String |    Yes   |
| `probability` | This is only used when more than one `<Model>` element has been defined, and sets the probability (between 0 and 1) for the model to be used by the vector placement object. | Float  |    No    |

{{< /table-wrapper >}}