Stamina
Description
Stamina changes how much stamina characters have, how carried weight affects the cap and how movement, melee and holding breath consume or recover stamina.
Configuration
Default configuration
Stamina.json
json
{
"m_Enable": 0,
"m_StaminaMax": 100.0,
"m_StaminaMinCap": 5.0,
"m_Cargo": {
"m_Infinity": 0,
"m_WeightLimitThreshold": 6000.0,
"m_KgToGrams": 1000.0,
"m_KgToPercentPenalty": 1.75
},
"m_Gain": {
"m_Jog": 2.0,
"m_Walk": 4.0,
"m_Idle": 5.0,
"m_Swim": 1.0,
"m_Ladder": 1.0,
"m_Sprint": 0.0,
"m_Roll": 0.0
},
"m_Drain": {
"m_StandingSprint": 4.0,
"m_CrouchedSprint": 1.0,
"m_SwimFast": 5.0,
"m_LadderFast": 8.0
},
"m_Consumers": {
"m_HoldBreathThresholdActivate": 10.0,
"m_HoldBreathThresholdDrain": 0.0,
"m_JumpThreshold": 25.0,
"m_VaultThreshold": 20.0,
"m_ClimbThreshold": 42.0,
"m_MeleeHeavyThreshold": 25.0,
"m_MeleeEvadeThreshold": 8.0,
"m_RollThreshold": 5.0
},
"m_Modifiers": {
"m_DrainHoldBreathStart": 0.2,
"m_DrainHoldBreathExponent": 4.0,
"m_DrainHoldBreathDuration": 5.0,
"m_DrainDrown": 10.0,
"m_DrainJump": 25.0,
"m_DrainVault": 20.0,
"m_DrainClimb": 42.0,
"m_DrainMeleeLight": 5.0,
"m_DrainMeleeHeavy": 25.0,
"m_DrainMeleeEvade": 8.0,
"m_DrainRoll": 5.0
},
"m_Sway": {
"m_TimeIn": 1.5,
"m_TimeStable": 3.0,
"m_TimeExhausted": 1.5,
"m_TimeOut": 0.5
}
}Options
| Option | Type | Description |
|---|---|---|
m_Enable | bool | With 1, enables the module. With 0, disables it. |
m_StaminaMax | float | Maximum stamina capacity, in stamina units. |
m_StaminaMinCap | float | Minimum stamina cap after the weight penalty, in stamina units. |
m_Cargo | object | Weight penalty settings. |
m_Gain | object | Recovery rates. |
m_Drain | object | Continuous movement drain. |
m_Consumers | object | Minimum stamina thresholds for actions. |
m_Modifiers | object | Action-specific stamina costs. |
m_Sway | object | Timing for sway while holding the breath. |
m_Cargo
| Option | Type | Description |
|---|---|---|
m_Infinity | bool | With 1, removes the carry-weight stamina penalty. With 0, applies the configured penalty. |
m_WeightLimitThreshold | float | Carried weight in grams above which the penalty increases. |
m_KgToGrams | float | Divisor used to convert excess load in grams to kilograms. |
m_KgToPercentPenalty | float | Stamina capacity lost per kilogram above the threshold. |
m_Gain
| Option | Type | Description |
|---|---|---|
m_Jog | float | Stamina recovery in units per second while jogging. |
m_Walk | float | Stamina recovery in units per second while walking. |
m_Idle | float | Stamina recovery in units per second while idle. |
m_Swim | float | Stamina recovery in units per second while swimming slowly. |
m_Ladder | float | Stamina recovery in units per second on a ladder at normal speed. |
m_Sprint | float | Stamina recovery in units per second when the sprint state permits recovery. |
m_Roll | float | Stamina recovery in units per second while rolling. |
m_Drain
| Option | Type | Description |
|---|---|---|
m_StandingSprint | float | Stamina used per second while sprinting upright. |
m_CrouchedSprint | float | Stamina used per second while sprinting crouched. |
m_SwimFast | float | Stamina used per second while swimming fast. |
m_LadderFast | float | Stamina used per second while climbing a ladder fast. |
m_Consumers
| Option | Type | Description |
|---|---|---|
m_HoldBreathThresholdActivate | float | Stamina needed to start holding the breath. |
m_HoldBreathThresholdDrain | float | Stamina threshold while holding the breath. |
m_JumpThreshold | float | Stamina needed to jump. |
m_VaultThreshold | float | Stamina needed to vault. |
m_ClimbThreshold | float | Stamina needed to climb. |
m_MeleeHeavyThreshold | float | Stamina needed for a heavy melee attack. |
m_MeleeEvadeThreshold | float | Stamina needed for a melee evade. |
m_RollThreshold | float | Stamina needed to roll. |
m_Modifiers
| Option | Type | Description |
|---|---|---|
m_DrainHoldBreathStart | float | Initial stamina drain rate while holding the breath. |
m_DrainHoldBreathExponent | float | Exponent used to increase stamina drain while holding the breath. |
m_DrainHoldBreathDuration | float | Time in seconds used for the breath-holding drain ramp. |
m_DrainDrown | float | Stamina cost for drowning. |
m_DrainJump | float | Stamina cost of jumping. |
m_DrainVault | float | Stamina cost of vaulting. |
m_DrainClimb | float | Stamina cost of climbing. |
m_DrainMeleeLight | float | Stamina cost of a light melee attack. |
m_DrainMeleeHeavy | float | Stamina cost of a heavy melee attack. |
m_DrainMeleeEvade | float | Stamina cost of a melee evade. |
m_DrainRoll | float | Stamina cost of rolling. |
m_Sway
| Option | Type | Description |
|---|---|---|
m_TimeIn | float | Seconds for sway to settle when holding the breath. |
m_TimeStable | float | Seconds of steady aim before fatigue. |
m_TimeExhausted | float | Fade duration in seconds for the exhausted sway phase. |
m_TimeOut | float | Seconds for sway to return after releasing the breath. |
