ships.Interface.ShieldMetrics

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

Interface: ShieldMetrics

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

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:139

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

---

boostMultiplier

readonly boostMultiplier: number

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

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:172

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:137

The generator's own contribution, in megajoules.

---

massCurveMultiplier

readonly massCurveMultiplier: number

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

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

---

reinforcement

readonly reinforcement: number

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

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:166

Effective resistances, generator and boosters stacked with diminishing returns. The SYS pips are not in these — they belong to the capacitor, and shieldCapacitorMetrics folds them in. 0 for every damage type when no generator is fitted.

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:135

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