MCTUtils 0.3.2

MCTUtils

<br />

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

dotnet add package MCTUtils

Namespaces

MCTUtils
├── Airspeed      Airspeed conversion (IAS, CAS, EAS, TAS, Mach, GS), METAR parsing
├── DCS           DCS World coordinate projection (Vec2/Vec3 → lat/lon)
├── Extensions    Extension methods: TruncateTo, SelectRandom, FirstCharToUpper
├── 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
├── Internal.DCS  Vec2, Vec3, TheatreTranslation
└── Exceptions    EventConfigurationMismatchException, MissingTheatreTranslationException, PasswordNotAcceptedException

MCTUtils.Extensions

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

MCTExtensions (static)

using MCTUtils;

// 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"]

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

DCSEnvironment (class)

Bidirectional coordinate conversion between DCS World in-game coordinates (Vec2/Vec3) and decimal-degree latitude/longitude, using theatre-specific Transverse Mercator projection parameters. Projection is configured once via the constructor and both directions are immediately available.

DCS Example

using MCTUtils.DCS;
using MCTUtils.Internal.DCS;
using Proj4Net.Core;

var env = new DCSEnvironment(new TheatreTranslation
{
    Central_meridian = 147,
    False_northing = -1491840.000000048,
    False_easting = 238417.99999989968,
    Scale_factor = 0.9996
});

// DCS → lat/lon
var coord = env.DCSVec2ToDecimalDegrees(new Vec2(13056.832576364, 10030.962119321));    // BasicCoordinate(){ Latitude=13.576672104045052, Longitude=144.91731189173802 }

// lat/lon → DCS
var dcsVec = env.DecimalDegreesToDCSVec2(new Coordinate(13.576672104045052, 144.91731189173802));   // Vec2(){ X=13056.832576364, Y=10030.962119321 }

MCTUtils.Internal.DCS

IVec2 (interface)

Vec2 (class, implements IVec2)

IVec3 (interface, extends IVec2)

Vec3 (class, extends Vec2, implements IVec3)

TheatreTranslation (class)

DCS theatre projection parameters.

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)

MCTUtils.Exceptions

Dependencies

NuGet Packages