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

    Variable PUNCH_PHASESConst

    PUNCH_PHASES: {
        CHAMBER: {
            elbow: readonly [0, 0, -1.57];
            oppositeElbow: readonly [0, 0, 1.4];
            oppositeShoulder: readonly [-0.1, 0, 0.2];
            pelvisY: -0.1;
            shoulder: readonly [-0.15, 0, -0.2];
            spineY: -0.1;
            wrist: readonly [0, 0, 0];
        };
        EXTENSION: {
            elbow: readonly [0, 0, -0.09];
            oppositeElbow: readonly [0, 0, 1.1];
            oppositeShoulder: readonly [-0.2, 0, -0.3];
            pelvisY: 0.25;
            shoulder: readonly [0.25, 0, 0.15];
            spineY: 0.4;
            wrist: readonly [0, 0, 0.2];
        };
        PEAK: {
            elbow: readonly [0, 0, -0.05];
            oppositeElbow: readonly [0, 0, 1.1];
            oppositeShoulder: readonly [-0.2, 0, -0.3];
            pelvisY: 0.3;
            shoulder: readonly [0.25, 0, 0.15];
            spineY: 0.45;
            wrist: readonly [0, 0, 0.2];
        };
        WINDUP: {
            elbow: readonly [0, 0, 1.8];
            pelvisY: -0.1;
            shoulder: readonly [0.3, 0, -0.3];
            spineY: -0.15;
        };
    } = ...

    Punch phases for proper striking mechanics with Korean martial arts biomechanics 주먹 단계별 자세 - 한국 무술 생체역학 기반

    Based on traditional Korean martial arts principles:

    • 정권지르기 (Jeongkwon Jireugi) - Straight punch with fist rotation
    • 역권지르기 (Yeokwon Jireugi) - Reverse punch with full hip drive
    • 당기기 (Dangigi) - Pulling hand (hikite) for power generation
    • 엉덩이회전 (Eongdeongi Hoejeon) - Hip rotation for maximum power
    • 어깨비틀기 (Eokkae Biteulgi) - Shoulder torque coordination

    Type Declaration

    • ReadonlyCHAMBER: {
          elbow: readonly [0, 0, -1.57];
          oppositeElbow: readonly [0, 0, 1.4];
          oppositeShoulder: readonly [-0.1, 0, 0.2];
          pelvisY: -0.1;
          shoulder: readonly [-0.15, 0, -0.2];
          spineY: -0.1;
          wrist: readonly [0, 0, 0];
      }

      Chamber (준비) - Arm coiled back with fist vertical

      Korean martial arts chamber position:

      • Fist at hip level, palm facing up/in (세로주먹)
      • Elbow bent ~90 degrees
      • Opposite arm in guard position
      • Hip neutral or slightly turned away
      • Coiled for explosive extension
    • ReadonlyEXTENSION: {
          elbow: readonly [0, 0, -0.09];
          oppositeElbow: readonly [0, 0, 1.1];
          oppositeShoulder: readonly [-0.2, 0, -0.3];
          pelvisY: 0.25;
          shoulder: readonly [0.25, 0, 0.15];
          spineY: 0.4;
          wrist: readonly [0, 0, 0.2];
      }

      Extension with Hip Drive (지르기) - Full extension with body rotation

      Korean martial arts extension mechanics:

      • Fist rotates from vertical to pronated (palm-down)
      • Hip drives forward and rotates (엉덩이회전)
      • Shoulder rotates with punch (어깨비틀기)
      • Opposite arm pulls back to hip (당기기/hikite)
      • Elbow nearly straight at impact (~170-175°)
    • ReadonlyPEAK: {
          elbow: readonly [0, 0, -0.05];
          oppositeElbow: readonly [0, 0, 1.1];
          oppositeShoulder: readonly [-0.2, 0, -0.3];
          pelvisY: 0.3;
          shoulder: readonly [0.25, 0, 0.15];
          spineY: 0.45;
          wrist: readonly [0, 0, 0.2];
      }

      Peak Impact (정점) - Maximum extension and rotation

      Brief hold at full extension for impact frame. All power delivered through aligned structure. Slight additional arm extension for maximum reach.

    • ReadonlyWINDUP: {
          elbow: readonly [0, 0, 1.8];
          pelvisY: -0.1;
          shoulder: readonly [0.3, 0, -0.3];
          spineY: -0.15;
      }

      Wind-up (준비강화) - Brief additional coil before strike

      Minimal wind-up for fast punches like jab. More pronounced for power punches like cross.

    주먹단계