ShotLog.hpp

Go to the documentation of this file.

 
#pragma once
 
#include <cstdint>
 
namespace group2::perf::shotlog
{

inline constexpr std::uint16_t k_missClientId = 0xFFFFu;

void openIfRequested();

struct ShotResolution
{
    std::uint16_t shooterClientId = 0;
    std::uint32_t shotInputTick = 0;
    std::uint16_t hitClientId = k_missClientId;
    float hitX = 0.0f;
    float hitY = 0.0f;
    float hitZ = 0.0f;
    int hitRegion = 0;
 
    // PR-22: shot ray (server's view).
    float originX = 0.0f;
    float originY = 0.0f;
    float originZ = 0.0f;
    float dirX = 0.0f;
    float dirY = 0.0f;
    float dirZ = 0.0f;
 
    // PR-22: lag-comp diagnostics — read off the shooter's
    // `LagCompTarget` component so the analyzer can bucket shots by
    // RTT and rewind size without joining against per-client net
    // stats.
    std::uint16_t shooterRttMs = 0;
    std::uint16_t lagCompTicks = 0;
 
    // PR-22: hit target rewound vs current centre.  When the shooter
    // had a non-zero `LagCompTarget`, the rewinder swapped the hit
    // target's capsules to the historical sample; the centroid of
    // those capsules at log-time is `(rewoundX, rewoundY, rewoundZ)`.
    // The current centre is `Position.value` of the same entity (the
    // rewinder doesn't touch `Position`).  Diff between the two
    // numbers = how far the lag-comp moved the target backwards in
    // time.  All zeros on miss.
    float hitTargetRewoundX = 0.0f;
    float hitTargetRewoundY = 0.0f;
    float hitTargetRewoundZ = 0.0f;
    float hitTargetCurrentX = 0.0f;
    float hitTargetCurrentY = 0.0f;
    float hitTargetCurrentZ = 0.0f;
 
    // PR-27 (netsync): client-asserted animation-state telemetry.
    // Populated when the shooter's SHOT_INTENT was paired with this
    // shot at resolution time; otherwise the columns stay zero/sentinel.
    //   * `clientIntentTargetClientId` — who the client thought it was
    //     shooting at; `0xFFFF` if the SHOT_INTENT wasn't received
    //     (UDP loss) or the client wasn't aiming at anyone close.
    //   * `animStateDelta` — `anim_snapshot::delta` between the
    //     client's reported anim state and the server's historical
    //     anim state for the same target at the rewound tick.  `0`
    //     means perfect agreement; `> ~0.10` means visibly drifted.
    //     Only meaningful when both ids match (server hit the target
    //     the client claimed to be aiming at).
    //   * `clientIntentReceived` — `1` when SHOT_INTENT was paired,
    //     `0` when not.  Lets the analyzer compute "% of shots with
    //     client intent" without needing to look at sentinel values.
    std::uint16_t clientIntentTargetClientId = k_missClientId;
    float animStateDelta = 0.0f;
    int clientIntentReceived = 0;
};

void recordShotResolution(const ShotResolution& shot);

void close() noexcept;
 
} // namespace group2::perf::shotlog