ships.Function.identifyPreEngineeredVariant

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

Function: identifyPreEngineeredVariant()

identifyPreEngineeredVariant(module): PreEngineeredVariant | null

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

Identify the fixed pre-engineered/reward variant described by a fitted loadout module.

Matching uses the reported post-engineering stat values rather than trusting the blueprint tuple alone: reward variants carry hand-set values that an ordinary roll of the named blueprint does not reproduce. A captured experimental effect is composed with each candidate before comparison, because some fixed articles accept an effect after purchase (the V1 frame-shift drives are the common example).

Frontier journals and captures may omit a derived modifier, so one predicted value may be absent. Every stated predicted value must agree within journal float noise, and all but at most one must be present. Ambiguous or incomplete evidence returns null rather than guessing. Variants without a published stat block cannot be identified this way.

Parameters

module

LoadoutModule

A module from a journal Loadout event or SLEF export.

Returns

PreEngineeredVariant | null

The uniquely matching catalogue variant, or null when the stats do not identify one.

Throws

If a field it reads is present and not a string — module.Item, or a modifier's Label or the block's ExperimentalEffect. A module with no engineering block answers null before any of them is read.

Example

import { identifyPreEngineeredVariant } from '@elite-dangerous-almanac/core/ships/pre-engineered-stats';
import type { LoadoutEvent } from '@elite-dangerous-almanac/core/ships/slef';

declare const loadoutEvent: LoadoutEvent;

const fitted = loadoutEvent.Modules.find((m) => m.Slot === 'FrameShiftDrive')!;
identifyPreEngineeredVariant(fitted)?.acquisition; // -> 'techBroker', or null