@fboes/aerofly-custom-missions 1.2.0 → 1.2.2

package/src/index.ts

@@ -25,7 +25,17 @@ export type AeroflyMissionPosition = {
 /**
  * State of aircraft systems. Configures power settings, flap positions etc
  */
-export type AeroflyMissionSetting = "taxi" | "takeoff" | "cruise" | "approach" | "landing" | "winch_launch" | "aerotow";
+export type AeroflyMissionSetting =
+    | "cold_and_dark"
+    | "before_start"
+    | "taxi"
+    | "takeoff"
+    | "cruise"
+    | "approach"
+    | "landing"
+    | "winch_launch"
+    | "aerotow"
+    | "pushback";
 
 /**
  * Types of checkpoints. Required are usually "origin", "departure_runway" at the start and "destination_runway", "destination" at the end.
@@ -69,6 +79,42 @@ export type AeroflyMissionConditionsWind = {
  */
 export type AeroflyMissionConditionsCloudCoverCode = "CLR" | "FEW" | "SCT" | "BKN" | "OVC";
 
+export class AeroflyConfigFileSet {
+    #indent: number;
+    elements: string[];
+
+    constructor(indent: number, type: string, name: string, value: string = "") {
+        this.#indent = indent;
+        this.elements = [`${this.indent}<[${type}][${name}][${value}]`];
+    }
+
+    get indent(): string {
+        return "    ".repeat(this.#indent);
+    }
+
+    push(type: string, name: string, value: string | number | string[] | number[] | boolean, comment: string = "") {
+        if (value instanceof Array) {
+            value = value.join(" ");
+        } else if (typeof value === "boolean") {
+            value = value ? "true" : "false";
+        }
+        let tag = `${this.indent}    <[${type}][${name}][${value}]>`;
+        if (comment) {
+            tag += ` // ${comment}`;
+        }
+        return this.pushRaw(tag);
+    }
+
+    pushRaw(s: string) {
+        this.elements.push(s);
+        return this;
+    }
+
+    toString() {
+        return this.elements.join("\n") + "\n" + `${this.indent}>`;
+    }
+}
+
 /**
  * @class
  * A list of flight plans.
@@ -95,7 +141,8 @@ export class AeroflyMissionsList {
      */
     toString(): string {
         const separator = "\n// -----------------------------------------------------------------------------\n";
-        return `<[file][][]
+        return `\
+<[file][][]
     <[tmmissions_list][][]
         <[list_tmmission_definition][missions][]${separator + this.missions.join(separator) + separator}        >
     >
@@ -112,7 +159,10 @@ export class AeroflyMissionsList {
  * for this file via the `toString()` method.
  */
 export class AeroflyMission {
-    // tutorial_name
+    /**
+     * @property {?string} tutorialName will create a link to a tutorial page at https://www.aerofly.com/aircraft-tutorials/
+     */
+    tutorialName: string | null;
 
     /**
      * @property {string} title of this flight plan
@@ -135,17 +185,17 @@ export class AeroflyMission {
     tags: string[];
 
     /**
-     * @property {boolean} isFeatured makes this mission pop up in "Challenges"
+     * @property {?boolean} isFeatured makes this mission pop up in "Challenges"
      */
-    isFeatured: boolean;
+    isFeatured: boolean | null;
 
     /**
-     * @property {number|undefined} difficulty values between 0.00 and 2.00 have been encountered, but they seem to be without limit
+     * @property {?number} difficulty values between 0.00 and 2.00 have been encountered, but they seem to be without limit
      */
-    difficulty: number | undefined;
+    difficulty: number | null;
 
     /**
-     * @property {"taxi"|"takeoff"|"cruise"|"approach"|"landing"|"winch_launch"|"aerotow"} flightSetting of aircraft, like "taxi", "cruise"
+     * @property {"cold_and_dark"|"before_start"|"taxi"|"takeoff"|"cruise"|"approach"|"landing"|"winch_launch"|"aerotow"|"pushback"} flightSetting of aircraft, like "taxi", "cruise"
      */
     flightSetting: AeroflyMissionSetting;
 
@@ -170,14 +220,19 @@ export class AeroflyMission {
     destination: AeroflyMissionPosition;
 
     /**
-     * @property {number} in meters
+     * @property {?number} distance in meters
+     */
+    distance: number | null;
+
+    /**
+     * @property {?number} duration in seconds
      */
-    distance: number;
+    duration: number | null;
 
     /**
-     * @property {number} in seconds
+     * @property {?boolean} isScheduled marks this flight as "Scheduled flight".
      */
-    duration: number;
+    isScheduled: boolean | null;
 
     /**
      * @property {?AeroflyMissionTargetPlane} finish as finish condition
@@ -199,16 +254,18 @@ export class AeroflyMission {
      * @param {object} [additionalAttributes] allows to set additional attributes on creation
      * @param {string} [additionalAttributes.description] text, mission briefing, etc
      * @param {AeroflyLocalizedText[]} [additionalAttributes.localizedTexts] translations for title and description
+     * @param {?string} [additionalAttributes.tutorialName] will create a link to a tutorial page at https://www.aerofly.com/aircraft-tutorials/
      * @param {string[]} [additionalAttributes.tags]
-     * @param {boolean} [additionalAttributes.isFeatured] makes this mission pop up in "Challenges"
-     * @param {number|undefined} [additionalAttributes.difficulty] values between 0.00 and 2.00 have been encountered, but they seem to be without limit
-     * @param {"taxi"|"takeoff"|"cruise"|"approach"|"landing"|"winch_launch"|"aerotow"} [additionalAttributes.flightSetting] of aircraft, like "taxi", "cruise"
+     * @param {?boolean} [additionalAttributes.isFeatured] makes this mission pop up in "Challenges"
+     * @param {?number} [additionalAttributes.difficulty] values between 0.00 and 2.00 have been encountered, but they seem to be without limit
+     * @param {"cold_and_dark"|"before_start"|"taxi"|"takeoff"|"cruise"|"approach"|"landing"|"winch_launch"|"aerotow"|"pushback"} [additionalAttributes.flightSetting] of aircraft, like "taxi", "cruise"
      * @param {{name:string,livery:string,icao:string}} [additionalAttributes.aircraft] for this mission
      * @param {string} [additionalAttributes.callsign] of aircraft, uppercased
      * @param {object} [additionalAttributes.origin] position of aircraft, as well as name of starting airport. Position does not have match airport.
      * @param {object} [additionalAttributes.destination] position of aircraft, as well as name of destination airport. Position does not have match airport.
-     * @param {number} [additionalAttributes.distance] in meters
-     * @param {number} [additionalAttributes.duration] in seconds
+     * @param {?number} [additionalAttributes.distance] in meters
+     * @param {?number} [additionalAttributes.duration] in seconds
+     * @param {?boolean} [additionalAttributes.isScheduled] marks this flight as "Scheduled flight".
      * @param {?AeroflyMissionTargetPlane} [additionalAttributes.finish] as finish condition
      * @param {AeroflyMissionConditions} [additionalAttributes.conditions] like time and weather for mission
      * @param {AeroflyMissionCheckpoint[]} [additionalAttributes.checkpoints] form the actual flight plan
@@ -216,11 +273,12 @@ export class AeroflyMission {
     constructor(
         title: string,
         {
+            tutorialName = null,
             description = "",
             localizedTexts = [],
             tags = [],
-            isFeatured = false,
-            difficulty = undefined,
+            isFeatured = null,
+            difficulty = null,
             flightSetting = "taxi",
             aircraft = {
                 name: "c172",
@@ -242,29 +300,33 @@ export class AeroflyMission {
                 dir: 0,
                 alt: 0,
             },
-            distance = 0,
-            duration = 0,
+            distance = null,
+            duration = null,
+            isScheduled = null,
             finish = null,
             conditions = new AeroflyMissionConditions(),
             checkpoints = [],
         }: {
+            tutorialName?: string | null;
             description?: string;
             localizedTexts?: AeroflyLocalizedText[];
             tags?: string[];
-            isFeatured?: boolean;
-            difficulty?: number | undefined;
+            isFeatured?: boolean | null;
+            difficulty?: number | null;
             flightSetting?: AeroflyMissionSetting;
             aircraft?: AeroflyMissionAircraft;
             callsign?: string;
             origin?: AeroflyMissionPosition;
             destination?: AeroflyMissionPosition;
-            distance?: number;
-            duration?: number;
+            distance?: number | null;
+            duration?: number | null;
+            isScheduled?: boolean | null;
             finish?: AeroflyMissionTargetPlane | null;
             conditions?: AeroflyMissionConditions;
             checkpoints?: AeroflyMissionCheckpoint[];
         } = {},
     ) {
+        this.tutorialName = tutorialName;
         this.title = title;
         this.checkpoints = checkpoints;
         this.description = description;
@@ -279,6 +341,7 @@ export class AeroflyMission {
         this.destination = destination;
         this.distance = distance;
         this.duration = duration;
+        this.isScheduled = isScheduled;
         this.finish = finish;
         this.conditions = conditions;
     }
@@ -310,10 +373,6 @@ export class AeroflyMission {
      * @returns {string} to use in Aerofly FS4's `custom_missions_user.tmc`
      */
     toString(): string {
-        if (this.checkpoints.length < 2) {
-            throw Error("this.checkpoints.length < 2");
-        }
-
         if (!this.origin.icao) {
             const firstCheckpoint = this.checkpoints[0];
             this.origin = {
@@ -336,60 +395,79 @@ export class AeroflyMission {
             };
         }
 
-        const optionalProperties = [];
+        const fileSet = new AeroflyConfigFileSet(3, "tmmission_definition", "mission");
+        fileSet.push("string8", "title", this.title);
+        fileSet.push("string8", "description", this.description);
+
+        if (this.tutorialName !== null) {
+            fileSet.push(
+                "string8",
+                "tutorial_name",
+                this.tutorialName,
+                `Opens https://www.aerofly.com/aircraft-tutorials/${this.tutorialName}`,
+            );
+        }
         if (this.localizedTexts.length > 0) {
-            optionalProperties.push(`                <[list_tmmission_definition_localized][localized_text][]
-${this.getLocalizedTextsString()}
-                >`);
+            fileSet.pushRaw(
+                new AeroflyConfigFileSet(4, "list_tmmission_definition_localized", "localized_text")
+                    .pushRaw(this.getLocalizedTextsString())
+                    .toString(),
+            );
         }
         if (this.tags.length > 0) {
-            optionalProperties.push(`                <[string8u][tags][ ${this.tags.join(" ")} ]>`);
+            fileSet.push("string8u", "tags", this.tags.join(" "));
         }
-        if (this.difficulty !== undefined) {
-            optionalProperties.push(`                <[float64]   [difficulty]         [${this.difficulty}]>`);
+        if (this.difficulty !== null) {
+            fileSet.push("float64", "difficulty", this.difficulty);
         }
-        if (this.isFeatured) {
-            optionalProperties.push(
-                `                <[bool]      [is_featured]        [${this.isFeatured ? "true" : "false"}]>`,
-            );
+        if (this.isFeatured !== null) {
+            fileSet.push("bool", "is_featured", this.isFeatured);
         }
 
-        const moreOptionalProperties = [];
-        if (this.distance) {
-            moreOptionalProperties.push(
-                `                <[float64]   [distance]           [${this.distance}]> // ${Math.ceil(this.distance / 1000)} km`,
-            );
+        fileSet.push("string8", "flight_setting", this.flightSetting);
+        fileSet.push("string8u", "aircraft_name", this.aircraft.name);
+        /*if (this.aircraft.livery) {
+            fileSet.push("string8", "aircraft_livery", this.aircraft.livery);
+        }*/
+        fileSet.push("stringt8c", "aircraft_icao", this.aircraft.icao);
+        fileSet.push("stringt8c", "callsign", this.callsign);
+        fileSet.push("stringt8c", "origin_icao", this.origin.icao);
+        fileSet.push("tmvector2d", "origin_lon_lat", [this.origin.longitude, this.origin.latitude]);
+        fileSet.push("float64", "origin_alt", this.origin.alt, `${Math.ceil(this.origin.alt * feetPerMeter)} ft MSL`);
+        fileSet.push("float64", "origin_dir", this.origin.dir);
+        fileSet.push("stringt8c", "destination_icao", this.destination.icao);
+        fileSet.push("tmvector2d", "destination_lon_lat", [this.destination.longitude, this.destination.latitude]);
+        fileSet.push(
+            "float64",
+            "destination_alt",
+            this.destination.alt,
+            `${Math.ceil(this.destination.alt * feetPerMeter)} ft MSL`,
+        );
+        fileSet.push("float64", "destination_dir", this.destination.dir);
+
+        if (this.distance !== null) {
+            fileSet.push("float64", "distance", this.distance, `${Math.round(this.distance / 1000)} km`);
         }
-        if (this.duration) {
-            moreOptionalProperties.push(
-                `                <[float64]   [duration]           [${this.duration}]> // ${Math.ceil(this.duration / 60)} min`,
-            );
+        if (this.duration !== null) {
+            fileSet.push("float64", "duration", this.duration, `${Math.round(this.duration / 60)} min`);
+        }
+        if (this.isScheduled !== null) {
+            fileSet.push("bool", "is_scheduled", this.isScheduled ? "true" : "false");
         }
-        if (this.finish) {
-            moreOptionalProperties.push(this.finish.toString());
+        if (this.finish !== null) {
+            fileSet.pushRaw(this.finish.toString());
         }
 
-        return `            <[tmmission_definition][mission][]
-                <[string8][title][${this.title}]>
-                <[string8][description][${this.description}]>${optionalProperties.length > 0 ? "\n" + optionalProperties.join("\n") : ""}
-                <[string8]   [flight_setting]     [${this.flightSetting}]>
-                <[string8u]  [aircraft_name]      [${this.aircraft.name}]>
-                //<[string8u][aircraft_livery]    [${this.aircraft.livery}]>
-                <[stringt8c] [aircraft_icao]      [${this.aircraft.icao}]>
-                <[stringt8c] [callsign]           [${this.callsign}]>
-                <[stringt8c] [origin_icao]        [${this.origin.icao}]>
-                <[tmvector2d][origin_lon_lat]     [${this.origin.longitude} ${this.origin.latitude}]>
-                <[float64]   [origin_alt]         [${this.origin.alt}]> // ${Math.ceil(this.origin.alt * feetPerMeter)} ft MSL
-                <[float64]   [origin_dir]         [${this.origin.dir}]>
-                <[stringt8c] [destination_icao]   [${this.destination.icao}]>
-                <[tmvector2d][destination_lon_lat][${this.destination.longitude} ${this.destination.latitude}]>
-                <[float64]   [destination_alt]    [${this.destination.alt}]> // ${Math.ceil(this.destination.alt * feetPerMeter)} ft MSL
-                <[float64]   [destination_dir]    [${this.destination.dir}]>${moreOptionalProperties.length > 0 ? "\n" + moreOptionalProperties.join("\n") : ""}
-${this.conditions}
-                <[list_tmmission_checkpoint][checkpoints][]
-${this.getCheckpointsString()}
-                >
-            >`;
+        fileSet.pushRaw(this.conditions.toString());
+        if (this.checkpoints.length > 0) {
+            fileSet.pushRaw(
+                new AeroflyConfigFileSet(4, "list_tmmission_checkpoint", "checkpoints")
+                    .pushRaw(this.getCheckpointsString())
+                    .toString(),
+            );
+        }
+
+        return fileSet.toString();
     }
 }
 
@@ -441,8 +519,8 @@ export class AeroflyMissionConditions {
      * @param {number} [additionalAttributes.turbulenceStrength] 0..1, percentage
      * @param {number} [additionalAttributes.thermalStrength] 0..1, percentage
      * @param {number} [additionalAttributes.visibility] in meters
-     * @param {number?} [additionalAttributes.visibility_sm] in statute miles, will overwrite visibility
-     * @param {number?} [additionalAttributes.temperature] in °C, will overwrite thermalStrength
+     * @param {?number} [additionalAttributes.visibility_sm] in statute miles, will overwrite visibility
+     * @param {?number} [additionalAttributes.temperature] in °C, will overwrite thermalStrength
      * @param {AeroflyMissionConditionsCloud[]} [additionalAttributes.clouds] for the whole flight
      */
     constructor({
@@ -554,21 +632,23 @@ export class AeroflyMissionConditions {
             this.clouds = [new AeroflyMissionConditionsCloud(0, 0)];
         }
 
-        return `                <[tmmission_conditions][conditions][]
-                    <[tm_time_utc][time][]
-                        <[int32][time_year][${this.time.getUTCFullYear()}]>
-                        <[int32][time_month][${this.time.getUTCMonth() + 1}]>
-                        <[int32][time_day][${this.time.getUTCDate()}]>
-                        <[float64][time_hours][${this.time_hours}]> // ${this.time_presentational} UTC
-                    >
-                    <[float64][wind_direction][${this.wind.direction}]>
-                    <[float64][wind_speed][${this.wind.speed}]> // kts
-                    <[float64][wind_gusts][${this.wind.gusts}]> // kts
-                    <[float64][turbulence_strength][${this.turbulenceStrength}]>
-                    <[float64][thermal_strength][${this.thermalStrength}]> // ${this.temperature} °C
-                    <[float64][visibility][${this.visibility}]> // ${this.visibility_sm} SM
-${this.getCloudsString()}
-                >`;
+        return new AeroflyConfigFileSet(4, "tmmission_conditions", "conditions")
+            .pushRaw(
+                new AeroflyConfigFileSet(5, "tm_time_utc", "time")
+                    .push("int32", "time_year", this.time.getUTCFullYear())
+                    .push("int32", "time_month", this.time.getUTCMonth() + 1)
+                    .push("int32", "time_day", this.time.getUTCDate())
+                    .push("float64", "time_hours", this.time_hours, `${this.time_presentational} UTC`)
+                    .toString(),
+            )
+            .push("float64", "wind_direction", this.wind.direction)
+            .push("float64", "wind_speed", this.wind.speed, "kts")
+            .push("float64", "wind_gusts", this.wind.gusts, "kts")
+            .push("float64", "turbulence_strength", this.turbulenceStrength)
+            .push("float64", "thermal_strength", this.thermalStrength, `${this.temperature} °C`)
+            .push("float64", "visibility", this.visibility, `${this.visibility_sm} SM`)
+            .pushRaw(this.getCloudsString())
+            .toString();
     }
 }
 
@@ -644,19 +724,25 @@ export class AeroflyMissionConditionsCloud {
      * @returns {string} to use in Aerofly FS4's `custom_missions_user.tmc`
      */
     toString(index: number = 0): string {
-        let indexString = "cloud";
-
-        switch (index) {
-            case 1:
-                indexString = "cirrus";
-                break;
-            case 2:
-                indexString = "cumulus_mediocris";
-                break;
-        }
+        const getIndexString = (index: number) => {
+            switch (index) {
+                case 0:
+                    return "cloud";
+                case 1:
+                    return "cirrus";
+                case 2:
+                    return "cumulus_mediocris";
+                default:
+                    return "more_clouds";
+            }
+        };
+
+        const indexString = getIndexString(index);
+        const comment = index > 1 ? '//' : '';
 
-        return `                    <[float64][${indexString}_cover][${this.cover ?? 0}]> // ${this.cover_code}
-                    <[float64][${indexString}_base][${this.base}]> // ${this.base_feet} ft AGL`;
+        return `\
+                    ${comment}<[float64][${indexString}_cover][${this.cover ?? 0}]> // ${this.cover_code}
+                    ${comment}<[float64][${indexString}_base][${this.base}]> // ${this.base_feet} ft AGL`;
     }
 }
 
@@ -700,6 +786,13 @@ export class AeroflyMissionCheckpoint {
      */
     altitude: number;
 
+    /**
+     * @property {?boolean} altitudeConstraint The altitude given in `altitude`
+     *    will be interpreted as mandatory flight plan altitude instead of
+     *    suggestion.
+     */
+    altitudeConstraint: boolean | null;
+
     /**
      * @property {?number} direction of runway, in degree
      */
@@ -721,9 +814,9 @@ export class AeroflyMissionCheckpoint {
     frequency: number | null;
 
     /**
-     * @property {boolean|undefined} flyOver if waypoint is meant to be flown over
+     * @property {?boolean} flyOver if waypoint is meant to be flown over
      */
-    flyOver: boolean | undefined;
+    flyOver: boolean | null;
 
     /**
      * @param {string} name ICAO code for airport, runway designator, navaid
@@ -738,14 +831,17 @@ export class AeroflyMissionCheckpoint {
      * @param {object} additionalAttributes allows to set additional attributes on creation
      * @param {number} [additionalAttributes.altitude] The height in meters above or below the WGS
      *    84 reference ellipsoid
-     * @param {number?} [additionalAttributes.altitude_feet] The height in feet above or below the WGS
+     * @param {?number} [additionalAttributes.altitude_feet] The height in feet above or below the WGS
      *    84 reference ellipsoid. Will overwrite altitude
-     * @param {number} [additionalAttributes.direction] of runway, in degree
-     * @param {number?} [additionalAttributes.slope] of runway
-     * @param {number?} [additionalAttributes.length] of runway, in meters
-     * @param {number?} [additionalAttributes.length_feet] of runway, in feet. Will overwrite length
-     * @param {number?} [additionalAttributes.frequency] of runways or navigational aids, in Hz; multiply by 1000 for kHz, 1_000_000 for MHz
-     * @param {boolean|undefined} [additionalAttributes.flyOver] if waypoint is meant to be flown over
+     * @param {number} [additionalAttributes.altitudeConstraint] The altitude given in `altitude`
+     *    will be interpreted as mandatory flight plan altitude instead of
+     *    suggestion.
+     * @param {boolean} [additionalAttributes.direction] of runway, in degree
+     * @param {?number} [additionalAttributes.slope] of runway
+     * @param {?number} [additionalAttributes.length] of runway, in meters
+     * @param {?number} [additionalAttributes.length_feet] of runway, in feet. Will overwrite length
+     * @param {?number} [additionalAttributes.frequency] of runways or navigational aids, in Hz; multiply by 1000 for kHz, 1_000_000 for MHz
+     * @param {?boolean} [additionalAttributes.flyOver] if waypoint is meant to be flown over
      */
     constructor(
         name: string,
@@ -755,21 +851,23 @@ export class AeroflyMissionCheckpoint {
         {
             altitude = 0,
             altitude_feet = null,
+            altitudeConstraint = null,
             direction = null,
             slope = null,
             length = null,
             length_feet = null,
             frequency = null,
-            flyOver = undefined,
+            flyOver = null,
         }: {
             altitude?: number;
             altitude_feet?: number | null;
+            altitudeConstraint?: boolean | null;
             direction?: number | null;
             slope?: number | null;
             length?: number | null;
             length_feet?: number | null;
             frequency?: number | null;
-            flyOver?: boolean | undefined;
+            flyOver?: boolean | null;
         } = {},
     ) {
         this.type = type;
@@ -777,6 +875,7 @@ export class AeroflyMissionCheckpoint {
         this.longitude = longitude;
         this.latitude = latitude;
         this.altitude = altitude;
+        this.altitudeConstraint = altitudeConstraint;
         this.direction = direction;
         this.slope = slope;
         this.length = length;
@@ -841,32 +940,35 @@ export class AeroflyMissionCheckpoint {
      * @returns {string} to use in Aerofly FS4's `custom_missions_user.tmc`
      */
     toString(index: number = 0): string {
-        const optionalProperties = [];
+        const fileSet = new AeroflyConfigFileSet(5, "tmmission_checkpoint", "element", String(index))
+            .push("string8u", "type", this.type)
+            .push("string8u", "name", this.name)
+            .push("vector2_float64", "lon_lat", [this.longitude, this.latitude])
+            .push("float64", "altitude", this.altitude, `${Math.ceil(this.altitude_feet)} ft`)
+            .push("float64", "direction", this.direction ?? (index === 0 ? -1 : 0))
+            .push("float64", "slope", this.slope ?? 0);
+
+        if (this.altitudeConstraint !== null) {
+            fileSet.push("bool", "alt_cst", this.altitudeConstraint);
+        }
         if (this.length) {
-            optionalProperties.push(
-                `                        <[float64][length][${this.length ?? 0}]> // ${Math.floor(this.length_feet)} ft`,
-            );
+            fileSet.push("float64", "length", this.length ?? 0, `${Math.floor(this.length_feet)} ft`);
         }
         if (this.frequency) {
-            optionalProperties.push(
-                `                        <[float64][frequency][${this.frequency ?? 0}]> // ${this.frequency_string}`,
-            );
+            fileSet.push("float64", "frequency", this.frequency ?? 0, `${this.frequency_string}`);
         }
-        if (this.flyOver !== undefined) {
-            optionalProperties.push(`                        <[bool][fly_over][${this.flyOver ? "true" : "false"}]>`);
+        if (this.flyOver !== null) {
+            fileSet.push("bool", "fly_over", this.flyOver);
         }
 
-        return `                    <[tmmission_checkpoint][element][${index}]
-                        <[string8u][type][${this.type}]>
-                        <[string8u][name][${this.name}]>
-                        <[vector2_float64][lon_lat][${this.longitude} ${this.latitude}]>
-                        <[float64][altitude][${this.altitude}]> // ${Math.ceil(this.altitude_feet)} ft
-                        <[float64][direction][${this.direction ?? (index === 0 ? -1 : 0)}]>
-                        <[float64][slope][${this.slope ?? 0}]>${optionalProperties.length > 0 ? "\n" + optionalProperties.join("\n") : ""}
-                    >`;
+        return fileSet.toString();
     }
 }
 
+/**
+ * @class
+ * A translation for the mission title and description.
+ */
 export class AeroflyLocalizedText {
     /**
      * @property {string} language ISO 639-1 like
@@ -923,14 +1025,18 @@ export class AeroflyLocalizedText {
      * @returns {string} to use in Aerofly FS4's `custom_missions_user.tmc`
      */
     toString(index: number = 0): string {
-        return `                   <[tmmission_definition_localized][element][${index}]
-                        <[string8u][language][${this.language}]>
-                        <[string8][title][${this.title}]>
-                        <[string8][description][${this.description}]>
-                    >`;
+        return new AeroflyConfigFileSet(4, "tmmission_definition_localized", "element", String(index))
+            .push("string8u", "language", this.language)
+            .push("string8", "title", this.title)
+            .push("string8", "description", this.description)
+            .toString();
     }
 }
 
+/**
+ * @class
+ * A target plane which the aircraft needs to cross.
+ */
 export class AeroflyMissionTargetPlane {
     /**
      * @property {number} longitude easting, using the World Geodetic
@@ -975,10 +1081,10 @@ export class AeroflyMissionTargetPlane {
     }
 
     toString(): string {
-        return `                <[tmmission_target_plane][${this.name}][]
-                    <[vector2_float64][lon_lat][${this.longitude} ${this.latitude}]>
-                    <[float64][direction][${this.dir}]>
-                >`;
+        return new AeroflyConfigFileSet(4, "tmmission_target_plane", this.name)
+            .push("vector2_float64", "lon_lat", [this.longitude, this.latitude])
+            .push("float64", "direction", this.dir)
+            .toString();
     }
 }