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

    Class GrappleSystem

    Grappling System for control and hold mechanics.

    Korean: 잡기 시스템 (Grapple System)

    Manages grappling state between combatants, including grip strength, control duration, escape mechanics, and follow-up techniques.

    Index

    Constructors

    constructor

    Methods

    applyPostThrowAdvantage attemptEscape attemptGrapple calculateEscapeChance calculateGrappleSuccessChance calculateGripStrength calculateStaminaCost canTransitionToJointLock canTransitionToThrow getTechniqueControlDuration updateGrapple

    Properties

    config

    Constructors

    Methods

    • Apply post-throw control advantage window.

      Korean: 던지기 후 우세 적용 (Apply Post-Throw Advantage)

      Creates a control advantage state after a successful throw, using the technique's controlDuration to determine how long the attacker maintains positional dominance.

      Advantage Effects:

      • Attacker gains priority for follow-up attacks
      • Defender must wait for control duration to expire
      • Applies to throw transitions from grapple control

      Parameters

      • technique: KoreanTechnique

        Throw technique executed

      • attackerId: string

        Player who executed throw

      • defenderId: string

        Player who was thrown

      • currentTime: number

        Current game time in milliseconds

      Returns {
          controllerId: string;
          duration: number;
          endTime: number;
          startTime: number;
          targetId: string;
      }

      Control advantage state with duration from technique metadata

      const advantage = grappleSystem.applyPostThrowAdvantage(
        ssireumThrowTechnique,
        "player1",
        "player2",
        Date.now()
      );
      // advantage.duration = 1800ms (from technique metadata)

      던지기후우세적용

    • Check if a grapple can be transitioned to a joint lock.

      Korean: 관절기 전환 확인 (Check Joint Lock Transition)

      Parameters

      Returns boolean

      Whether joint lock transition is possible

    • Check if a grapple can be transitioned to a throw.

      Korean: 던지기 전환 확인 (Check Throw Transition)

      Parameters

      Returns boolean

      Whether throw transition is possible

    • Get technique-specific control duration from Gon metadata.

      Korean: 기술별 제어 시간 조회 (Get Technique Control Duration)

      Retrieves the post-throw positional advantage duration from ExtendedGonTechnique metadata. Falls back to default duration if technique doesn't have Gon-specific enhancements.

      Control Duration Philosophy:

      • Traditional Ssireum techniques (800-2000ms) provide longer control
      • Aggressive slam techniques (800-1200ms) provide brief control
      • Sacrifice throws (1500-2000ms) provide extended ground control

      Use Cases:

      • Determining follow-up attack windows after throws
      • Calculating defender recovery time before counterattack
      • Applying post-throw positional advantage in game state

      Parameters

      • technique: KoreanTechnique

        Korean martial arts technique (checks for ExtendedGonTechnique)

      • defaultDuration: number = 1000

        Fallback duration if technique has no metadata (default: 1000ms)

      Returns number

      Control duration in milliseconds

      const controlTime = grappleSystem.getTechniqueControlDuration(
        ssireumThrowTechnique, // controlDuration: 1800
        1000 // default fallback
      );
      // Result: 1800ms (uses technique metadata)

      기술별제어시간조회

    Properties

    config: GrappleConfig

    Settings

    Member Visibility

    On This Page

    Constructors
    Methods
    Properties