ships.Function.effectiveHitPoints

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

Function: effectiveHitPoints()

effectiveHitPoints(total, resistances): DamageTypeValues

Defined in: src/ships/resistances.ts:164

How much raw damage of each type a pool of hit points can soak — total / (1 − resistance).

Parameters

total

number

The pool, in whatever unit it is measured: hull points for armour, megajoules for shields.

resistances

DamageTypeValues

The effective resistances the pool sits behind, already stacked.

Returns

DamageTypeValues

The effective hit points per damage type, in the same unit as total, and Infinity at or above 100% — nothing of that type gets through, and a resistance past the documented (-∞, 1] range never reports a negative pool.

Remarks

A negative resistance is a weakness and reports fewer effective hit points than the pool holds, which is the point: lightweight alloy soaks less kinetic damage than its hull points suggest.

Example

import { effectiveHitPoints } from '@elite-dangerous-almanac/core/ships/resistances';

// 945 hull points behind lightweight alloy's -20% kinetic
effectiveHitPoints(945, { kinetic: -0.2, thermal: 0, explosive: -0.4, caustic: 0 })
    .kinetic; // -> 787.5