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

    Enumeration AnimationState

    Animation states for player characters (애니메이션 상태)

    Enum-based animation state system for type safety and IDE autocomplete. Each state includes Korean terminology and timing specifications.

    Based on game-design.md specifications:

    • Attack: 12 frames (200ms at 60fps)
    • Block: 4 frames (67ms at 60fps)
    • Walk: 6 frames (100ms at 60fps)
    • Stance transitions: 36 frames (600ms at 60fps)
    • Tactical steps: 18 frames (300ms at 60fps, 30cm distance)

    애니메이션상태

    Index

    Enumeration Members

    ATTACK: "attack"

    Attack - Generic attack animation Korean: 공격 (gonggyeok) - Attack Duration: 12 frames (200ms)

    DEFEND: "defend"

    Defend - Basic block/defense Korean: 방어 (bangeo) - Defense Duration: 4 frames (67ms)

    DEFEND_BLOCK_SUCCESS: "defend_block_success"

    Defend Block Success - Successful block, absorb impact Korean: 막기 (makgi) - Block successfully Duration: 8 frames (133ms)

    DEFEND_GUARD_BREAK: "defend_guard_break"

    Defend Guard Break - Guard break, defensive stance destroyed Korean: 방어붕괴 (bangeo bunggoe) - Guard broken Duration: 15 frames (250ms)

    DEFEND_PARRY: "defend_parry"

    Defend Parry - Parry deflection, redirect attack Korean: 받아넘기기 (badaneumgigi) - Parry deflect Duration: 10 frames (167ms)

    DEFEND_RECOVERY: "defend_recovery"

    Defend Recovery - Guard recovery, restore defensive posture Korean: 방어복구 (bangeo bokgu) - Guard recovery Duration: 12 frames (200ms)

    FALL_BACKWARD: "fall_backward"

    Fall Backward - Backward fall animation Korean: 후방낙법 (hubang nakbeop) - Backward falling technique Duration: 30 frames (500ms)

    FALL_FORWARD: "fall_forward"

    Fall Forward - Forward fall animation Korean: 전방낙법 (jeonbang nakbeop) - Forward falling technique Duration: 24 frames (400ms)

    FALL_SIDE_LEFT: "fall_side_left"

    Fall Side Left - Left side fall animation Korean: 좌측낙법 (jwacheuk nakbeop) - Left side falling technique Duration: 27 frames (450ms)

    FALL_SIDE_RIGHT: "fall_side_right"

    Fall Side Right - Right side fall animation Korean: 우측낙법 (ucheuk nakbeop) - Right side falling technique Duration: 27 frames (450ms)

    FOOTWORK_CIRCULAR_LEFT: "footwork_circular_left"

    Footwork Circular Left - Circular step maintaining guard (left) Korean: 원형보 좌 (wonhyeongbo jwa) - Circular step left Duration: 18 frames (300ms), Distance: 30cm

    FOOTWORK_CIRCULAR_RIGHT: "footwork_circular_right"

    Footwork Circular Right - Circular step maintaining guard (right) Korean: 원형보 우 (wonhyeongbo u) - Circular step right Duration: 18 frames (300ms), Distance: 30cm

    FOOTWORK_PIVOT_LEFT: "footwork_pivot_left"

    Footwork Pivot Left - Pivot rotation on planted foot (left) Korean: 축족회전 좌 (chukjok hoejeon jwa) - Pivot rotation left Duration: 15 frames (250ms), Rotation: 90°

    FOOTWORK_PIVOT_RIGHT: "footwork_pivot_right"

    Footwork Pivot Right - Pivot rotation on planted foot (right) Korean: 축족회전 우 (chukjok hoejeon u) - Pivot rotation right Duration: 15 frames (250ms), Rotation: 90°

    FOOTWORK_SHUFFLE: "footwork_shuffle"

    Footwork Shuffle - Quick micro-adjustment Korean: 섞음보 (seokkeumbo) - Shuffle step Duration: 6 frames (100ms), Distance: 15cm

    FOOTWORK_SLIDE_BACK: "footwork_slide_back"

    Footwork Slide Back - Both feet slide together (back) Korean: 미끄럼보 후 (mikkeureombo hu) - Sliding step back Duration: 12 frames (200ms), Distance: 30cm

    FOOTWORK_SLIDE_FORWARD: "footwork_slide_forward"

    Footwork Slide Forward - Both feet slide together (forward) Korean: 미끄럼보 전 (mikkeureombo jeon) - Sliding step forward Duration: 12 frames (200ms), Distance: 30cm

    FOOTWORK_SLIDE_LEFT: "footwork_slide_left"

    Footwork Slide Left - Both feet slide together (left) Korean: 미끄럼보 좌 (mikkeureombo jwa) - Sliding step left Duration: 12 frames (200ms), Distance: 30cm

    FOOTWORK_SLIDE_RIGHT: "footwork_slide_right"

    Footwork Slide Right - Both feet slide together (right) Korean: 미끄럼보 우 (mikkeureombo u) - Sliding step right Duration: 12 frames (200ms), Distance: 30cm

    GRAPPLE_CONTROL: "grapple_control"

    Grapple Control - Maintain grip control Korean: 잡기 유지 (japgi yuji) - Maintaining grip Duration: Loop (breathing animation ~4 frames)

    Active control state where attacker maintains grip on defender. Looping animation with subtle struggle movements. Stamina cost: 5/second (default)

    GRAPPLE_ENTRY

    GRAPPLE_ENTRY: "grapple_entry"

    Grapple Entry - Establish grip connection Korean: 잡기 연결 (japgi yeongyeol) - Grab connection Duration: 8 frames (133ms)

    Initiates the grappling sequence when attacker successfully grabs defender. Transition from IDLE/ATTACK state to establishing physical control.

    GRAPPLE_ESCAPE: "grapple_escape"

    Grapple Escape - Successful escape from grapple Korean: 탈출 성공 (talchul seonggong) - Successful escape Duration: 15 frames (250ms)

    Defender breaks free and creates distance from attacker. Returns to IDLE state upon completion. Provides invulnerability frames during escape animation.

    GRAPPLE_STRUGGLE: "grapple_struggle"

    Grapple Struggle - Escape attempt animation Korean: 탈출 시도 (talchul sido) - Escape attempts Duration: 12 frames (200ms)

    Defender animation when attempting to break free from grapple. Shows strain and resistance movements. Stamina cost: 15 per attempt

    GROUND_PRONE: "ground_prone"

    Ground Prone - Face-down ground position Korean: 엎드림 (eopdeurim) - Face down position Duration: 4 frames (breathing loop)

    GROUND_SIDE_LEFT: "ground_side_left"

    Ground Side Left - Left side ground position Korean: 좌측와 (jwacheuk wa) - Left side position Duration: 4 frames (breathing loop)

    GROUND_SIDE_RIGHT: "ground_side_right"

    Ground Side Right - Right side ground position Korean: 우측와 (ucheuk wa) - Right side position Duration: 4 frames (breathing loop)

    GROUND_SUPINE: "ground_supine"

    Ground Supine - Face-up ground position Korean: 누움 (nuum) - Face up position Duration: 4 frames (breathing loop)

    HIT: "hit"

    Hit - Taking damage animation Korean: 피격 (pigyeok) - Being hit Duration: 4 frames (67ms)

    IDLE: "idle"

    Idle stance - Default breathing animation Korean: 대기 (daegi) - Standing ready Duration: 4 frames (67ms)

    KO: "ko"

    KO - Knockout/death animation Korean: 기절 (gijeol) - Knockout Duration: 30 frames (500ms)

    RECOVERY_DEFENSIVE: "recovery_defensive"

    Recovery Defensive - Defensive getup with guard Korean: 방어기상 (bangeo gisang) - Defensive getup Duration: 42 frames (700ms), Damage reduction: 50%

    RECOVERY_PRONE_STANDUP: "recovery_prone_standup"

    Recovery Prone Standup - Stand up from prone position Korean: 엎드린 기상 (eopdeurin gisang) - Prone stand-up Duration: 30 frames (500ms)

    RECOVERY_ROLL: "recovery_roll"

    Recovery Roll - Roll recovery to standing Korean: 회전기상 (hoejeon gisang) - Roll recovery Duration: 24 frames (400ms), Stamina cost: 20

    RECOVERY_SUPINE_STANDUP: "recovery_supine_standup"

    Recovery Supine Standup - Stand up from supine position Korean: 누운 기상 (nuun gisang) - Supine stand-up Duration: 36 frames (600ms)

    RUN: "run"

    Run - Fast movement animation Korean: 달리기 (dalligi) - Running Duration: 8 frames (133ms)

    STANCE_CHANGE: "stance_change"

    Stance Change - Trigram stance transition Korean: 자세변경 (jaseybyeongyeong) - Stance change Duration: 36 frames (600ms)

    STANCE_GUARD_GAM: "stance_guard_gam"

    Stance Guard Gam - ☵ Water stance guard Korean: 감괘수비 (gam-goe subi) - Water guard Duration: 6 frames (breathing loop)

    STANCE_GUARD_GAN: "stance_guard_gan"

    Stance Guard Gan - ☶ Mountain stance guard Korean: 간괘수비 (gan-goe subi) - Mountain guard Duration: 4 frames (breathing loop)

    STANCE_GUARD_GEON: "stance_guard_geon"

    Stance Guard Geon - ☰ Heaven stance guard Korean: 건괘수비 (geon-goe subi) - Heaven guard Duration: 6 frames (breathing loop)

    STANCE_GUARD_GON: "stance_guard_gon"

    Stance Guard Gon - ☷ Earth stance guard Korean: 곤괘수비 (gon-goe subi) - Earth guard Duration: 5 frames (breathing loop)

    STANCE_GUARD_JIN: "stance_guard_jin"

    Stance Guard Jin - ☳ Thunder stance guard Korean: 진괘수비 (jin-goe subi) - Thunder guard Duration: 5 frames (breathing loop)

    STANCE_GUARD_LI: "stance_guard_li"

    Stance Guard Li - ☲ Fire stance guard Korean: 리괘수비 (li-goe subi) - Fire guard Duration: 4 frames (breathing loop)

    STANCE_GUARD_SON: "stance_guard_son"

    Stance Guard Son - ☴ Wind stance guard Korean: 손괘수비 (son-goe subi) - Wind guard Duration: 6 frames (breathing loop)

    STANCE_GUARD_TAE: "stance_guard_tae"

    Stance Guard Tae - ☱ Lake stance guard Korean: 태괘수비 (tae-goe subi) - Lake guard Duration: 6 frames (breathing loop)

    STANCE_SIDE_SWITCH: "stance_side_switch"

    Stance Side Switch - Left↔right stance mirror Korean: 좌우전환 (jwaujeonhwan) - Left-right switch Duration: 24 frames (400ms)

    STEP_BACK: "step_back"

    Step Back - Retreat tactical step Korean: 후퇴보법 (hutoe bobeop) - Retreat step Duration: 18 frames (300ms), Distance: 30cm

    STEP_BACK_LEFT: "step_back_left"

    Step Back Left - Back-left diagonal step Korean: 후좌측보법 (hu jwacheuk bobeop) - Back-left diagonal Duration: 18 frames (300ms), Distance: 30cm

    STEP_BACK_RIGHT: "step_back_right"

    Step Back Right - Back-right diagonal step Korean: 후우측보법 (hu ucheuk bobeop) - Back-right diagonal Duration: 18 frames (300ms), Distance: 30cm

    STEP_FORWARD: "step_forward"

    Step Forward - Forward tactical step Korean: 전진보법 (jeonjin bobeop) - Forward step Duration: 18 frames (300ms), Distance: 30cm

    STEP_FORWARD_LEFT: "step_forward_left"

    Step Forward Left - Forward-left diagonal step Korean: 전좌측보법 (jeon jwacheuk bobeop) - Forward-left diagonal Duration: 18 frames (300ms), Distance: 30cm

    STEP_FORWARD_RIGHT: "step_forward_right"

    Step Forward Right - Forward-right diagonal step Korean: 전우측보법 (jeon ucheuk bobeop) - Forward-right diagonal Duration: 18 frames (300ms), Distance: 30cm

    STEP_LEFT: "step_left"

    Step Left - Left side tactical step Korean: 좌측면보법 (jwacheuk myeon bobeop) - Left side step Duration: 18 frames (300ms), Distance: 30cm

    STEP_RIGHT: "step_right"

    Step Right - Right side tactical step Korean: 우측면보법 (ucheuk myeon bobeop) - Right side step Duration: 18 frames (300ms), Distance: 30cm

    TURN_LEFT: "turn_left"

    Turn Left - 180° turn left animation Korean: 좌회전 (jwahoejeon) - Left turn Duration: 12 frames (200ms), Rotation: 180°

    TURN_RIGHT: "turn_right"

    Turn Right - 180° turn right animation Korean: 우회전 (uhoejeon) - Right turn Duration: 12 frames (200ms), Rotation: 180°

    WALK: "walk"

    Walk - Normal walking movement Korean: 보행 (bohaeng) - Walking Duration: 6 frames (100ms)