Vigor

About Vigor

This mod was created to add a layer of physical challenge and consequence to Vintage Story. Removing the ability to sprint and swim indefinitely adds challenge to combat, and encourages the use of rafts and boats for water traversal.
Vigor introduces a stamina system that is deeply integrated with the food you eat, making both physical exertion and a balanced diet critical components of your survival strategy.

Stamina System

A stamina bar is added to the HUD, which is consumed by the following actions:

• Sprinting
• Swimming
• Jumping

 

Running out of stamina will leave you Exhausted. While exhausted:

• Your movement speed is significantly reduced.
• You cannot sprint.
• If you are in the water, you will begin to drown.

 

Stamina regenerates after a short cooldown following any strenuous action.
However, if you push yourself to full exhaustion, you will face a longer recovery penalty before your stamina begins to return.

Stamina regeneerates slowly when walking on dry land, faster when idle, and faster still if you are sitting.

Nutrition Bonuses

Vigor ties directly into the vanilla nutrition system. Maintaining high levels in the five food groups provides significant, scaling bonuses to your stamina attributes. A balanced diet will make you more resilient and capable.

Nutrition Category	Primary Bonus (at 100% saturation)	Secondary Bonus (at 100% saturation)
Grain	+30% Max Stamina	-20% Jump Stamina Cost
Protein	+30% Stamina Recovery Rate	+20% Max Stamina
Vegetable	-30% Stamina Drain Rate	-20% Recovery Threshold
Dairy	-30% Recovery Threshold	+20% Stamina Recovery Rate
Fruit	-30% Jump Stamina Cost	-20% Stamina Drain Rate
All (Combined)	-50% Recharge Delay

 

Note: "Recovery Threshold" refers to the percentage of stamina you must recover to before the Exhausted state is removed.

Configuration

Vigor is highly configurable. Nearly all values, from stamina costs to the potency of nutrition bonuses, can be adjusted in the ModConfig/vigor.json file to tailor the experience to your liking.

Mod Compatibility

Salty's Immersive Mining - Tools use stamina


Hydrate or Diedrate - Statbar positioning

Experimental

Vigor 0.3.0 adds experimental support for Stamina integration by other mods.
I have built a custom version of Verticality to iron out the API requirements. If you would like to test it out, please download the custom Verticality mod.
Release v0.3.1_vigor_experimental · cjohnsto-nz/Verticality

Future

• Make the player slowly sink when exhausted in water.
• Add stamina cost to other actions, like smithing and mining.
• Reduce/remove hunger cost from those actions, in favor of stamina costs.
• Add a hunger cost to recharging stamina.

This mod is in very early development!
My goal is to split this into two mods:
Vigor, which controls the sprinting, swimming, jumping costs, and the nutrition bonuses.
StaminaLib, which controls the UI rendering, state management, and intermod compaitibility. My goal is to provide a vanilla like standard stamina framework for all mods that use stamina to align on.
But I am just learning :)
Please let me know if you have any issues, or need changes for mod compatibility.