ships.Function.combinedRateOfFire

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

Function: combinedRateOfFire()

combinedRateOfFire(weapon): number | undefined

Defined in: src/ships/weapons.ts:261

The combined rate of fire a weapon's firing cycle implies — the journal's own RateOfFire, rebuilt from its parts.

A cycle fires burstRounds shots 1 / burstRateOfFire apart, then waits out the burstInterval before the next one. chargeTime is the delay before a shot lands, not part of the cadence Frontier reports as RateOfFire.

Parameters

weapon

WeaponStats

The weapon's stats, post-engineering.

Returns

number | undefined

Shots per second, or undefined for a continuous-fire weapon (no burstInterval) or a cycle that does not resolve to a positive time.

Remarks

Use this after engineering has moved a burst stat: a recipe that gives a weapon a two-round burst changes the rate of fire without naming it. weaponMetrics takes rateOfFire as given, so recompute it first if you have changed the parts.

Example

import { combinedRateOfFire } from '@elite-dangerous-almanac/core/ships/weapons';

// A small burst laser: three shots at 15/s, then half a second's wait
combinedRateOfFire({ burstInterval: 0.5, burstRounds: 3, burstRateOfFire: 15 }); // -> 4.74