EveShipFit.DogmaEngine 15.1.0

dotnet add package EveShipFit.DogmaEngine --version 15.1.0
                    
NuGet\Install-Package EveShipFit.DogmaEngine -Version 15.1.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="EveShipFit.DogmaEngine" Version="15.1.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="EveShipFit.DogmaEngine" Version="15.1.0" />
                    
Directory.Packages.props
<PackageReference Include="EveShipFit.DogmaEngine" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add EveShipFit.DogmaEngine --version 15.1.0
                    
#r "nuget: EveShipFit.DogmaEngine, 15.1.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package EveShipFit.DogmaEngine@15.1.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=EveShipFit.DogmaEngine&version=15.1.0
                    
Install as a Cake Addin
#tool nuget:?package=EveShipFit.DogmaEngine&version=15.1.0
                    
Install as a Cake Tool

EVEShip.fit's Dogma Engine for .NET

This library calculates accurately statistics of an EVE Online ship fit.

The input are several data-files provided by EVE Online, together with a ship fit. The output are all the Dogma attributes of the ship, its items and the character.

The engine is written in Rust; this package wraps it for .NET 8 and up, so every lookup happens inside Rust. The package carries the native library for Linux and macOS on x64 and arm64, and Windows on x64.

Install

dotnet add package EveShipFit.DogmaEngine

Usage

sde.dat and names.dat come from @eveshipfit/sde.

using EveShipFit.Dogma;

var buildNumber = DogmaEngine.LoadSde("sde.dat");

var fit = new Fit
{
    Ship = new Ship(587),
    Items = [new FitItem(2873, new Slot.High(0), State.Active, Charge: new Charge(185))],
    Character = new Character { Skills = new Dictionary<int, int> { [3300] = 5 } },
};

var calculation = DogmaEngine.Calculate(fit);
// Or if you want to know the source of the effects:
var withSources = DogmaEngine.Calculate(fit, new Options(Sources: true));
// Or if you have a beacon in space (like wormhole effects):
var withBeacon = DogmaEngine.Calculate(fit with { Incoming = DogmaEngine.Beacon(beaconTypeId) });
// Or if you have an EFT, the text format EVE copies a fit to the clipboard in (and the other way around):
var imported = DogmaEngine.Calculate(DogmaEngine.LoadEft("[Rifter, My Rifter]\n200mm AutoCannon I"));
var eft = DogmaEngine.SaveEft(fit);
// Or if you have a fitting a character saved in game, as ESI returns it (and the other way around):
var fromEsi = DogmaEngine.LoadEsiFitting(fitting);
var toEsi = DogmaEngine.SaveEsiFitting(fit);
// Or if you have DNA, the fits EVE links to in chat, with or without its `fitting:` prefix:
var fromDna = DogmaEngine.LoadDna(dna);
// EFT, ESI and DNA have no states; with the skills set, this sets the ones EVE gives an imported fit:
var settled = DogmaEngine.PostLoad(fromEsi with { Character = new Character { Skills = skills } });
// Or if you have a killmail, as ESI returns it, for the fit of the ship that died:
var fromKillmail = DogmaEngine.LoadKillmail(killmail);
// Or if you have an EVEShip.fit link, `<version>:<payload>`, with the payload gunzipped and unbase64'd:
var fromLink = DogmaEngine.LoadLink(version, payload);
// Or if you have an esf/1 document, as text or as a link (and the other way around):
var fromEsf = DogmaEngine.LoadEsf("%esf/1\nRifter\n200mm AutoCannon I\n");
var fromEsfLink = DogmaEngine.LoadEsfLink(link);
var esf = DogmaEngine.SaveEsf(fit);
var esfLink = DogmaEngine.SaveEsfLink(fit);

// What EVE would not let you fly, in `Violations` of the calculation:
var validated = DogmaEngine.Calculate(fit, new Options(Validate: true));

LoadSde may only be called once per process.

An EFT import matches the English names in sde.dat. To also match the other languages EVE supports, load names.dat as well:

DogmaEngine.LoadNames("names.dat");

A bad input throws ArgumentException; calling before LoadSde throws InvalidOperationException. Every call is thread-safe, so a thread pool calculates fits in parallel.

The types are records, but as in any C# record, a list or dictionary in one compares by reference, not by its contents.

What every field means is explained under Input and output.

Building

You need Rust and the .NET SDK. The build compiles the Rust library for your platform first:

dotnet test crates/esf-dotnet/tests

The tests read the data-files from node_modules; run npm ci in the root first, or point ESF_SDE and ESF_NAMES at them.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • net8.0

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
15.1.0 0 11/16/2026
15.0.0 48 11/12/2026
14.2.1 45 11/12/2026
14.2.0 48 11/12/2026
14.1.0 98 11/2/2026
14.0.0 103 11/1/2026