Class CombatStateSystem

Combat State System managing readiness state transitions.

Evaluates player condition and determines current combat readiness state. States degrade based on:

Cumulative damage (health loss)
Pain overload
Consciousness reduction
Balance disruption

Example

const combatStateSystem = new CombatStateSystem();

// Determine current state
const state = combatStateSystem.determineState(player);

// Get capability modifiers
const capability = combatStateSystem.getCapability(state);
console.log(`Capability: ${capability.capability}%`);

// Apply modifiers to damage calculation
const modifiedDamage = baseDamage * capability.accuracyModifier;

Korean

전투상태시스템

Index

Constructors

constructor

new CombatStateSystem(): CombatStateSystem
Returns CombatStateSystem

Methods

applyStateModifiers

applyStateModifiers(
player: PlayerState,
state: CombatReadinessState,
): PlayerState
Applies combat state modifiers to a player state.

Creates a modified player state with capability reductions based on current combat readiness.
Parameters
- player: PlayerState
  Current player state
- state: CombatReadinessState
  Combat readiness state to apply
Returns PlayerState
Modified player state with applied modifiers
Example
```
const state = combatStateSystem.determineState(player);
const modifiedPlayer = combatStateSystem.applyStateModifiers(
  player,
  state
);
```
Korean
상태적용
- Defined in systems/combat/CombatStateSystem.ts:307

canRecoverFromHelpless

canRecoverFromHelpless(player: PlayerState, currentTime: number): boolean
Checks if player can recover from HELPLESS state.

Recovery occurs after 5 seconds with no additional hits.
Parameters
- player: PlayerState
  Current player state
- currentTime: number
  Current timestamp
Returns boolean
True if recovery is possible

Korean
회복가능확인
- Defined in systems/combat/CombatStateSystem.ts:501

`Private`checkBodyPartHealthLoss

checkBodyPartHealthLoss(player: PlayerState, lossThreshold: number): boolean
Private
Checks if any body part has lost more than the specified percentage of health.
Parameters
- player: PlayerState
  Current player state
- lossThreshold: number
  Health loss threshold (0.0 to 1.0)
Returns boolean
True if any body part has lost more than the threshold

Korean
신체부위손상확인
- Defined in systems/combat/CombatStateSystem.ts:411

`Private`countRecentHits

countRecentHits(
    player: PlayerState,
    currentTime: number | undefined,
    timeWindow: number,
): number
Private
Counts recent hits within a time window.
Parameters
- player: PlayerState
  Current player state
- currentTime: number | undefined
  Current timestamp (milliseconds)
- timeWindow: number
  Time window to check in milliseconds
Returns number
Number of hits within the time window

Korean
최근타격횟수
- Defined in systems/combat/CombatStateSystem.ts:386

determineState

determineState(player: PlayerState, currentTime?: number): CombatReadinessState
Determines the current combat readiness state based on player condition.

Evaluates health, pain, consciousness, balance, and recent hits to determine the most appropriate combat state. State transitions follow acceptance criteria:
- READY → SHAKEN: After taking 2-3 hits or significant vital point strike
- SHAKEN → VULNERABLE: After additional 2 hits or loss of 30% body part health
- VULNERABLE → HELPLESS: After head trauma, pain >80, or knock-down
- Recovery: HELPLESS → READY over 5 seconds if no additional hits
Parameters
- player: PlayerState
  Current player state
- OptionalcurrentTime: number
  Current timestamp in milliseconds
Returns CombatReadinessState
Current combat readiness state
Example
```
const state = combatStateSystem.determineState(player, Date.now());
if (state === CombatReadinessState.HELPLESS) {
  console.log("Player is near incapacitation!");
}
```
Korean
상태결정
- Defined in systems/combat/CombatStateSystem.ts:170

enterHelplessState

enterHelplessState(player: PlayerState, currentTime: number): PlayerState
Updates player when entering HELPLESS state.

Records the timestamp for recovery tracking.
Parameters
- player: PlayerState
  Current player state
- currentTime: number
  Timestamp when entering helpless state
Returns PlayerState
Updated player state

Korean
무력상태기록
- Defined in systems/combat/CombatStateSystem.ts:482

getCapability

getCapability(state: CombatReadinessState): StateCapability
Gets the capability modifiers for a specific combat state.

Returns all modifiers that should be applied to player actions based on their current combat readiness.
Parameters
- state: CombatReadinessState
  Combat readiness state
Returns StateCapability
Capability modifiers for the state
Example
```
const capability = combatStateSystem.getCapability(
  CombatReadinessState.SHAKEN
);

// Apply to damage calculation
const finalDamage = baseDamage * capability.accuracyModifier;

// Check if can block
if (!capability.canBlock) {
  console.log("Cannot block in this state!");
}
```
Korean
능력조회
- Defined in systems/combat/CombatStateSystem.ts:281

getStateEmoji

getStateEmoji(state: CombatReadinessState): string
Gets emoji indicator for combat state.
Parameters
- state: CombatReadinessState
  Combat readiness state
Returns string
Emoji representing the state

Korean
상태아이콘
- Defined in systems/combat/CombatStateSystem.ts:364

getStateName

getStateName(state: CombatReadinessState): { english: string; korean: string }
Gets bilingual name for combat state.
Parameters
- state: CombatReadinessState
  Combat readiness state
Returns { english: string; korean: string }
Korean and English state names

Korean
상태이름
- Defined in systems/combat/CombatStateSystem.ts:332

recordHit

recordHit(player: PlayerState, currentTime: number): PlayerState
Records a hit on the player and updates recent hit tracking.

Should be called by combat system when player takes a hit. Maintains a rolling window of the last 10 hit timestamps.
Parameters
- player: PlayerState
  Current player state
- currentTime: number
  Timestamp of the hit
Returns PlayerState
Updated player state with recorded hit

Korean
타격기록
- Defined in systems/combat/CombatStateSystem.ts:457

Properties

`Private` `Readonly`stateCapabilities

stateCapabilities: Record<CombatReadinessState, StateCapability> = ...

State capability definitions with modifiers per state.

Based on acceptance criteria:

READY: 100% capability (baseline)
SHAKEN: -15% accuracy, -10% damage
VULNERABLE: -30% accuracy, -25% damage, +50% damage taken
HELPLESS: Cannot attack, cannot block, +100% damage taken

Class CombatStateSystem

Example

Korean

Index

Constructors

Methods

Properties

Constructors

constructor

Returns CombatStateSystem

Methods

applyStateModifiers

Parameters

Returns PlayerState

Example

Korean

canRecoverFromHelpless

Parameters

Returns boolean

Korean

PrivatecheckBodyPartHealthLoss

Parameters

Returns boolean

Korean

PrivatecountRecentHits

Parameters

Returns number

Korean

determineState

Parameters

Returns CombatReadinessState

Example

Korean

enterHelplessState

Parameters

Returns PlayerState

Korean

getCapability

Parameters

Returns StateCapability

Example

Korean

getStateEmoji

Parameters

Returns string

Korean

getStateName

Parameters

Returns { english: string; korean: string }

Korean

recordHit

Parameters

Returns PlayerState

Korean

Properties

Private ReadonlystateCapabilities

Settings

On This Page

`Private`checkBodyPartHealthLoss

`Private`countRecentHits

`Private` `Readonly`stateCapabilities