Class DamageCalculator

Index

Constructors

Methods

calculateCriticalChance calculateDamageReduction calculateEnhancedVitalPointDamage calculateMeridianDamageBonus calculateTechniqueDamage calculateTimeBonus calculateVitalPointDamage getArchetypeDamageBonus getArchetypeModifier

Properties

ACCURACY_MIN_MULTIPLIER ACCURACY_RANGE SEVERITY_MULTIPLIERS

Constructors

constructor

new DamageCalculator(): DamageCalculator
Returns DamageCalculator

Methods

`Static`calculateCriticalChance

calculateCriticalChance(
    baseCritChance: number,
    attacker: PlayerState,
    technique: KoreanTechnique,
): number
Calculate critical hit chance
Parameters
- baseCritChance: number
- attacker: PlayerState
- technique: KoreanTechnique
Returns number
- Defined in systems/vitalpoint/DamageCalculator.ts:175

`Static`calculateDamageReduction

calculateDamageReduction(
    incomingDamage: number,
    defenderDefense: number,
    isBlocking?: boolean,
): number
Calculate damage reduction from defense
Parameters
- incomingDamage: number
- defenderDefense: number
- isBlocking: boolean = false
Returns number
- Defined in systems/vitalpoint/DamageCalculator.ts:158

`Static`calculateEnhancedVitalPointDamage

calculateEnhancedVitalPointDamage(
    attacker: PlayerState,
    defender: PlayerState,
    technique: KoreanTechnique,
    vitalPointHit: VitalPointHitResult,
    currentHour: number,
    meridianStates: Record<string, number>,
): DamageResult
Calculate comprehensive vital point damage with all modifiers.

Korean: 종합 급소 피해 계산 (Comprehensive Vital Point Damage Calculation)

Integrates all damage modifiers including:
- Base damage from attacker strength and technique power
- Stance effectiveness (攻克关系)
- Vital point severity multipliers (1.5x-3.0x)
- Accuracy bonus (0.8x-1.2x)
- Meridian flow bonus (1.0x-1.3x at peak hours)
- Time-of-day bonus (+20% for Dark Ops techniques at night)
- Archetype-specific bonuses
- Critical hit multiplier (2x when accuracy > 0.9)
- Damage variance (±10% randomness)
- Defense reduction
Damage Formula
```
finalDamage =
  baseDamage ×
  stanceEffectiveness ×
  vitalPointMultiplier ×
  accuracyBonus ×
  meridianBonus ×
  timeBonus ×
  archetypeBonus ×
  criticalMultiplier ×
  variance ×
  defenseReduction
```
Parameters
- attacker: PlayerState
  Attacking player state
- defender: PlayerState
  Defending player state
- technique: KoreanTechnique
  Korean martial arts technique being used
- vitalPointHit: VitalPointHitResult
  Result of vital point hit detection
- currentHour: number
  Current hour of day (0-23) for meridian flow
- meridianStates: Record<string, number>
  Current meridian disruption states (0=blocked, 1=normal)
Returns DamageResult
Comprehensive damage result with all modifiers applied
Example
```
const result = DamageCalculator.calculateEnhancedVitalPointDamage(
  attackerState,
  defenderState,
  technique,
  vitalPointHitResult,
  2, // 2 AM - liver meridian peak
  { liver: 1.0, gallbladder: 0.8 }
);
console.log(`Final damage: ${result.damage}`);
console.log(`Critical hit: ${result.isCritical}`);
```
Korean
종합급소피해계산
- Defined in systems/vitalpoint/DamageCalculator.ts:245

`Private` `Static`calculateMeridianDamageBonus

calculateMeridianDamageBonus(
    vitalPointId: string,
    currentHour: number,
    meridianStates: Record<string, number>,
): number
Private
Calculate meridian flow damage bonus based on time of day.

Korean: 경락 유효성 피해 보너스 계산

Calculates bonus damage when striking vital points during their peak meridian flow hours. Peak flow provides +30% damage bonus.
Parameters
- vitalPointId: string
  ID of the vital point being struck
- currentHour: number
  Current hour of day (0-23)
- meridianStates: Record<string, number>
  Current meridian disruption states
Returns number
Damage multiplier (1.0-1.3)

Korean
경락유효성피해보너스계산
- Defined in systems/vitalpoint/DamageCalculator.ts:350

`Static`calculateTechniqueDamage

calculateTechniqueDamage(
    technique: KoreanTechnique,
    attacker: PlayerState,
    vitalPoint: VitalPoint | null,
    accuracy: number,
): DamageResult
Calculate technique damage with vital point consideration
Parameters
- technique: KoreanTechnique
- attacker: PlayerState
- vitalPoint: VitalPoint | null
- accuracy: number
Returns DamageResult
- Defined in systems/vitalpoint/DamageCalculator.ts:111

`Private` `Static`calculateTimeBonus

calculateTimeBonus(technique: KoreanTechnique, currentHour: number): number
Private
Calculate time-of-day bonus for Dark Ops techniques.

Korean: 시간대 보너스 계산

Dark Ops techniques gain +20% damage at night (20:00-05:59) to reflect tactical advantage of darkness.
Parameters
- technique: KoreanTechnique
  Technique being used
- currentHour: number
  Current hour of day (0-23)
Returns number
Time bonus multiplier (1.0 or 1.2)

Korean
시간대보너스계산
- Defined in systems/vitalpoint/DamageCalculator.ts:394

`Static`calculateVitalPointDamage

calculateVitalPointDamage(
    vitalPoint: VitalPoint,
    baseDamage: number,
    attacker: PlayerState,
    accuracy: number,
): DamageResult
Calculate vital point damage with proper archetype bonuses
Parameters
- vitalPoint: VitalPoint
- baseDamage: number
- attacker: PlayerState
- accuracy: number
Returns DamageResult
- Defined in systems/vitalpoint/DamageCalculator.ts:43

`Private` `Static`getArchetypeDamageBonus

getArchetypeDamageBonus(
    archetype: PlayerArchetype,
    technique: KoreanTechnique,
    vitalPoint?: VitalPoint,
): number
Private
Get archetype-specific damage bonus for technique and vital point.

Korean: 원형 특화 피해 보너스

Each archetype has specialized bonuses for different techniques and vital point categories:
- 무사 (Musa): +20% with 건 (Geon) stance techniques
- 암살자 (Amsalja): +30% on neurological vital points
- 해커 (Hacker): +15% baseline precision bonus
- 정보요원 (Jeongbo): +25% on vascular vital points
- 조직폭력배 (Jojik): +20% on dirty/ruthless techniques
Parameters
- archetype: PlayerArchetype
  Attacker's archetype
- technique: KoreanTechnique
  Technique being used
- OptionalvitalPoint: VitalPoint
  Vital point being struck (optional)
Returns number
Archetype damage multiplier (1.0-1.5)

Korean
원형특화피해보너스
- Defined in systems/vitalpoint/DamageCalculator.ts:437

`Static`getArchetypeModifier

getArchetypeModifier(archetype: PlayerArchetype): number
Fix: Add missing getArchetypeModifier method
Parameters
- archetype: PlayerArchetype
Returns number
- Defined in systems/vitalpoint/DamageCalculator.ts:91

Properties

`Private` `Static` `Readonly`ACCURACY_MIN_MULTIPLIER

ACCURACY_MIN_MULTIPLIER: 0.8

Accuracy bonus scaling constants Maps 0.0-1.0 accuracy to 0.8x-1.2x multiplier

`Private` `Static` `Readonly`ACCURACY_RANGE

ACCURACY_RANGE: 0.4

`Private` `Static` `Readonly`SEVERITY_MULTIPLIERS

SEVERITY_MULTIPLIERS: Record<VitalPointSeverity, number> = ...

Vital point severity damage multipliers

Class DamageCalculator

Index

Constructors

Methods

Properties

Constructors

constructor

Returns DamageCalculator

Methods

StaticcalculateCriticalChance

Parameters

Returns number

StaticcalculateDamageReduction

Parameters

Returns number

StaticcalculateEnhancedVitalPointDamage

Damage Formula

Parameters

Returns DamageResult

Example

Korean

Private StaticcalculateMeridianDamageBonus

Parameters

Returns number

Korean

StaticcalculateTechniqueDamage

Parameters

Returns DamageResult

Private StaticcalculateTimeBonus

Parameters

Returns number

Korean

StaticcalculateVitalPointDamage

Parameters

Returns DamageResult

Private StaticgetArchetypeDamageBonus

Parameters

Returns number

Korean

StaticgetArchetypeModifier

Parameters

Returns number

Properties

Private Static ReadonlyACCURACY_MIN_MULTIPLIER

Private Static ReadonlyACCURACY_RANGE

Private Static ReadonlySEVERITY_MULTIPLIERS

Settings

On This Page

`Static`calculateCriticalChance

`Static`calculateDamageReduction

`Static`calculateEnhancedVitalPointDamage

`Private` `Static`calculateMeridianDamageBonus

`Static`calculateTechniqueDamage

`Private` `Static`calculateTimeBonus

`Static`calculateVitalPointDamage

`Private` `Static`getArchetypeDamageBonus

`Static`getArchetypeModifier

`Private` `Static` `Readonly`ACCURACY_MIN_MULTIPLIER

`Private` `Static` `Readonly`ACCURACY_RANGE

`Private` `Static` `Readonly`SEVERITY_MULTIPLIERS