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

    Class TrigramCalculator

    Index

    Constructors

    Methods

    • Calculate laterality modifier based on stance matching.

      In Korean martial arts, matched stances (both fighters in same laterality) create tactical advantages for mid-level attacks as centerlines are more exposed. Mismatched stances (opposite laterality) provide defensive advantages as lead guards naturally protect the centerline.

      Parameters

      • attackerLaterality: StanceLaterality

        Attacker's stance laterality (left or right)

      • defenderLaterality: StanceLaterality

        Defender's stance laterality (left or right)

      • attackLevel: "low" | "high" | "mid" = "mid"

        Attack level: "high", "mid", or "low"

      Returns number

      Damage multiplier (1.0 = neutral, >1.0 = advantage, <1.0 = disadvantage)

      // Matched stances: attacker gains mid-level advantage
      const modifier = TrigramCalculator.calculateLateralityModifier("left", "left", "mid");
      // Returns 1.15 (+15% effectiveness)

      // Mismatched stances: defender's guard protects centerline
      const modifier = TrigramCalculator.calculateLateralityModifier("left", "right", "mid");
      // Returns 0.90 (-10% effectiveness)

      측면성수정자계산