MCTUtils 1.0.1

MCTUtils

A Core library for the MCTUtils .NET toolkit — geographic utilities, airspeed conversion, Lua table parsing, and shared types for flight simulation tooling.

This library is NOT suitable for use in software involved with the planning, execution or analysis or real-world military or civilian operations.

dotnet add package MCTUtils

Namespaces

MCTUtils
├── Airspeed      Airspeed conversion (IAS, CAS, EAS, TAS, Mach, GS), METAR parsing
├── Extensions    Extension methods: TruncateTo, SelectRandom, FirstCharToUpper, Enum helpers
├── Geo           Angle/unit conversion, barycentric, distance, FuelType
├── Lua           Lua table → JSON conversion
├── Utilities     File name sanitizer, NATO phonetics, GPX navaid parser
└── Internal.Geo  BasicCoordinate, BarryPoint

MCTUtils.Extensions

Extension and utility methods on string, double, List<T>, and Enum — available by importing the MCTUtils namespace.

MCTExtensions (static)

Extension methods:

Enum utility methods:

Constraints: T must be struct, Enum on FromString<T>.

using MCTUtils;
using System.ComponentModel.DataAnnotations;

// TruncateTo — no rounding
double precise = 3.1415926535;
double short = precise.TruncateTo(4);   // 3.1415
double whole = precise.TruncateTo(0);   // 3.0

// FirstCharToUpper
string name = "viper".FirstCharToUpper();  // "Viper"

// SelectRandom — no replacement
var flights = new List<string> { "Viper 1", "Viper 2", "Viper 3", "Viper 4" };
List<string> selected = flights.SelectRandom(2);  // e.g. ["Viper 2", "Viper 4"]

// Enum display name — uses [Display(Name = "...")]
enum MissionType { [Display(Name = "CAP")] Cap, [Display(Name = "SEAD")] Sead }
string display = MCTExtensions.ToString(MissionType.Cap);  // "CAP"
MissionType parsed = MCTExtensions.FromString<MissionType>("SEAD");  // MissionType.Sead

MCTUtils.Airspeed

AirspeedConverter (static)

Advanced airspeed conversions with atmospheric corrections from METAR data.

MetarData (class)

Parsed METAR weather data.

MetarParser (static)

AtmosphereState (class)

Atmospheric conditions at a given altitude.

Airspeed Example

using MCTUtils.Airspeed;

// IAS → TAS at altitude
double tas = AirspeedConverter.IASToTAS(250.0, altitudeMeters: 3000);

// With METAR
var metar = MetarParser.Parse("EGLL 151220Z 18015KT 9999 ...");
double mach = AirspeedConverter.TASToMach(420.0, altitudeMeters: 8000, metar);

// Pressure/density altitude
var (pressureAlt, densityAlt) = AirspeedConverter.GetAltitudes(3000, metar);

// TAS → GS with wind
double gs = AirspeedConverter.TASToGS(450.0, headingDeg: 270,
    windSpeedKnots: 25, windDirDeg: 180);

MCTUtils.Geo

AnglesAndMeasurements (static)

Angle, distance, and unit conversion utilities.

FuelType (enum)

MCTUtils.Lua

LuaTableToJson (static)

Converts Lua serialised tables (DCS mission/warehouse files) to JSON. Array detection: consecutive integer keys starting at 1 → JSON array; other keys → JSON object.

LuaParseException (class)

Thrown on malformed Lua input.

Lua Example

using MCTUtils.Lua;

string lua = "{ name = \"F-16CM\", weapons = { \"AIM-120\", \"AIM-9\" } }";
string json = LuaTableToJson.Convert(lua);
// {"name":"F-16CM","weapons":["AIM-120","AIM-9"]}

MCTUtils.Internal.Geo

IBasicCoordinate (interface)

BasicCoordinate (class, implements IBasicCoordinate)

BarryPoint (class)

Barycentric coordinates within a triangle.

MCTUtils.Utilities

CommonUtilities (static)

Constraints: TEnum must be struct, Enum on both methods.

Phonetics (static)

NATO phonetic alphabet lookups.

GpxNavaidParser (static)

Parses GPX navaid files from navaid.com.

GPXNavaid (class)

GPXNavaidType (enum)

Unknown, Airport, Heliport, Platform, Waypoint, RepPt, MilRepPt,
MilWaypoint, RNAVWaypoint, NRSWaypoint, VFRWaypoint, CNF,
VOR, VORDME, VORTAC, TACAN, DME, NDB, NDBDME, VOT, Radar

GPXNavaidFrequency (class)

GPXRunway (class)

GPXRunwayPosition (class)

GPXFixDefinition (class)

Dependencies

NuGet Packages