ships.Function.getPreEngineeredStats

@elite-dangerous-almanac/core / ships / getPreEngineeredStats

Function: getPreEngineeredStats()

getPreEngineeredStats(variant): OutfittingModule | null

Defined in: src/ships/pre-engineered-stats.ts:395

A pre-engineered variant resolved into a module record you can fit.

Returns the base module's catalogue record with every stat the variant modifies — and that the catalogue carries — replaced by its engineered value. symbol, name, class, rating and cost are the base module's throughout: a pre-engineered variant is the same article with different numbers, not a different module. A final variant also carries engineeringLocked: true, so fitting the resolved article keeps that restriction. Exact damage components scale with an engineered damage value so their proportions and the anti-xeno overlay remain coherent with the resolved scalar.

A variant with no stat block (every mercenary row) resolves to a copy of the base record with nothing changed, which is the honest answer — the pre-engineering those arrive with is not published anywhere, so the catalogue does not guess at it.

Parameters

variant

PreEngineeredVariant

A pre-engineered variant.

Returns

OutfittingModule | null

The resolved module record, or null when the variant's symbol is not in the module catalogues. It is always a record of your own — never the shared catalogue singleton — so you may adjust it before fitting it; its nested values are still the catalogue's frozen ones, so replace them rather than write into them.

Example

import { getModuleBySymbol } from '@elite-dangerous-almanac/core/ships/modules';
import { getPreEngineeredVariants } from '@elite-dangerous-almanac/core/ships/pre-engineered';
import { getPreEngineeredStats } from '@elite-dangerous-almanac/core/ships/pre-engineered-stats';

const shard = getPreEngineeredVariants('Hpt_Guardian_ShardCannon_Fixed_Medium')[0]!;
const stock = getModuleBySymbol(shard.symbol)!;
const fitted = getPreEngineeredStats(shard)!;
stock.mass;  // -> 4
fitted.mass; // -> 6  (the variant carries Mass +50%)