Class TrainingCombatSystem

Training-specific combat system for Korean martial arts practice Focuses on technique accuracy, form analysis, and educational feedback

Hierarchy

CombatSystem
- TrainingCombatSystem

Constructors

constructor

new TrainingCombatSystem(): TrainingCombatSystem
Returns TrainingCombatSystem
Overrides CombatSystem.constructor
- Defined in systems/combat/TrainingCombatSystem.ts:26

Methods

applyCombatResult

applyCombatResult(
    result: CombatResult,
    attacker: PlayerState,
    defender: PlayerState,
): { updatedAttacker: PlayerState; updatedDefender: PlayerState }
Fix: Make applyCombatResult non-static instance method with effect application Enhanced with Pain Response and Consciousness System integration
Parameters
- result: CombatResult
- attacker: PlayerState
- defender: PlayerState
Returns { updatedAttacker: PlayerState; updatedDefender: PlayerState }
Inherited from CombatSystem.applyCombatResult
- Defined in systems/CombatSystem.ts:497

applyRecovery

applyRecovery(player: PlayerState, deltaTime: number): PlayerState
Updates player states for recovery (pain dissipation, consciousness recovery, balance recovery). Call this regularly in game loop.
Parameters
- player: PlayerState
  Player to update
- deltaTime: number
  Time elapsed since last update (ms)
Returns PlayerState
Updated player state
Inherited from CombatSystem.applyRecovery
- Defined in systems/CombatSystem.ts:712

`Private`calculateAccuracyScore

calculateAccuracyScore(player: PlayerState, _technique: KoreanTechnique): number
Calculate accuracy score based on stance, timing, and targeting
Parameters
- player: PlayerState
- _technique: KoreanTechnique
Returns number
- Defined in systems/combat/TrainingCombatSystem.ts:137

calculateDamage

calculateDamage(
    technique: KoreanTechnique,
    attacker: PlayerState,
    defender: PlayerState,
    hitResult: VitalPointHitResult,
): {
    baseDamage: number;
    effectsApplied: readonly StatusEffect[];
    finalDefenderState?: Partial<PlayerState>;
    modifierDamage: number;
    totalDamage: number;
}
Fix: Add missing calculateDamage method required by interface
Parameters
- technique: KoreanTechnique
- attacker: PlayerState
- defender: PlayerState
- hitResult: VitalPointHitResult
Returns {
    baseDamage: number;
    effectsApplied: readonly StatusEffect[];
    finalDefenderState?: Partial<PlayerState>;
    modifierDamage: number;
    totalDamage: number;
}
Inherited from CombatSystem.calculateDamage
- Defined in systems/CombatSystem.ts:1210

`Private`calculateFormScore

calculateFormScore(_player: PlayerState, _technique: KoreanTechnique): number
Calculate form score based on balance and positioning
Parameters
- _player: PlayerState
- _technique: KoreanTechnique
Returns number
- Defined in systems/combat/TrainingCombatSystem.ts:171

`Private`calculateImprovementTrend

calculateImprovementTrend(): "stable" | "improving" | "declining"
Calculate improvement trend from recent accuracy scores

Returns "stable" | "improving" | "declining"
- Defined in systems/combat/TrainingCombatSystem.ts:294

`Private`calculateTechniqueScore

calculateTechniqueScore(
player: PlayerState,
_technique: KoreanTechnique,
): number
Calculate technique execution score
Parameters
- player: PlayerState
- _technique: KoreanTechnique
Returns number
- Defined in systems/combat/TrainingCombatSystem.ts:152

cleanupPlayerData

cleanupPlayerData(playerId: string): void
Cleanup per-player combat state.

Call this when a player permanently leaves the match or when match-level cleanup is performed to avoid unbounded Map growth.
Parameters
- playerId: string
  ID of the player to cleanup
Returns void
Korean
플레이어데이터정리
Inherited from CombatSystem.cleanupPlayerData
- Defined in systems/CombatSystem.ts:99

`Private`createTrainingDummy

createTrainingDummy(): PlayerState
Create a training dummy with infinite health for practice

Returns PlayerState
- Defined in systems/combat/TrainingCombatSystem.ts:34

dispose

dispose(): void
Dispose of all combat system resources.

Korean: 전투 시스템 자원 정리

Cleans up Three.js resources (geometries, raycaster) used by the collision detection system to prevent memory leaks. Should be called when the CombatSystem is destroyed or reinitialized.

Returns void
Korean
전투시스템자원정리
Inherited from CombatSystem.dispose
- Defined in systems/CombatSystem.ts:116

`Protected`executeAttack

executeAttack(
    attacker: PlayerState,
    defender: PlayerState,
    technique: KoreanTechnique,
): CombatResult
Execute attack with technique
Parameters
- attacker: PlayerState
- defender: PlayerState
- technique: KoreanTechnique
Returns CombatResult
Inherited from CombatSystem.executeAttack
- Defined in systems/CombatSystem.ts:1150

executeTrainingTechnique

executeTrainingTechnique(
    player: PlayerState,
    technique: KoreanTechnique,
    targetedVitalPointId?: string,
    animationContext?: AnimationContext,
): TrainingCombatResult
Execute a training technique with detailed analysis Supports optional animation context for physics-based hit detection
Parameters
- player: PlayerState
- technique: KoreanTechnique
- OptionaltargetedVitalPointId: string
- OptionalanimationContext: AnimationContext
Returns TrainingCombatResult
- Defined in systems/combat/TrainingCombatSystem.ts:80

`Private`generateImprovementAreas

generateImprovementAreas(
    accuracy: number,
    technique: number,
    form: number,
): string[]
Generate areas for improvement based on scores
Parameters
- accuracy: number
- technique: number
- form: number
Returns string[]
- Defined in systems/combat/TrainingCombatSystem.ts:184

`Private`generateTrainingGoals

generateTrainingGoals(
    _player: PlayerState,
    technique: KoreanTechnique,
    accuracy: number,
): string[]
Generate next training goals
Parameters
- _player: PlayerState
- technique: KoreanTechnique
- accuracy: number
Returns string[]
- Defined in systems/combat/TrainingCombatSystem.ts:223

getAvailableTechniques

getAvailableTechniques(player: PlayerState): readonly KoreanTechnique[]
Fix: Add missing getAvailableTechniques method required by interface
Parameters
- player: PlayerState
Returns readonly KoreanTechnique[]
Inherited from CombatSystem.getAvailableTechniques
- Defined in systems/CombatSystem.ts:913

getBalanceSystem

getBalanceSystem(): BalanceSystem
Get the balance system instance for fall checking.

Returns BalanceSystem
BalanceSystem instance

Korean
균형시스템가져오기
Inherited from CombatSystem.getBalanceSystem
- Defined in systems/CombatSystem.ts:128

getCollisionDetection

getCollisionDetection(): CollisionDetection
Get the collision detection system instance.

Returns CollisionDetection
CollisionDetection instance

Korean
충돌감지시스템가져오기
Inherited from CombatSystem.getCollisionDetection
- Defined in systems/CombatSystem.ts:150

getCombatStatistics

getCombatStatistics(
    player: PlayerState,
): {
    balancePercent: number;
    healthPercent: number;
    kiPercent: number;
    staminaPercent: number;
}
Get combat statistics
Parameters
- player: PlayerState
Returns {
    balancePercent: number;
    healthPercent: number;
    kiPercent: number;
    staminaPercent: number;
}
Inherited from CombatSystem.getCombatStatistics
- Defined in systems/CombatSystem.ts:1028

getConsciousnessSystem

getConsciousnessSystem(): ConsciousnessSystem
Get the consciousness system instance for fall checking.

Returns ConsciousnessSystem
ConsciousnessSystem instance

Korean
의식시스템가져오기
Inherited from CombatSystem.getConsciousnessSystem
- Defined in systems/CombatSystem.ts:139

`Private`getStanceSpecificGoals

getStanceSpecificGoals(stance: TrigramStance): string[]
Get stance-specific training goals
Parameters
- stance: TrigramStance
Returns string[]
- Defined in systems/combat/TrainingCombatSystem.ts:249

getTrainingDummy

getTrainingDummy(): PlayerState
Get training dummy for display

Returns PlayerState
- Defined in systems/combat/TrainingCombatSystem.ts:332

getTrainingStats

getTrainingStats(): {
    improvementTrend: "stable"
    | "improving"
    | "declining";
    overallAccuracy: number;
    recentAccuracy: number[];
    successfulTechniques: number;
    successRate: number;
    totalAttempts: number;
}
Get training statistics

Returns {
    improvementTrend: "stable" | "improving" | "declining";
    overallAccuracy: number;
    recentAccuracy: number[];
    successfulTechniques: number;
    successRate: number;
    totalAttempts: number;
}
- Defined in systems/combat/TrainingCombatSystem.ts:269

isPlayerDefeated

isPlayerDefeated(player: PlayerState): boolean
Check if a player is defeated
Parameters
- player: PlayerState
Returns boolean
Inherited from CombatSystem.isPlayerDefeated
- Defined in systems/CombatSystem.ts:952

processDefensiveAction

processDefensiveAction(
    defender: PlayerState,
    _attacker: PlayerState,
    attackPower: number,
): "block_success" | "parry_deflect" | "guard_break"
Process defensive action and determine animation type.

Determines the appropriate defensive animation based on:
- Defender's balance and stamina (defensive power)
- Attacker's technique power
- Combat readiness state
Korean: 방어 행동 처리
Parameters
- defender: PlayerState
  Defending player state
- _attacker: PlayerState
- attackPower: number
  Power of the incoming attack
Returns "block_success" | "parry_deflect" | "guard_break"
Defensive animation type to play (parry_deflect, block_success, or guard_break)
Example
```
const animType = combatSystem.processDefensiveAction(
  defender,
  attacker,
  technique.damage
);
// Returns: 'parry_deflect', 'block_success', or 'guard_break'
```
Korean
방어행동처리
Inherited from CombatSystem.processDefensiveAction
- Defined in systems/CombatSystem.ts:1101

resetTrainingDummy

resetTrainingDummy(): void
Fix: Add the missing resetTrainingDummy method that tests expect

Returns void
- Defined in systems/combat/TrainingCombatSystem.ts:325

resetTrainingSession

resetTrainingSession(): void
Reset training session

Returns void
- Defined in systems/combat/TrainingCombatSystem.ts:315

resolveAttack

resolveAttack(
    attacker: PlayerState,
    defender: PlayerState,
    technique: KoreanTechnique,
    targetedVitalPointId?: string,
    animationContext?: { animationType: AnimationType; currentTime: number },
): CombatResult
Fix: Update resolveAttack to match interface signature and add animation-aware hit detection

Korean: 공격 해결 (애니메이션 인식)

Integrates animation timing and physical reach calculation for reality-based hit detection. Hits only register when:
1. Animation is in hit window (extension phase)
2. Attacker is within effective reach based on limb length and animation
3. Existing accuracy and stance checks pass
Parameters
- attacker: PlayerState
  Attacking player state
- defender: PlayerState
  Defending player state
- technique: KoreanTechnique
  Technique being executed
- OptionaltargetedVitalPointId: string
  Optional specific vital point target
- OptionalanimationContext: { animationType: AnimationType; currentTime: number }
  Optional animation timing context for reality-based hit detection
Returns CombatResult
Combat result with hit/miss and damage information
Inherited from CombatSystem.resolveAttack
- Defined in systems/CombatSystem.ts:244

updatePlayerState

updatePlayerState(player: PlayerState, deltaTime: number): PlayerState
Update player state over time with effect management
Parameters
- player: PlayerState
- deltaTime: number
Returns PlayerState
Inherited from CombatSystem.updatePlayerState
- Defined in systems/CombatSystem.ts:959

updateTrainingDummy

updateTrainingDummy(updates: Partial<PlayerState>): void
Update training dummy health (for visual feedback)
Parameters
- updates: Partial<PlayerState>
Returns void
- Defined in systems/combat/TrainingCombatSystem.ts:339

`Static`applyCombatResult

applyCombatResult(
    result: CombatResult,
    attacker: PlayerState,
    defender: PlayerState,
): { updatedAttacker: PlayerState; updatedDefender: PlayerState }
Static version for backwards compatibility with comprehensive effect application Enhanced with Pain Response and Consciousness System integration Updated to apply damage to body parts for 8-body-part health visualization
Parameters
- result: CombatResult
- attacker: PlayerState
- defender: PlayerState
Returns { updatedAttacker: PlayerState; updatedDefender: PlayerState }
Inherited from CombatSystem.applyCombatResult
- Defined in systems/CombatSystem.ts:746

`Static`resolveAttack

resolveAttack(
    attacker: PlayerState,
    defender: PlayerState,
    technique: KoreanTechnique,
): CombatResult
Static methods for backwards compatibility
Parameters
- attacker: PlayerState
- defender: PlayerState
- technique: KoreanTechnique
Returns CombatResult
Inherited from CombatSystem.resolveAttack
- Defined in systems/CombatSystem.ts:940

Properties

`Private`accuracyHistory

accuracyHistory: number[] = []

`Private`successfulTechniques

successfulTechniques: number = 0

`Private`techniqueAttempts

techniqueAttempts: number = 0

`Private`trainingDummy

trainingDummy: PlayerState

`Protected`trigramSystem

trigramSystem: TrigramSystem

Class TrainingCombatSystem

Hierarchy

Index

Constructors

Methods

Properties

Constructors

constructor

Returns TrainingCombatSystem

Methods

applyCombatResult

Parameters

Returns { updatedAttacker: PlayerState; updatedDefender: PlayerState }

applyRecovery

Parameters

Returns PlayerState

PrivatecalculateAccuracyScore

Parameters

Returns number

calculateDamage

Parameters

Returns { baseDamage: number; effectsApplied: readonly StatusEffect[]; finalDefenderState?: Partial<PlayerState>; modifierDamage: number; totalDamage: number;}

PrivatecalculateFormScore

Parameters

Returns number

PrivatecalculateImprovementTrend

Returns "stable" | "improving" | "declining"

PrivatecalculateTechniqueScore

Parameters

Returns number

cleanupPlayerData

Parameters

Returns void

Korean

PrivatecreateTrainingDummy

Returns PlayerState

dispose

Returns void

Korean

ProtectedexecuteAttack

Parameters

Returns CombatResult

executeTrainingTechnique

Parameters

Returns TrainingCombatResult

PrivategenerateImprovementAreas

Parameters

Returns string[]

PrivategenerateTrainingGoals

Parameters

Returns string[]

getAvailableTechniques

Parameters

Returns readonly KoreanTechnique[]

getBalanceSystem

Returns BalanceSystem

Korean

getCollisionDetection

Returns CollisionDetection

Korean

getCombatStatistics

Parameters

Returns { balancePercent: number; healthPercent: number; kiPercent: number; staminaPercent: number;}

getConsciousnessSystem

Returns ConsciousnessSystem

Korean

PrivategetStanceSpecificGoals

Parameters

Returns string[]

getTrainingDummy

Returns PlayerState

getTrainingStats

Returns { improvementTrend: "stable" | "improving" | "declining"; overallAccuracy: number; recentAccuracy: number[]; successfulTechniques: number; successRate: number; totalAttempts: number;}

isPlayerDefeated

Parameters

Returns boolean

processDefensiveAction

Parameters

Returns "block_success" | "parry_deflect" | "guard_break"

Example

`Private`calculateAccuracyScore

Returns {
baseDamage: number;
effectsApplied: readonly StatusEffect[];
finalDefenderState?: Partial<PlayerState>;
modifierDamage: number;
totalDamage: number;
}

`Private`calculateFormScore

`Private`calculateImprovementTrend

`Private`calculateTechniqueScore

`Private`createTrainingDummy

`Protected`executeAttack

`Private`generateImprovementAreas

`Private`generateTrainingGoals

Returns {
balancePercent: number;
healthPercent: number;
kiPercent: number;
staminaPercent: number;
}

`Private`getStanceSpecificGoals

Returns {
improvementTrend: "stable" | "improving" | "declining";
overallAccuracy: number;
recentAccuracy: number[];
successfulTechniques: number;
successRate: number;
totalAttempts: number;
}

`Static`applyCombatResult

`Static`resolveAttack

`Private`accuracyHistory

`Private`successfulTechniques

`Private`techniqueAttempts

`Private`trainingDummy

`Protected`trigramSystem