# Stamina Design Document

*Words between brackets are placeholders and not final.*
*Text between slashes is still pending discussion.*

## Stamina and [Vigor]
---
### What is Stamina?

Stamina is a resource that represents burst endurance, and is consumed whenever a character performs a physically extenuating action, like sprinting or fighting.
Stamina ranges from 0 to /50, although stats and various bonuses may raise it up to a maximum of 100./
/Whenever an action that depletes stamina is taken, there is a slight delay (1-5 seconds?) where it will not regenerate. Characters need to spend that amount of time not using up their stamina for it to start regenerating.

#### Ways to spend Stamina:
* Sprinting.
* Fighting. /Each weapon or weapon type has a different amount of stamina used per attack. Crossbows use stamina when reloading. Firearms do not use stamina./
* Climbing.
* /Being hit in combat?? Maybe some specific weapons?/
* Others??

/Armor affects how much stamina is spent with each action by applying a multiplier. A general rule is, the heavier the armor, the more stamina is consumed. Willing to talk about this - penalty applies to everyone, or only to those too weak to wear heavy armor? Only when sprinting?/

#### Ways to regain Stamina:
* Waiting. Not doing any physically exerting action for /1-5 seconds/ will start rapidly recharging the stamina bar. Recharging Stamina drains [Vigor] at a rate of /1:50, with one point of [Vigor] being able to completely refill a Stamina bar./
* Stamina potions. /We should consider if we want stamina potions to either give you an instant refill on stamina, grant you some passive, non-[Vigor] regeneration of Stamina, or boost your natural regeneration by making regen kick in instantly without having to wait the 1-5 seconds. Maybe all three? Potion diversity would be neat and each could have their rarity or usefulness./

### What is [Vigor]?

[Vigor] is another resource, representing long-term endurance. It is used <font color="green">/whenever Stamina is used. The less Stamina you have, the more [Vigor] is used, with the formula being **vigor_use = stamina_use / min(10, current_stamina)**. So for example, an action that uses 10 points of Stamina will use 0.2 points of Vigor if the user has a full bar (50 points of Stamina), or 1 point of Vigor if the user has depleted their Stamina./</font>
[Vigor] ranges from 0 to /50, although stats and various bonuses may raise it up to a maximum of 100. [VIGOR]'S MAXIMUM CAPACITY SHOULD BE WAY WAY HARDER TO RAISE./
[Vigor] is regained simply by waiting. Unlike stamina there is no delay, it is always regenerating, albeit at a very slow pace which can be quickened by taking some measures.

#### How to regenerate [Vigor]:
* Eating. Food is the key to regenerate [Vigor]. A balanced diet will /have some effects. Faster [Vigor] regen? Passive health regen?/ More on food later.
* Sitting down and resting. Buckling to a chair will give a small boost to [Vigor] regeneration. Buckling to a bed will give a far larger boost.
* /Being near a campfire. Campfires grant a small boost to [Vigor] regen./ /Only at night?/
* Being in some specific places. Inns, taverns, temples, etc. will grant you a small boost to your regeneration. Linked to the area. /Way for players to do this mechanically?/
* /Sleeping./

/There are no [Vigor] regeneration potions OR THEY SHOULD BE REALLY REALLY RARE OR HARD TO MAKE. [Vigor] encourages RP and pacing and potions that skip that mechanic shouldn't be a thing./

#### When [Vigor] runs out:
If [Vigor] reaches zero, /the character becomes extremely exhausted. Stamina regeneration slows down to a crawl. Actions that consume stamina **may not be used unless the character has enough stamina for them.** If the character keeps exerting themselves, they will eventually fall unconscious./