# reference_points.cfg<no value>

{{< image-center
    src="images/2_DevMode/simobject_editor/cfg/cfg_tab_17_refpoints.png"
    alt="The Reference Points Tab In The SimObject Editor" >}}

This file is *optional* and is used to define a number of **reference points** on a SimObject. These points can then be referenced in your code and used for various different purposes depending on the aircraft (for one example of use, please see the [Agricultural Aviation](../careers/agricultural-aviation/) page).

 

This file should be created in the same folder as the `sim.cfg` file or `aircraft.cfg` file that will be using it. Below you can find information on the different sections used in the `reference_points.cfg` file as well as what parameters and values are expected within them.

 

 

### [Version]

The `[Version]` section provides version information for the configuration file. In Microsoft Flight Simulator 2024, major versions should *always* be at least equal to 1.

 

Note that this section information is **mandatory** and should always be included.

 

{{< table-wrapper >}}

| Parameter | Description                                                   | Type    | Required |
|-----------|---------------------------------------------------------------|---------|:--------:|
| `major`   | Major CFG file version number, values must be greater than 0. | Integer |    Yes   |
| `minor`   | Minor CFG file version number, values must be greater than 0. | Integer |    Yes   |

{{< /table-wrapper >}}


 

 

### [ReferencePoint.*N*]

Each file can contain multiple `[ReferencePoint.N]` entries, where each one will be used to create a unique reference point, numbered from 0. Each reference point has the following parameters:

 

Parameter

Description

Type

Required

`Name`

This is the name of the reference point, which should be *unique* and contain only alpha-numeric characters and the under-bar "\_". For example:

``` codeblock
Name=pt_runway_start 
```

String

Yes

`AttachTo`

This is the name of a node that the reference point is attached to. If supplied, then the reference point position and rotation will be relative to this node rather than the SimObject root node.

String

No

`IsExterior`

When set to 1 (TRUE) the reference point is flagged as exterior only, and when set to 0 (FALSE) it is interior only. Note that this means that you cannot access an exterior reference point from any interior code, and vice-versa.

Bool

Yes

`RelativePos`

This sets the offset position of the reference point relative to the (0, 0, 0) position of the SimObject root node (or AttachTo node, if supplied). The parameter requires a comma separated table of 3 values for the X/Y/Z relative offset.

[List](cfg-files/#list) of Floats

Yes

`RelativeRot`

This sets the offset rotation of the reference point relative to the (0, 0, 0) position of the SimObject root node (or AttachTo node, if supplied). The parameter requires a comma separated table of 3 values for the X/Y/Z relative rotation.

[List](cfg-files/#list) of Floats

Yes