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

    Interface BalancePlayerState

    Extended player state with balance system data.

    Extends PlayerState with additional balance-specific tracking.

    interface BalancePlayerState {
        accuracy?: number;
        activeEffects: readonly string[];
        archetype: PlayerArchetype;
        attackPower: number;
        balance: number;
        bodyFacing?: BodyFacing;
        bodyPartHealth?: BodyPartHealth;
        bodyPartMaxHealth?: BodyPartMaxHealth;
        combatState: CombatState;
        comboCount?: number;
        consciousness: number;
        currentStance: TrigramStance;
        defense: number;
        energy: number;
        experiencePoints?: number;
        grappleControl?: GrappleControl | null;
        health: number;
        hitsLanded: number;
        hitsTaken: number;
        id: string;
        isBlocking: boolean;
        isCountering: boolean;
        isStunned: boolean;
        ki: number;
        lastActionTime: number;
        lastHelplessStateTime?: number;
        lastStanceChangeTime: number;
        losses?: number;
        matchesWon?: number;
        maxCombo?: number;
        maxEnergy: number;
        maxHealth: number;
        maxKi: number;
        maxStamina: number;
        misses?: number;
        momentum: number;
        name: KoreanText;
        pain: number;
        perfectStrikes: number;
        physicalAttributes?: PhysicalAttributes;
        position: Position;
        rank?: string;
        rapidChangePenaltyEnd?: number;
        recentHitTimestamps?: readonly number[];
        recoveryTime: number;
        roundsWon?: number;
        speed: number;
        stamina: number;
        stanceChangeHistory?: readonly StanceChangeRecord[];
        stanceSide?: "orthodox" | "southpaw";
        statusEffects: readonly StatusEffect[];
        technique: number;
        totalDamageDealt: number;
        totalDamageReceived: number;
        transitionState?: TransitionState;
        vitalPointHits: number;
        vitalPoints: readonly {
            damage: number;
            id: string;
            isHit: boolean;
            lastHitTime: number;
        }[];
        wins?: number;
    }

    Hierarchy (View Summary)

    Index

    Properties

    accuracy? activeEffects archetype attackPower balance bodyFacing? bodyPartHealth? bodyPartMaxHealth? combatState comboCount? consciousness currentStance defense energy experiencePoints? grappleControl? health hitsLanded hitsTaken id isBlocking isCountering isStunned ki lastActionTime lastHelplessStateTime? lastStanceChangeTime losses? matchesWon? maxCombo? maxEnergy maxHealth maxKi maxStamina misses? momentum name pain perfectStrikes physicalAttributes? position rank? rapidChangePenaltyEnd? recentHitTimestamps? recoveryTime roundsWon? speed stamina stanceChangeHistory? stanceSide? statusEffects technique totalDamageDealt totalDamageReceived transitionState? vitalPointHits vitalPoints wins?

    Properties

    accuracy?: number

    Overall accuracy percentage

    activeEffects: readonly string[]

    IDs of currently active effects

    archetype: PlayerArchetype

    Player combat archetype (무사, 암살자, etc.)

    attackPower: number

    Base attack damage multiplier

    balance: number

    Physical balance and stability

    bodyFacing?: BodyFacing

    Body facing direction for opponent tracking

    bodyPartHealth?: BodyPartHealth

    Body part-specific health tracking (신체부위 체력)

    bodyPartMaxHealth?: BodyPartMaxHealth

    Maximum health for each body part

    combatState: CombatState

    Current combat action state

    comboCount?: number

    Current combo chain length

    consciousness: number

    Consciousness level (0 = unconscious)

    currentStance: TrigramStance

    Current Eight Trigram stance

    defense: number

    Damage reduction and blocking effectiveness

    energy: number

    Current energy (action points)

    experiencePoints?: number

    Experience points earned

    grappleControl?: GrappleControl | null

    Active grapple control state (잡기 제어)

    health: number

    Current health points (0 = defeated) - aggregate of body part health

    hitsLanded: number

    Number of hits successfully landed

    hitsTaken: number

    Number of hits received

    id: string

    Unique player identifier

    isBlocking: boolean

    Whether player is actively blocking

    isCountering: boolean

    Whether player is executing a counter-attack

    isStunned: boolean

    Whether player is stunned (cannot act)

    ki: number

    Current Ki (氣) spiritual energy

    lastActionTime: number

    Timestamp of last action performed

    lastHelplessStateTime?: number

    Timestamp when player last entered HELPLESS state

    lastStanceChangeTime: number

    Timestamp of last stance transition

    losses?: number

    Total career losses

    matchesWon?: number

    Total matches won (career)

    maxCombo?: number

    Maximum combo achieved this match

    maxEnergy: number

    Maximum energy capacity

    maxHealth: number

    Maximum health capacity

    maxKi: number

    Maximum Ki capacity

    maxStamina: number

    Maximum stamina capacity

    misses?: number

    Number of missed attacks

    momentum: number

    Combat momentum for combo bonuses

    name: KoreanText

    Bilingual Korean-English player name

    pain: number

    Current pain level (reduces effectiveness)

    perfectStrikes: number

    Number of perfect accuracy strikes

    physicalAttributes?: PhysicalAttributes

    Physical body attributes affecting combat calculations. Korean: 신체 속성 (Body Attributes)

    These attributes determine reach, movement speed, damage output, defense capability, and stamina based on realistic body dimensions and composition. Loaded from archetype defaults on player creation.

    position: Position

    Position in combat arena

    rank?: string

    Player ranking (e.g., "Bronze", "Silver")

    rapidChangePenaltyEnd?: number

    Rapid change penalty end timestamp

    recentHitTimestamps?: readonly number[]

    Timestamps of recent hits for balance state tracking (last 10 hits)

    recoveryTime: number

    Time required before next action available

    roundsWon?: number

    Rounds won this match

    speed: number

    Action speed and dodge capability

    stamina: number

    Current stamina (physical endurance)

    stanceChangeHistory?: readonly StanceChangeRecord[]

    Stance change history (last 5 changes)

    stanceSide?: "orthodox" | "southpaw"

    Stance side for combat positioning

    Orthodox: left foot forward (traditional right-handed fighter) Southpaw: right foot forward (traditional left-handed fighter)

    Korean: 자세방향 (Stance Side)

    statusEffects: readonly StatusEffect[]

    Active status effects (poison, stun, etc.)

    technique: number

    Precision for vital point targeting

    totalDamageDealt: number

    Total damage dealt this match

    totalDamageReceived: number

    Total damage received this match

    transitionState?: TransitionState

    Stance transition state

    vitalPointHits: number

    Number of successful vital point strikes

    vitalPoints: readonly {
        damage: number;
        id: string;
        isHit: boolean;
        lastHitTime: number;
    }[]

    State of player's vital points (for defense)

    wins?: number

    Total career wins

    Settings

    Member Visibility

    On This Page

    Properties