@fboes/aerofly-custom-missions 1.2.0 → 1.2.2

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 1.2.2
+
+- Added altitude constraint property
+- Improved handling of cloud layers
+
+## 1.2.1
+
+- Changed handling of checkpoints, as it is obviously possible to have missions without checkpoints
+- Changed actual file generation to improve programmatic adding of entries to file
+- Adding `is_scheduled` and `tutorial_name` property
+- Improved cloud handling
+- Improved handling off unset values
+- Added `cold_and_dark`, `before_start`, `pushback"` as flight setting
+
 ## 1.2.0
 
 - Adding new cloud level `cirrus_cover` / `cirrus_base`
@@ -13,7 +27,7 @@
 ## 1.1.0
 
 - Added new mission properties `tags`, `isFeatured`, `difficulty`, `distance`, `duration` and translations
-- Added new flight settings `"winch_launch`, `aerotow`
+- Added new flight settings `winch_launch`, `aerotow`
 - Improved temperature property
 
 ## 1.0.4

package/README.md

@@ -171,19 +171,14 @@ The `tags` property of a single mission can contain multiple values. The followi
   - `destination`
 - Be aware that all units for altitude, elevation or distance are measured in meters! In most cases there will be helper functions for defining these values in feet (for length, altitude, elevation) or statute miles (for visibility).
 
-There are also some unsupported properties, which are present in Aerofly FS4, but as of yet will not be generated by this library:
-
-```
-<[string8][tutorial_name][c172]> // Opens https://www.aerofly.com/aircraft-tutorials/${tutorial_name}
-<[bool][is_scheduled][true]>
-```
-
 ### Known issues
 
 - `AeroflyMissionConditions.time`: Even though a date property is available in Aerofly FS 4, [the custom missions cannot change the date in Aerofly FS 4](https://www.aerofly.com/community/forum/index.php?thread/22487-more-settings-for-environment-conditions/&pageNo=1). This is obviously as the date cannot be changed inside the simulation.
 - `AeroflyMissionConditions.clouds`: Even though Aerofly FS 4 is able to handle three levels of clouds, the custom missions can only set two levels in Aerofly FS 4. This is obviously as the third cloud layer cannot be changed inside the simulation.
 - `AeroflyMissionCheckpoint.type`: Even though internal flight plans of Aerofly FS 4 have types `"departure"|"arrival"|"approach"`, [Aerofly FS 4 dumps SIDs and STARs on loading a custom missions](https://www.aerofly.com/community/forum/index.php?thread/22156-flight-plans/).
 - `AeroflyMission.aircraft.livery`: Even though Aerofly FS 4 knows multiple liveries per plane, [the custom missions file is not able to set liveries to any other but the standard livery](https://www.aerofly.com/community/forum/index.php?thread/19105-user-created-custom-missions/).
+- `AeroflyMission.isScheduled`: Even though for regular missions this will mark these as a "Scheduled flight", [custom missions cannot be created as "Scheduled flights"](https://www.aerofly.com/community/forum/index.php?thread/23101-challenge-guides/&postID=147354#post147432).
+- `AeroflyMission.isFeatured`: Even though for regular missions this will mark these as a featured missions, custom missions cannot be created as featured missions.
 
 ## Status
 

package/dist/index.js

@@ -1,5 +1,48 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _AeroflyConfigFileSet_indent;
 const feetPerMeter = 3.28084;
 const meterPerStatuteMile = 1609.344;
+export class AeroflyConfigFileSet {
+    constructor(indent, type, name, value = "") {
+        _AeroflyConfigFileSet_indent.set(this, void 0);
+        __classPrivateFieldSet(this, _AeroflyConfigFileSet_indent, indent, "f");
+        this.elements = [`${this.indent}<[${type}][${name}][${value}]`];
+    }
+    get indent() {
+        return "    ".repeat(__classPrivateFieldGet(this, _AeroflyConfigFileSet_indent, "f"));
+    }
+    push(type, name, value, comment = "") {
+        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) {
+        this.elements.push(s);
+        return this;
+    }
+    toString() {
+        return this.elements.join("\n") + "\n" + `${this.indent}>`;
+    }
+}
+_AeroflyConfigFileSet_indent = new WeakMap();
 /**
  * @class
  * A list of flight plans.
@@ -20,7 +63,8 @@ export class AeroflyMissionsList {
      */
     toString() {
         const separator = "\n// -----------------------------------------------------------------------------\n";
-        return `<[file][][]
+        return `\
+<[file][][]
     <[tmmissions_list][][]
         <[list_tmmission_definition][missions][]${separator + this.missions.join(separator) + separator}        >
     >
@@ -41,21 +85,23 @@ 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
      */
-    constructor(title, { description = "", localizedTexts = [], tags = [], isFeatured = false, difficulty = undefined, flightSetting = "taxi", aircraft = {
+    constructor(title, { tutorialName = null, description = "", localizedTexts = [], tags = [], isFeatured = null, difficulty = null, flightSetting = "taxi", aircraft = {
         name: "c172",
         icao: "",
         livery: "",
@@ -71,7 +117,8 @@ export class AeroflyMission {
         latitude: 0,
         dir: 0,
         alt: 0,
-    }, distance = 0, duration = 0, finish = null, conditions = new AeroflyMissionConditions(), checkpoints = [], } = {}) {
+    }, distance = null, duration = null, isScheduled = null, finish = null, conditions = new AeroflyMissionConditions(), checkpoints = [], } = {}) {
+        this.tutorialName = tutorialName;
         this.title = title;
         this.checkpoints = checkpoints;
         this.description = description;
@@ -86,6 +133,7 @@ export class AeroflyMission {
         this.destination = destination;
         this.distance = distance;
         this.duration = duration;
+        this.isScheduled = isScheduled;
         this.finish = finish;
         this.conditions = conditions;
     }
@@ -114,9 +162,6 @@ export class AeroflyMission {
      * @returns {string} to use in Aerofly FS4's `custom_missions_user.tmc`
      */
     toString() {
-        if (this.checkpoints.length < 2) {
-            throw Error("this.checkpoints.length < 2");
-        }
         if (!this.origin.icao) {
             const firstCheckpoint = this.checkpoints[0];
             this.origin = {
@@ -137,52 +182,60 @@ export class AeroflyMission {
                 alt: lastCheckpoint.altitude,
             };
         }
-        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 !== null) {
+            fileSet.push("float64", "difficulty", this.difficulty);
+        }
+        if (this.isFeatured !== null) {
+            fileSet.push("bool", "is_featured", this.isFeatured);
         }
-        if (this.difficulty !== undefined) {
-            optionalProperties.push(`                <[float64]   [difficulty]         [${this.difficulty}]>`);
+        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.isFeatured) {
-            optionalProperties.push(`                <[bool]      [is_featured]        [${this.isFeatured ? "true" : "false"}]>`);
+        if (this.duration !== null) {
+            fileSet.push("float64", "duration", this.duration, `${Math.round(this.duration / 60)} min`);
         }
-        const moreOptionalProperties = [];
-        if (this.distance) {
-            moreOptionalProperties.push(`                <[float64]   [distance]           [${this.distance}]> // ${Math.ceil(this.distance / 1000)} km`);
+        if (this.isScheduled !== null) {
+            fileSet.push("bool", "is_scheduled", this.isScheduled ? "true" : "false");
         }
-        if (this.duration) {
-            moreOptionalProperties.push(`                <[float64]   [duration]           [${this.duration}]> // ${Math.ceil(this.duration / 60)} min`);
+        if (this.finish !== null) {
+            fileSet.pushRaw(this.finish.toString());
         }
-        if (this.finish) {
-            moreOptionalProperties.push(this.finish.toString());
+        fileSet.pushRaw(this.conditions.toString());
+        if (this.checkpoints.length > 0) {
+            fileSet.pushRaw(new AeroflyConfigFileSet(4, "list_tmmission_checkpoint", "checkpoints")
+                .pushRaw(this.getCheckpointsString())
+                .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()}
-                >
-            >`;
+        return fileSet.toString();
     }
 }
 /**
@@ -202,15 +255,15 @@ 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({ time = new Date(), wind = {
         direction: 0,
         speed: 0,
         gusts: 0,
-    }, turbulenceStrength = 0, thermalStrength = 0, visibility = 25_000, visibility_sm = null, temperature = null, clouds = [], } = {}) {
+    }, turbulenceStrength = 0, thermalStrength = 0, visibility = 25000, visibility_sm = null, temperature = null, clouds = [], } = {}) {
         /**
          * @property {AeroflyMissionConditionsCloud[]} clouds for the whole flight
          */
@@ -287,21 +340,21 @@ export class AeroflyMissionConditions {
         if (this.clouds.length < 1) {
             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();
     }
 }
 /**
@@ -364,17 +417,23 @@ export class AeroflyMissionConditionsCloud {
      * @returns {string} to use in Aerofly FS4's `custom_missions_user.tmc`
      */
     toString(index = 0) {
-        let indexString = "cloud";
-        switch (index) {
-            case 1:
-                indexString = "cirrus";
-                break;
-            case 2:
-                indexString = "cumulus_mediocris";
-                break;
-        }
-        return `                    <[float64][${indexString}_cover][${this.cover ?? 0}]> // ${this.cover_code}
-                    <[float64][${indexString}_base][${this.base}]> // ${this.base_feet} ft AGL`;
+        const getIndexString = (index) => {
+            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 `\
+                    ${comment}<[float64][${indexString}_cover][${this.cover ?? 0}]> // ${this.cover_code}
+                    ${comment}<[float64][${indexString}_base][${this.base}]> // ${this.base_feet} ft AGL`;
     }
 }
 /**
@@ -399,21 +458,25 @@ 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, type, longitude, latitude, { altitude = 0, altitude_feet = null, direction = null, slope = null, length = null, length_feet = null, frequency = null, flyOver = undefined, } = {}) {
+    constructor(name, type, longitude, latitude, { altitude = 0, altitude_feet = null, altitudeConstraint = null, direction = null, slope = null, length = null, length_feet = null, frequency = null, flyOver = null, } = {}) {
         this.type = type;
         this.name = name;
         this.longitude = longitude;
         this.latitude = latitude;
         this.altitude = altitude;
+        this.altitudeConstraint = altitudeConstraint;
         this.direction = direction;
         this.slope = slope;
         this.length = length;
@@ -457,11 +520,11 @@ export class AeroflyMissionCheckpoint {
         if (!this.frequency) {
             return "None";
         }
-        if (this.frequency > 1_000_000) {
-            return String(this.frequency / 1_000_000) + " MHz";
+        if (this.frequency > 1000000) {
+            return String(this.frequency / 1000000) + " MHz";
         }
-        if (this.frequency > 1_000) {
-            return String(this.frequency / 1_000) + " kHz";
+        if (this.frequency > 1000) {
+            return String(this.frequency / 1000) + " kHz";
         }
         return String(this.frequency) + " Hz";
     }
@@ -470,26 +533,32 @@ export class AeroflyMissionCheckpoint {
      * @returns {string} to use in Aerofly FS4's `custom_missions_user.tmc`
      */
     toString(index = 0) {
-        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 {
     /**
      * @param {string} language ISO 639-1 like
@@ -518,13 +587,17 @@ export class AeroflyLocalizedText {
      * @returns {string} to use in Aerofly FS4's `custom_missions_user.tmc`
      */
     toString(index = 0) {
-        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 {
     /**
      *
@@ -544,10 +617,10 @@ export class AeroflyMissionTargetPlane {
         this.name = name;
     }
     toString() {
-        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();
     }
 }
 export default {