Black Trigram (흑괘) - Korean Martial Arts Combat Simulator API - v0.5.30
    Preparing search index...

    Function calculateEnhancedVulnerability

    • Calculate enhanced anatomical vulnerability with stance, meridian flow, and time-of-day

      Korean: 향상된 해부학적 취약성 계산 (Enhanced Anatomical Vulnerability Calculation)

      Calculates vulnerability multiplier for a specific position, considering:

      • Base zone vulnerability (0.5-2.0x)
      • Stance-based exposure modifiers (0.6-1.3x per zone)
      • Meridian flow state (blocked meridians +50% vulnerability)
      • Time-of-day meridian peak hours (+20% vulnerability at peak)
      vulnerability = baseVulnerability
      × stanceModifier
      × meridianFlowModifier
      × timeOfDayModifier

      Final result is capped between 0.5x and 3.0x.

      Parameters

      • position: Position

        Target position on body

      • currentHour: number

        Hour of day (0-23) for meridian flow calculation

      • stance: TrigramStance

        Current trigram stance affecting zone exposure

      • meridianStates: Record<string, number>

        Meridian disruption states (0=blocked, 1=normal flow)

      Returns number

      Vulnerability multiplier (0.5-3.0)

      // Calculate vulnerability for head strike at 2 AM in offensive stance
      const vulnerability = calculateEnhancedVulnerability(
      { x: 50, y: 50 }, // Head position
      2, // 2 AM (liver meridian peak)
      TrigramStance.GEON, // Heaven stance (offensive, exposes head)
      {
      bladder: 1.0, // Normal flow
      gallbladder: 0.5, // Partially blocked
      liver: 1.0 // Normal flow at peak hour
      }
      );
      // Result: ~2.5x (high base × stance exposure × meridian effects × time bonus)