ViewmodelConfig.hpp

Go to the documentation of this file.

 
#pragma once
 
#include "ecs/components/Projectile.hpp"
#include "ecs/components/WeaponHoldPose.hpp"
 
#include <array>
#include <cstddef>
#include <glm/vec3.hpp>

struct ViewmodelParams
{
    float scale;
    float forward, right, down;
    float yawOffset, pitchOffset, rollOffset; // degrees
};

struct ThirdPersonWeaponParams
{
    float spineBendMultiplier = 1.0f;
    float hipLeanMultiplier = 0.1f;
    float recoilKickRad = 0.06f;
};

struct HandMountPoint
{
    glm::vec3 offset{0.0f};
    glm::vec3 rotationDegrees{0.0f};
};
 
inline constexpr std::size_t kHandFingerMountCount = 5;
inline constexpr std::array<const char*, kHandFingerMountCount> kHandFingerMountNames{
    "Thumb", "Index", "Middle", "Ring", "Pinky"};

struct FirstPersonArmMountSet
{
    glm::vec3 shoulderOffset{0.0f};
    glm::vec3 elbowOffset{0.0f};
    HandMountPoint palm;                                         
    std::array<HandMountPoint, kHandFingerMountCount> fingers{}; 
};

struct FirstPersonHandMountParams
{
    FirstPersonArmMountSet rightArm;
    FirstPersonArmMountSet leftArm;
    float scale = 45.0f;
};

struct WeaponSpawnerModelParams
{
    glm::vec3 scale{1.0f};
    glm::vec3 translation{0.0f};
    float yawOffset = 0.0f;
    float pitchOffset = 0.0f;
    float rollOffset = 0.0f;
    float spinDegreesPerSecond = 45.0f;
    float bobAmplitude = 6.0f;
    float bobHz = 0.6f;
};

struct WeaponModelInfo
{
    const char* filename;
    bool flipUVs;
};

struct RecoilParams
{
    float pitchKick = 3.0f;      
    float pushBack = 2.0f;       
    float rollKick = 1.0f;       
    float recoverySpeed = 12.0f; 
};

inline const ViewmodelParams& getViewmodelParams(WeaponType type)
{
    static constexpr std::array<ViewmodelParams, kRenderableWeaponTypeCount> k_params{{
        // Rifle — existing tuning
        {.scale = 10.0f,
         .forward = 18.0f,
         .right = 8.0f,
         .down = -4.0f,
         .yawOffset = 0.0f,
         .pitchOffset = -1.0f,
         .rollOffset = 0.0f},
        // Rocket — fallback to rifle tuning
        {.scale = 39.0f,
         .forward = 7.0f,
         .right = 27.0f,
         .down = 77.5f,
         .yawOffset = 0.0f,
         .pitchOffset = 0.0f,
         .rollOffset = 0.0f},
        // RailGun — marksman
        {.scale = 20.0f,
         .forward = 45.0f,
         .right = 27.0f,
         .down = 27.0f,
         .yawOffset = 0.0f,
         .pitchOffset = 0.0f,
         .rollOffset = 0.0f},
        // EnergyGun
        {.scale = 20.0f,
         .forward = 65.0f,
         .right = 35.0f,
         .down = 24.0f,
         .yawOffset = 0.0f,
         .pitchOffset = 0.0f,
         .rollOffset = 0.0f},
        // Shotgun
        {.scale = 75.0f,
         .forward = 54.5f,
         .right = 38.5f,
         .down = 24.0f,
         .yawOffset = 180.0f,
         .pitchOffset = 0.0f,
         .rollOffset = 0.0f},
    }};
 
    return k_params[static_cast<std::size_t>(type)];
}

inline const ThirdPersonWeaponParams& getThirdPersonWeaponParams(WeaponType type)
{
    static const std::array<ThirdPersonWeaponParams, kRenderableWeaponTypeCount> k_params{{
        // Rifle — middleweight, full spine bend, moderate recoil.
        {.spineBendMultiplier = 1.0f, .hipLeanMultiplier = 0.1f, .recoilKickRad = 0.05f},
        // Rocket launcher — heavy, slower upper-body response, big kick.
        {.spineBendMultiplier = 0.65f, .hipLeanMultiplier = 0.06f, .recoilKickRad = 0.18f},
        // RailGun / charge rifle — heavy precision rifle, slower bend, rifle-ish kick.
        {.spineBendMultiplier = 0.85f, .hipLeanMultiplier = 0.08f, .recoilKickRad = 0.07f},
        // EnergyGun — light pistol, fast spine bend, gentle kick.
        {.spineBendMultiplier = 1.0f, .hipLeanMultiplier = 0.1f, .recoilKickRad = 0.03f},
        // Shotgun — copies EnergyGun (same mesh); heavier kick.
        {.spineBendMultiplier = 1.0f, .hipLeanMultiplier = 0.1f, .recoilKickRad = 0.12f},
    }};
 
    return k_params[static_cast<std::size_t>(type)];
}

inline const WeaponHoldPose& getWeaponHoldPose(WeaponType type)
{
    using BoneAngles = std::array<glm::vec3, kArmHoldBoneCount>;
 
    // Shared finger curl (right = trigger hand, left = support hand wrapping the
    // foregrip). (pitch, yaw, roll) degrees; layout matches GripPose::index.
    static const std::array<glm::vec3, kGripPoseJointCount> k_rightFingers{{
        {30.0f, 20.0f, 0.0f}, {35.0f, 0.0f, 0.0f}, {25.0f, 0.0f, 0.0f}, {10.0f, 0.0f, 0.0f}, // thumb
        {25.0f, 0.0f, 0.0f},  {40.0f, 0.0f, 0.0f}, {35.0f, 0.0f, 0.0f}, {15.0f, 0.0f, 0.0f}, // index
        {55.0f, 0.0f, 0.0f},  {75.0f, 0.0f, 0.0f}, {70.0f, 0.0f, 0.0f}, {30.0f, 0.0f, 0.0f}, // middle
        {60.0f, 0.0f, 0.0f},  {80.0f, 0.0f, 0.0f}, {70.0f, 0.0f, 0.0f}, {30.0f, 0.0f, 0.0f}, // ring
        {60.0f, 0.0f, 0.0f},  {80.0f, 0.0f, 0.0f}, {70.0f, 0.0f, 0.0f}, {30.0f, 0.0f, 0.0f}, // pinky
    }};
    static const std::array<glm::vec3, kGripPoseJointCount> k_leftFingers{{
        {35.0f, -20.0f, 0.0f}, {40.0f, 0.0f, 0.0f}, {30.0f, 0.0f, 0.0f}, {10.0f, 0.0f, 0.0f}, // thumb
        {65.0f, 0.0f, 0.0f},   {80.0f, 0.0f, 0.0f}, {70.0f, 0.0f, 0.0f}, {30.0f, 0.0f, 0.0f}, // index
        {70.0f, 0.0f, 0.0f},   {85.0f, 0.0f, 0.0f}, {70.0f, 0.0f, 0.0f}, {30.0f, 0.0f, 0.0f}, // middle
        {70.0f, 0.0f, 0.0f},   {85.0f, 0.0f, 0.0f}, {70.0f, 0.0f, 0.0f}, {30.0f, 0.0f, 0.0f}, // ring
        {65.0f, 0.0f, 0.0f},   {85.0f, 0.0f, 0.0f}, {70.0f, 0.0f, 0.0f}, {30.0f, 0.0f, 0.0f}, // pinky
    }};
 
    auto make = [&](glm::vec3 offset, float scale, BoneAngles right, BoneAngles left, float yawDeg = 0.0f) {
        WeaponHoldPose p;
        p.spineOffset = offset;
        p.spineRotation = glm::angleAxis(glm::radians(yawDeg), glm::vec3(0.0f, 1.0f, 0.0f));
        p.scale = scale;
        p.rightArm.boneAngles = right;
        p.leftArm.boneAngles = left;
        p.rightArm.fingerAngles = k_rightFingers;
        p.leftArm.fingerAngles = k_leftFingers;
        return p;
    };
 
    static const std::array<WeaponHoldPose, kRenderableWeaponTypeCount> k_params{{
        // Rifle
        make({-21.0f, 23.5f, 66.25f},
             39.4f,
             {{{0.0f, 0.0f, 0.0f}, {0.0f, 0.0f, 44.0f}, {-107.0f, -7.0f, 13.0f}, {-1.0f, 24.0f, -41.0f}}},
             {{{24.0f, 0.0f, 0.0f}, {36.0f, 0.0f, 48.0f}, {71.0f, -3.0f, 6.0f}, {-11.0f, -46.0f, -23.0f}}}),
        // Rocket launcher
        make({-21.0f, -28.25f, 28.75f},
             39.4f,
             {{{0.0f, 0.0f, 0.0f}, {0.0f, 42.0f, 18.0f}, {-155.0f, 4.0f, 9.0f}, {6.0f, 106.0f, -62.0f}}},
             {{{24.0f, 0.0f, 0.0f}, {40.0f, -16.0f, 46.0f}, {103.0f, -3.0f, 5.0f}, {-6.0f, -57.0f, -41.0f}}}),
        // RailGun / charge rifle
        make({-21.0f, -18.0f, 66.25f},
             39.4f,
             {{{0.0f, 0.0f, 0.0f}, {0.0f, 0.0f, 44.0f}, {-107.0f, -7.0f, 13.0f}, {-1.0f, 24.0f, -41.0f}}},
             {{{24.0f, 0.0f, 0.0f}, {36.0f, 0.0f, 48.0f}, {71.0f, -3.0f, 6.0f}, {-11.0f, -46.0f, -23.0f}}}),
        // EnergyGun
        make({-21.0f, 3.25f, 80.0f},
             22.9f,
             {{{0.0f, -14.0f, 0.0f}, {0.0f, 0.0f, 35.0f}, {-120.0f, 5.0f, 7.0f}, {13.0f, 53.0f, -27.0f}}},
             {{{24.0f, 0.0f, 0.0f}, {36.0f, 0.0f, 48.0f}, {71.0f, -3.0f, 6.0f}, {-11.0f, -123.0f, -21.0f}}}),
        // Shotgun
        make({-21.0f, -7.75f, 80.0f},
             75.0f,
             {{{0.0f, -14.0f, 0.0f}, {0.0f, 0.0f, 35.0f}, {-120.0f, 5.0f, 7.0f}, {13.0f, 53.0f, -27.0f}}},
             {{{24.0f, 0.0f, 0.0f}, {36.0f, 0.0f, 48.0f}, {71.0f, -3.0f, 6.0f}, {-11.0f, -123.0f, -21.0f}}},
             180.0f),
    }};
 
    return k_params[static_cast<std::size_t>(type)];
}

inline const FirstPersonHandMountParams& getFirstPersonHandMountParams(WeaponType type)
{
    // Rifle defaults are the only hand-tuned first-person arm set. Every
    // other weapon reuses them until per-weapon tuning lands.
    static constexpr FirstPersonHandMountParams k_rifleFirstPerson{
        .rightArm = {.shoulderOffset = {20.0f, -22.0f, -38.0f},
                     .elbowOffset = {14.0f, -12.0f, -22.0f},
                     .palm = {.offset = {2.5f, -4.0f, -7.0f}, .rotationDegrees = {0.0f, 0.0f, 0.0f}},
                     .fingers = {{
                         {.offset = {0.5f, -2.8f, -5.0f}, .rotationDegrees = {0.0f, 0.0f, 0.0f}},
                         {.offset = {1.0f, -2.0f, -3.5f}, .rotationDegrees = {0.0f, 0.0f, 0.0f}},
                         {.offset = {2.0f, -2.3f, -4.0f}, .rotationDegrees = {0.0f, 0.0f, 0.0f}},
                         {.offset = {3.0f, -2.6f, -4.5f}, .rotationDegrees = {0.0f, 0.0f, 0.0f}},
                         {.offset = {4.0f, -2.9f, -5.0f}, .rotationDegrees = {0.0f, 0.0f, 0.0f}},
                     }}},
        .leftArm = {.shoulderOffset = {-28.0f, -23.0f, -24.0f},
                    .elbowOffset = {-20.0f, -13.0f, -4.0f},
                    .palm = {.offset = {-8.0f, -4.5f, 13.0f}, .rotationDegrees = {0.0f, 0.0f, 0.0f}},
                    .fingers = {{
                        {.offset = {-6.0f, -3.2f, 10.5f}, .rotationDegrees = {0.0f, 0.0f, 0.0f}},
                        {.offset = {-8.5f, -2.2f, 15.0f}, .rotationDegrees = {0.0f, 0.0f, 0.0f}},
                        {.offset = {-8.0f, -2.4f, 16.0f}, .rotationDegrees = {0.0f, 0.0f, 0.0f}},
                        {.offset = {-7.2f, -2.8f, 16.2f}, .rotationDegrees = {0.0f, 0.0f, 0.0f}},
                        {.offset = {-6.5f, -3.2f, 15.6f}, .rotationDegrees = {0.0f, 0.0f, 0.0f}},
                    }}},
        .scale = 45.0f};
    static const std::array<FirstPersonHandMountParams, kRenderableWeaponTypeCount> k_params{{
        // Rifle
        k_rifleFirstPerson,
        // Rocket — rifle defaults until tuned.
        k_rifleFirstPerson,
        // RailGun / charge rifle — rifle defaults until tuned.
        k_rifleFirstPerson,
        // EnergyGun — rifle defaults until tuned.
        k_rifleFirstPerson,
        // Shotgun — rifle defaults until tuned.
        k_rifleFirstPerson,
    }};
 
    return k_params[static_cast<std::size_t>(type)];
}

inline const WeaponSpawnerModelParams& getWeaponSpawnerModelParams(WeaponType type)
{
    static const WeaponSpawnerModelParams k_grenadeParams{
        .scale = {20.0f, 20.0f, 20.0f},
        .translation = {0.0f, 10.0f, 0.0f},
        .yawOffset = 0.0f,
        .pitchOffset = 0.0f,
        .rollOffset = 0.0f,
        .spinDegreesPerSecond = 45.0f,
        .bobAmplitude = 6.0f,
        .bobHz = 0.6f,
    };
    if (type == WeaponType::HEGrenade || type == WeaponType::Molotov || type == WeaponType::Sticky) {
        return k_grenadeParams;
    }
 
    static const std::array<WeaponSpawnerModelParams, kRenderableWeaponTypeCount> k_params{{
        // Rifle
        {.scale = {16.0f, 16.0f, 16.0f},
         .translation = {0.0f, 16.0f, 0.0f},
         .yawOffset = 0.0f,
         .pitchOffset = 0.0f,
         .rollOffset = 0.0f,
         .spinDegreesPerSecond = 45.0f,
         .bobAmplitude = 6.0f,
         .bobHz = 0.6f},
        // Rocket
        {.scale = {15.0f, 15.0f, 15.0f},
         .translation = {0.0f, -25.0f, -4.0f},
         .yawOffset = 0.0f,
         .pitchOffset = 0.0f,
         .rollOffset = 0.0f,
         .spinDegreesPerSecond = 45.0f,
         .bobAmplitude = 6.0f,
         .bobHz = 0.6f},
        // RailGun
        {.scale = {15.0f, 15.0f, 15.0f},
         .translation = {0.0f, -5.0f, 0.0f},
         .yawOffset = 0.0f,
         .pitchOffset = 0.0f,
         .rollOffset = 0.0f,
         .spinDegreesPerSecond = 45.0f,
         .bobAmplitude = 6.0f,
         .bobHz = 0.6f},
        // EnergyGun
        {.scale = {10.0f, 10.0f, 10.0f},
         .translation = {0.0f, 2.0f, 0.0f},
         .yawOffset = 0.0f,
         .pitchOffset = 0.0f,
         .rollOffset = 0.0f,
         .spinDegreesPerSecond = 45.0f,
         .bobAmplitude = 6.0f,
         .bobHz = 0.6f},
        // Shotgun
        {.scale = {30.0f, 30.0f, 30.0f},
         .translation = {0.0f, 2.0f, 0.0f},
         .yawOffset = 0.0f,
         .pitchOffset = 0.0f,
         .rollOffset = 0.0f,
         .spinDegreesPerSecond = 45.0f,
         .bobAmplitude = 6.0f,
         .bobHz = 0.6f},
    }};
 
    return k_params[static_cast<std::size_t>(type)];
}

inline WeaponModelInfo getWeaponModelInfo(WeaponType type)
{
    static constexpr std::array<WeaponModelInfo, kRenderableWeaponTypeCount> k_infos{{
        {.filename = "assault_rifle.glb", .flipUVs = true},
        {.filename = "rocket_launcher.glb", .flipUVs = true},
        {.filename = "rail_gun.glb", .flipUVs = true},
        {.filename = "energy_gun.glb", .flipUVs = true},
        {.filename = "shotgun.glb", .flipUVs = true},
    }};
    return k_infos[static_cast<std::size_t>(type)];
}

inline const RecoilParams& getRecoilParams(WeaponType type)
{
    static constexpr std::array<RecoilParams, kRenderableWeaponTypeCount> k_params{{
        // Rifle
        {.pitchKick = -2.0f, .pushBack = 6.0f, .rollKick = 0.5f, .recoverySpeed = 14.0f},
        // Rocket
        {.pitchKick = -3.0f, .pushBack = 16.5f, .rollKick = 2.0f, .recoverySpeed = 6.0f},
        // RailGun
        {.pitchKick = -6.0f, .pushBack = 11.0f, .rollKick = 1.0f, .recoverySpeed = 6.0f},
        // EnergyGun
        {.pitchKick = 6.0f, .pushBack = 4.0f, .rollKick = 1.5f, .recoverySpeed = 7.0f},
        // Shotgun
        {.pitchKick = 9.0f, .pushBack = 6.0f, .rollKick = 1.0f, .recoverySpeed = 5.0f},
    }};
 
    return k_params[static_cast<std::size_t>(type)];
}