Comp analyzer · Modules

3 modules · 19 exports · 0 repositories · 4 e2e tests · 1 route

OverviewModulesSearch params & storageE2E tests

Who imports who · hover a node

DamageCombos

app/features/comp-analyzer/core/DamageCombos.ts

Damage combos of a comp: the ways hits from different weapons (main, sub and special damages alike) add up to a splat when no single hit does. Combos are searched by backtracking over every damage the comp deals, kept lethal but not excessive, deduplicated and ordered closest to 100 damage first. Damages come from the build analyzer's stats of each weapon.

Imports

no other modules

Used by

1 route2 components

Types

interface

ExcludedDamageKey

:131

A damage of one weapon, as the user excludes it from the combos.

export interface ExcludedDamageKey {
	weaponId: MainWeaponId;
	weaponType: "main" | "sub" | "special";
	damageType: DamageType;
}

Routes/comp-analyzer

Componentscomp-analyzer/DamageComboBar.tsx

Functions & values

function

damageKeys

:138

Every damage of the comp's weapons once, the ones the user can exclude from the combos.

export function damageKeys(
	weaponIds: MainWeaponId[],
	targetSubDefenseAp = 0,
): ExcludedDamageKey[]

Componentscomp-analyzer/DamageComboBar.tsx

function

calculate

:175

The comp's damage combos, best first: lethal ones closest to 100 damage with the fewest hits. Combos span at least two weapons unless includeSingleWeaponCombos, where a weapon's main, sub and special count as separate sources.

export function calculate(
	weaponIds: MainWeaponId[],
	excludedKeys: ExcludedDamageKey[] = [],
	targetSubDefenseAp = 0,
	maxCombosDisplayed = MAX_COMBOS_DISPLAYED,
	includeSingleWeaponCombos = false,
): DamageCombo[]

Unit tests (23)

• basic combination generation › generates combos involving 2+ weapons
• basic combination generation › calculates
  • correct total damage
  • correct hit count
• constraint enforcement › respects
  • max damage types per combo constraint
  • max repeats per damage type constraint
• constraint enforcement › requires 2+ weapon slots in each combo
• threshold filtering › excludes combos below damage threshold
• threshold filtering › includes combos at or above damage threshold
• one-shot exclusion › excludes all combos containing a 100+ damage hit
• sorting › sorts results by totalDamage closest to 100 (lethal threshold)
• result cap › returns at most MAX_COMBOS_DISPLAYED results
• edge cases › returns
  • empty array for empty weapon selection
  • empty array for single weapon (cannot make cross-weapon combos)
• edge cases › same sub weapon on multiple weapons creates valid combos
• edge cases › all
  • segments have valid weapon slot assignments
  • segments have count of 1 or 2
• excessive combo filtering › filters out excessive combos (200+ damage where removing any hit still kills)
• excessive combo filtering › allows combos where removing any hit drops below lethal threshold
• deduplication › no duplicate combos with bug report weapons
• single weapon combos › returns no combos for a single weapon when disabled
• single weapon combos › generates combos from a single weapon when enabled
• single weapon combos › lets a single weapon pair its main and sub damage when enabled
• single weapon combos › keeps single-weapon combos alongside cross-weapon ones when enabled

Routes/comp-analyzer

Componentscomp-analyzer/DamageComboBar.tsxcomponents-showcase/ShowcaseSections.tsx

function

inkTimeToKill

:412

Frames of enemy ink damage needed to finish a target after comboDamage. targetResAp is Ink Resistance Up AP (0-57). Null when the combo is already lethal or ink damage can't finish it.

export function inkTimeToKill(
	comboDamage: number,
	targetResAp: number,
): number | null

Unit tests (8)

• returns
  • null for combos that are already lethal (>= 100 damage)
  • null for combos above 100 damage
  • null when remaining damage exceeds ink damage limit with high RES
• calculates
  • short ink time for 99 damage combo with 0 RES
  • longer ink time for 80 damage combo with 0 RES
• higher RES increases ink time
• handles
  • boundary case at 0 AP
  • boundary case at 57 AP

Componentscomp-analyzer/DamageComboBar.tsx

Unit tests not about one export (6)

• virtual damage combos › Explosher has COMBO damage type combining DIRECT and DISTANCE
• virtual damage combos › COMBO damage appears in damage combos
• extracts
  • main weapon damages
  • sub weapon damages
  • special weapon damages when applicable
• assigns correct weapon slots for multiple weapons

Not shown, only used by tests: damageSources

SpecialWeaponRange

app/features/comp-analyzer/core/SpecialWeaponRange.ts

Range circles of special weapons, as drawn on the map planner and the comp analyzer. Projectile specials (Trizooka, Crab Tank…) reuse the main weapon trajectory model of WeaponRange, area specials carry a radius in their params.

Imports

WeaponRange

Used by

2 components

Types

interface

SpecialWeaponRangeResult

:19

Range of a special: how far its projectile flies, or the radius of its area.

export interface SpecialWeaponRangeResult {
	/** In game distance units. */
	range: number;
	/** Extra outer radius of the projectile's blast, in game distance units. */
	blastRadius?: number;
	rangeType: "projectile" | "radius";
}

Only used inside the module

interface

SpecialWeaponWithRange

:75

A special with its range.

export interface SpecialWeaponWithRange extends SpecialWeaponRangeResult {
	specialWeaponId: SpecialWeaponId;
}

Componentscomp-analyzer/SpecialRangeVisualization.tsx

Functions & values

function

ofSpecial

:31

Range circle of a special, or null when it has none worth drawing. Values come from weapon-params.ts: projectile specials reuse the main weapon trajectory model, the rest carry a radius.

export function ofSpecial(
	specialWeaponId: SpecialWeaponId,
): SpecialWeaponRangeResult | null

Unit tests (6)

• computes a projectile range for Trizooka
• Crab Tank reaches further than Trizooka
• throws-and-bursts specials expose a throw range plus explosion blast
• returns
  • the effect radius for area specials
  • null for global / utility specials without a meaningful circle
• every special is either unsupported or has a positive finite range

Componentsmap-planner/Planner.tsx

function

allSpecials

:80

Every special with a range to draw, widest first.

export function allSpecials(): SpecialWeaponWithRange[]

Componentscomp-analyzer/SpecialRangeVisualization.tsx

WeaponRange

app/features/comp-analyzer/core/WeaponRange.ts

How far main weapons shoot: a frame by frame simulation of a shot's flight (straight, braking, then falling) from the weapon's params, chargers reaching their full charge distance in a line. Distances are in game units, measured from a player standing on flat ground.

Imports

no other modules

Used by

1 module3 components

Types

interface

TrajectoryParams

:12

Flight params of a shot, Range_* of the weapon's params with the game's defaults filled in.

export interface TrajectoryParams {
	spawnSpeed: number;
	goStraightStateEndMaxSpeed: number;
	goStraightToBrakeStateFrame: number;
	freeGravity: number;
	freeAirResist: number;
	brakeAirResist: number;
	brakeGravity: number;
	brakeToFreeFrame: number;
	burstFrame?: number;
	bounceAfterMaxSpeed?: number;
}

Modulescomp-analyzer/SpecialWeaponRange.ts

interface

TrajectoryPoint

:26

A shot's position: z the distance travelled forward, y the height above the ground.

export interface TrajectoryPoint {
	z: number;
	y: number;
}

Componentscomp-analyzer/RangeVisualization.tsx

interface

WeaponRangeResult

:171

Range of a main weapon, unsupported for weapons the model can't simulate.

export interface WeaponRangeResult {
	range: number;
	blastRadius?: number;
	rangeType: "calculated" | "direct" | "unsupported";
	trajectory?: TrajectoryPoint[];
}

Only used inside the module

interface

WeaponWithRange

:234

A comp's weapon with its range.

export interface WeaponWithRange {
	weaponId: MainWeaponId;
	/** Position in the comp, kept through the filtering so duplicates stay apart */
	slot: number;
	range: number;
	blastRadius?: number;
	rangeType: "calculated" | "direct" | "unsupported";
	trajectory?: TrajectoryPoint[];
}

Componentscomp-analyzer/RangeVisualization.tsx

interface

BenchmarkTrajectory

:262

Trajectory of a benchmark weapon.

export interface BenchmarkTrajectory {
	id: MainWeaponId;
	range: number;
	trajectory?: TrajectoryPoint[];
}

Only used inside the module

Functions & values

function

groundRange

:49

Distance at which a trajectory first reaches the ground, its last point's when it never does.

export function groundRange(trajectory: TrajectoryPoint[]): number

Modulescomp-analyzer/SpecialWeaponRange.ts

function

simulateTrajectory

:71

The shot's position on every frame until it lands, bursts or stops. Bouncing shots (bounceAfterMaxSpeed set) bounce burstFrame times instead of landing.

export function simulateTrajectory(
	params: TrajectoryParams,
): TrajectoryPoint[]

Modulescomp-analyzer/SpecialWeaponRange.ts

function

ofMainWeapon

:179

Range of a main weapon with the trajectory it was measured from.

export function ofMainWeapon(weaponId: MainWeaponId): WeaponRangeResult

Componentsmap-planner/Planner.tsx

function

ofWeapons

:245

Ranges of a comp's weapons, the ones the model can't simulate left out.

export function ofWeapons(weaponIds: MainWeaponId[]): WeaponWithRange[]

Unit tests (2)

• keeps a separate slot for each copy of a duplicated weapon
• weapon %i has more range than weapon %i

Componentscomp-analyzer/RangeVisualization.tsximg-export/CompGraphic.tsx

const

BENCHMARK_WEAPON_IDS

:259

Weapons drawn under every comp's ranges for scale: Splattershot and Snipewriter 5H.

export const BENCHMARK_WEAPON_IDS = [40, 2070] satisfies MainWeaponId[];

Componentscomp-analyzer/RangeVisualization.tsx

function

benchmarkTrajectories

:269

Trajectories of the benchmark weapons.

export function benchmarkTrajectories(): BenchmarkTrajectory[]

Componentscomp-analyzer/RangeVisualization.tsx