PlayerSimState.hpp

Go to the documentation of this file.

 
#pragma once
 
#include "PlayerVisState.hpp" // for PlayerStateRef + transitively PlayerStateEnums
#include "ecs/physics/KccFrameResult.hpp"
#include "ecs/physics/TriMeshCollision.hpp"
 
#include <cstdint>
#include <glm/vec2.hpp>
#include <glm/vec3.hpp>

struct PlayerSimState
{
    // ── Jump state ─────────────────────────────────────────────────────────
    bool canDoubleJump{true};     
    bool jumpedThisTick{false};   
    bool jumpHeldLastTick{false}; 
    float jumpCooldown{0.0f};     
 
    // ── Coyote time ────────────────────────────────────────────────────────
    float coyoteTimer{0.0f};      
    bool wasGroundedLastTick{false};
    float groundedDuration{0.0f}; 
 
    // ── Jump lurch ─────────────────────────────────────────────────────────
    bool jumpLurchEnabled{false};     
    float jumpLurchTimer{0.0f};       
    glm::vec2 moveInputsOnJump{0.0f}; 
 
    // ── Sliding ────────────────────────────────────────────────────────────
    float slideTimer{0.0f};         
    int slideFatigueCounter{0};     
    float slideBoostCooldown{0.0f}; 
    int slideFatigueDecayAccum{0};  
    bool canEnterSlide{true};       
 
    // ── Wallrunning ────────────────────────────────────────────────────────
    glm::vec3 wallNormal{0.0f};         
    glm::vec3 wallForward{0.0f};        
    glm::vec3 wallAnchor{0.0f};         
    float wallRunTimer{0.0f};           
    float wallRunSpeedTimer{0.0f};      
    float exitWallTimer{0.0f};          
    uint32_t wallMeshIndex{UINT32_MAX}; 
    uint32_t wallTriId{UINT32_MAX};     
    physics::TriRegion wallRegion{physics::TriRegion::Face}; 
    bool wallAttachmentValid{false};          
    bool wallCornerTransitionActive{false};   
    glm::vec3 wallCornerAnchor{0.0f};         
    glm::vec3 wallCornerFromNormal{0.0f};     
    glm::vec3 wallCornerFromForward{0.0f};    
    glm::vec3 wallCornerToNormal{0.0f};       
    glm::vec3 wallCornerToForward{0.0f};      
    uint32_t wallCornerMeshIndex{UINT32_MAX}; 
    uint32_t wallCornerTriId{UINT32_MAX};     
    physics::TriRegion wallCornerRegion{physics::TriRegion::Face}; 
    float wallCornerTimer{0.0f};                                   
    glm::vec3 wallCornerIgnoreNormal{0.0f}; 
    float wallCornerIgnoreTimer{0.0f};      
    bool wallrunBlockerActive{false}; 
    glm::vec3 wallrunBlockerNormal{0.0f};       
    float wallrunBlockerTimer{0.0f};            
    int wallrunBlockedFrames{0};                
    float wallrunCeilingConstrainedTimer{0.0f}; 
    bool wasWallRunning{false};                 
    glm::vec3 pendingKccCorrection{0.0f};       
 
    physics::KccFrameResult lastKccResult{};    
    bool hasLastKccResult{false};               
    glm::vec3 kccPreviousPosBefore{0.0f};       
    glm::vec3 kccPreviousPosAfter{0.0f};        
    glm::vec3 kccPreviousDepenDelta{0.0f};      
    bool kccPreviousFrameValid{false};          
    int kccOscillationFrames{0};                
 
    // Wall blacklist: stores the last wall's normal + height to prevent regrab.
    glm::vec3 wallBlacklistNormal{0.0f};
    float wallBlacklistHeight{-1e10f};
    bool wallBlacklistActive{false};
 
    // ── Collision recovery ─────────────────────────────────────────────────
    glm::vec3 lastSafePosition{0.0f}; 
    bool lastSafePositionValid{false};
 
    // ── Grappling hook (Widowmaker-style: direct pull, look-biased launch) ─
    bool grappleCooldownActive{false}; 
    float grappleCooldownTimer{0.0f};  
    float grapplePullTimer{0.0f};      
    glm::vec3 grapplePullDir{0.0f};    
    bool grappleInputLastTick{false};  
 
    // ── Grapple perch mode (hold jump while grappling → arc above hook) ─
    // No state needed: the trajectory is computed each tick purely from
    // current Position + replicated grapplePoint, so it stays in sync
    // across server simulation, client prediction, and reconciliation
    // replay (PlayerSimState is server-only, so anything stateful here
    // would drift on every snapshot apply and cause visible jitter).
};

struct PlayerStateRef
{
    PlayerVisState& vis;
    PlayerSimState& sim;
};

struct ConstPlayerStateRef
{
    const PlayerVisState& vis;
    const PlayerSimState& sim;
};