Variable PUNCH_PHASES`Const`

PUNCH_PHASES: {
    CHAMBER: {
        elbow: readonly [0, 0, -1.65];
        oppositeElbow: readonly [0, 0, 1.6];
        oppositeShoulder: readonly [-0.5, 0, 0.3];
        pelvisY: -0.25;
        shoulder: readonly [-0.15, 0, -0.2];
        spineY: -0.2;
        wrist: readonly [0, 0, 0];
    };
    EXTENSION: {
        elbow: readonly [0, 0, -0.09];
        oppositeElbow: readonly [0, 0, 1.55];
        oppositeShoulder: readonly [-0.2, 0, -0.35];
        pelvisY: 0.45;
        shoulder: readonly [0.25, 0, 0.15];
        spineY: 0.48;
        wrist: readonly [0, 0, 0.4];
    };
    PEAK: {
        elbow: readonly [0, 0, -0.05];
        oppositeElbow: readonly [0, 0, 1.55];
        oppositeShoulder: readonly [-0.2, 0, -0.35];
        pelvisY: 0.49;
        shoulder: readonly [0.25, 0, 0.15];
        spineY: 0.52;
        wrist: readonly [0, 0, 0.45];
    };
    WINDUP: {
        elbow: readonly [0, 0, -1.75];
        pelvisY: -0.22;
        shoulder: readonly [-0.1, 0, -0.3];
        spineY: -0.28;
    };
} = ...

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
역권지르기 (Yeokkwon 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.65];
    oppositeElbow: readonly [0, 0, 1.6];
    oppositeShoulder: readonly [-0.5, 0, 0.3];
    pelvisY: -0.25;
    shoulder: readonly [-0.15, 0, -0.2];
    spineY: -0.2;
    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.55];
    oppositeShoulder: readonly [-0.2, 0, -0.35];
    pelvisY: 0.45;
    shoulder: readonly [0.25, 0, 0.15];
    spineY: 0.48;
    wrist: readonly [0, 0, 0.4];
}
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 (엉덩이회전) ~25-30°
- Shoulder rotates with punch (어깨비틀기)
- Opposite arm pulls back fully to hip (당기기/hikite)
- Elbow nearly straight at impact (~170-175°)
ReadonlyPEAK: {
    elbow: readonly [0, 0, -0.05];
    oppositeElbow: readonly [0, 0, 1.55];
    oppositeShoulder: readonly [-0.2, 0, -0.35];
    pelvisY: 0.49;
    shoulder: readonly [0.25, 0, 0.15];
    spineY: 0.52;
    wrist: readonly [0, 0, 0.45];
}
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.75];
    pelvisY: -0.22;
    shoulder: readonly [-0.1, 0, -0.3];
    spineY: -0.28;
}
Wind-up (준비강화) - Brief additional coil before strike

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

Elbow z is NEGATIVE in LEFT-arm convention (= flexion). Previous value of +1.8 was a sign bug that would over-extend the elbow at windup.

Korean

주먹단계

Variable PUNCH_PHASES`Const`

Type Declaration

`Readonly`CHAMBER: {
    elbow: readonly [0, 0, -1.65];
    oppositeElbow: readonly [0, 0, 1.6];
    oppositeShoulder: readonly [-0.5, 0, 0.3];
    pelvisY: -0.25;
    shoulder: readonly [-0.15, 0, -0.2];
    spineY: -0.2;
    wrist: readonly [0, 0, 0];
}

`Readonly`EXTENSION: {
    elbow: readonly [0, 0, -0.09];
    oppositeElbow: readonly [0, 0, 1.55];
    oppositeShoulder: readonly [-0.2, 0, -0.35];
    pelvisY: 0.45;
    shoulder: readonly [0.25, 0, 0.15];
    spineY: 0.48;
    wrist: readonly [0, 0, 0.4];
}

`Readonly`PEAK: {
    elbow: readonly [0, 0, -0.05];
    oppositeElbow: readonly [0, 0, 1.55];
    oppositeShoulder: readonly [-0.2, 0, -0.35];
    pelvisY: 0.49;
    shoulder: readonly [0.25, 0, 0.15];
    spineY: 0.52;
    wrist: readonly [0, 0, 0.45];
}

`Readonly`WINDUP: {
    elbow: readonly [0, 0, -1.75];
    pelvisY: -0.22;
    shoulder: readonly [-0.1, 0, -0.3];
    spineY: -0.28;
}

Korean

Settings

Variable PUNCH_PHASESConst

Type Declaration

ReadonlyCHAMBER: { elbow: readonly [0, 0, -1.65]; oppositeElbow: readonly [0, 0, 1.6]; oppositeShoulder: readonly [-0.5, 0, 0.3]; pelvisY: -0.25; shoulder: readonly [-0.15, 0, -0.2]; spineY: -0.2; wrist: readonly [0, 0, 0];}

ReadonlyEXTENSION: { elbow: readonly [0, 0, -0.09]; oppositeElbow: readonly [0, 0, 1.55]; oppositeShoulder: readonly [-0.2, 0, -0.35]; pelvisY: 0.45; shoulder: readonly [0.25, 0, 0.15]; spineY: 0.48; wrist: readonly [0, 0, 0.4];}

ReadonlyPEAK: { elbow: readonly [0, 0, -0.05]; oppositeElbow: readonly [0, 0, 1.55]; oppositeShoulder: readonly [-0.2, 0, -0.35]; pelvisY: 0.49; shoulder: readonly [0.25, 0, 0.15]; spineY: 0.52; wrist: readonly [0, 0, 0.45];}

ReadonlyWINDUP: { elbow: readonly [0, 0, -1.75]; pelvisY: -0.22; shoulder: readonly [-0.1, 0, -0.3]; spineY: -0.28;}

Korean

Settings

Variable PUNCH_PHASES`Const`

`Readonly`CHAMBER: {
elbow: readonly [0, 0, -1.65];
oppositeElbow: readonly [0, 0, 1.6];
oppositeShoulder: readonly [-0.5, 0, 0.3];
pelvisY: -0.25;
shoulder: readonly [-0.15, 0, -0.2];
spineY: -0.2;
wrist: readonly [0, 0, 0];
}

`Readonly`EXTENSION: {
elbow: readonly [0, 0, -0.09];
oppositeElbow: readonly [0, 0, 1.55];
oppositeShoulder: readonly [-0.2, 0, -0.35];
pelvisY: 0.45;
shoulder: readonly [0.25, 0, 0.15];
spineY: 0.48;
wrist: readonly [0, 0, 0.4];
}

`Readonly`PEAK: {
elbow: readonly [0, 0, -0.05];
oppositeElbow: readonly [0, 0, 1.55];
oppositeShoulder: readonly [-0.2, 0, -0.35];
pelvisY: 0.49;
shoulder: readonly [0.25, 0, 0.15];
spineY: 0.52;
wrist: readonly [0, 0, 0.45];
}

`Readonly`WINDUP: {
elbow: readonly [0, 0, -1.75];
pelvisY: -0.22;
shoulder: readonly [-0.1, 0, -0.3];
spineY: -0.28;
}