ships.Interface.ShieldMetrics

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

Interface: ShieldMetrics

Defined in: src/ships/shields.ts:141

A build's shield strength, where it comes from, and what it resists.

Remarks

Frozen — nested records and lists included — so a result can be held, cached and shared without a defensive copy. Derive a changed figure with a spread rather than by assigning into one.

Properties

boosters

readonly boosters: number

Defined in: src/ships/shields.ts:147

What the boosters add on top of the generator, in megajoules.

---

boostMultiplier

readonly boostMultiplier: number

Defined in: src/ships/shields.ts:160

The boosters' combined multiplier, 1 with none fitted (1.6 = +60%). 1 with no generator, whatever boosters are fitted — there is nothing for them to multiply.

---

effectiveHitPoints

readonly effectiveHitPoints: DamageTypeValues

Defined in: src/ships/shields.ts:179

Effective hit points against each damage type, in megajoules — strength / (1 − resistance), the raw damage of that type the shield can soak. Infinity where a resistance reaches 100%.

---

generator

readonly generator: number

Defined in: src/ships/shields.ts:145

The generator's own contribution, in megajoules.

---

massCurveMultiplier

readonly massCurveMultiplier: number

Defined in: src/ships/shields.ts:155

The generator's strength multiplier at this hull mass. 0 with no generator.

---

reinforcement

readonly reinforcement: number

Defined in: src/ships/shields.ts:153

What Guardian shield reinforcement packages add, in megajoules. 0 with no generator, whatever reinforcement was passed — a package has no shield to reinforce.

---

resistances

readonly resistances: DamageTypeValues

Defined in: src/ships/shields.ts:173

Effective resistances, generator and boosters stacked with diminishing returns, and the SYS pips folded in. 0 for every damage type when no generator is fitted; the pips are then reported only in ShieldMetrics.systemsResistance.

Remarks

Fractions rather than percentages, and unrounded: the stacking is floating-point arithmetic, so a nominal −20% reads as -0.19999999999999996 rather than -0.2. Round where the figure is displayed, not before it is composed further — ShieldMetrics.effectiveHitPoints is derived from exactly these values.

---

strength

readonly strength: number

Defined in: src/ships/shields.ts:143

Total shield strength, in megajoules. 0 when no generator is fitted.

---

systemsResistance

readonly systemsResistance: number

Defined in: src/ships/shields.ts:184

The extra resistance the SYS pips contribute, as a fraction — unrounded, like ShieldMetrics.resistances.