ships.Function.fuelPerJump

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

Function: fuelPerJump()

fuelPerJump(distance, mass, fuel, fsd): number

Defined in: src/ships/jump-range.ts:211

The fuel a single jump of a given distance costs, in tonnes.

Parameters

distance

number

The jump distance, in light-years. Distances beyond the singleJumpRange cost more than the tank holds — the result is capped at the drive's maxFuel.

mass

number

Total ship mass excluding fuel, in tonnes (see singleJumpRange).

fuel

number

Fuel in the tank, in tonnes — sets the mass moved and caps the burn.

fsd

FrameShiftDriveParams

The drive constants.

Returns

number

Fuel used, in tonnes, in [0, min(fuel, maxFuel)].

Remarks

This is EDSY's model: the cost scales as (distance / maxRange)^fuelPower of the tank's per-jump fuel, where maxRange is singleJumpRange for the same mass and fuel. It round-trips at the maximum jump — fuelPerJump(singleJumpRange(m, f), m, f) returns min(f, maxFuel) — and, with no Guardian FSD Booster, is the exact inverse of singleJumpRange at every distance. With a booster fitted, the booster's flat jumpBoost is treated proportionally (as EDSY does) rather than subtracted, so interior distances are a close approximation rather than the exact inverse. It matches the fuel figures EDSY reports.

Throws

If a quantity is negative or non-finite, or a required drive constant is not positive.