Back to mods
Max's Simple Starvation and Hunger System project artwork

Vintage Story Mod DB · Vintage Story mod

Max's Simple Starvation and Hunger System

Intro This mod introduces a slightly more nuanced hunger system into the game without overcomplicating gameplay or slipping into simulation territory. The goal was to aim for compatibly with as many things as possible (stuff like ExpandedFoods etc) so it trie

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Max's Simple Starvation and Hunger System release matches 1.22.0-rc.6?

Updated last month
Best match for your filters 1.0.6
Game version 1.22.0-pre.1, 1.22.0-pre.2, 1.22.0-pre.3
Loader Built-in Vintage Story mod system

Max's Simple Starvation and Hunger System 1.0.6 targets 1.22.0-pre.1, 1.22.0-pre.2, 1.22.0-pre.3. It must be installed on the client. Installation on the dedicated server is optional. No extra mods listed for this file.

Where it goes

Is Max's Simple Starvation and Hunger System required on the client, server, or both?

It must be installed on the client. Installation on the dedicated server is optional.

Client Required
Dedicated server Optional
Loader for this release Built-in Vintage Story mod system
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

This release supports both sides, but the source does not require it on the server.

What else does Max's Simple Starvation and Hunger System 1.0.6 need?

1.0.6 on 1.22.0-rc.6. Every mod below is checked against that same setup.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add Max's Simple Starvation and Hunger System without breaking your instance.

Built for Max's Simple Starvation and Hunger System 1.0.6 on 1.22.0-rc.6. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use 1.0.6. It targets 1.22.0-pre.1, 1.22.0-pre.2, 1.22.0-pre.3; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Put it on the correct side

    It must be installed on the client. Installation on the dedicated server is optional.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside 1.0.6. It opens that exact file at the source.

About this project

What does Max's Simple Starvation and Hunger System add?

Intro


 

This mod introduces a slightly more nuanced hunger system into the game without overcomplicating gameplay or slipping into simulation territory. The goal was to aim for compatibly with as many things as possible (stuff like ExpandedFoods etc) so it tries to work with the vanilla systems.

Instead of damage at 0 saturation:

  • The saturation bar now acts as your stomach contents
  • As saturation decreases food is digested and converted into body weight to act as a store of saturation.
  • As your weight changes a configurable list of buffs and debuffs are applied to your character.

Don't eat too much in one go or you'll spew and empty your stomach contents all over the floor, losing your current saturation.

You can see the current bonuses and penalties can be seen in the character panel ('C' by default).

What This Mod Does


 

  • Removes hunger damage when saturation reaches 0
  • Removes saturation loss delay after eating
  • Stops saturation being a factor in calculating health regen
  • Allows eating past Max Saturation
  • Forces full consumption of meals so no partial portions
  • Tracks eaten saturation and converts it to body weight
  • Adds buffs/debuffs depending on the current body weight
  • Burns body weight over time, factoring in
    • Sprinting
    • Sleeping
    • Standing still
  • (Configurable) Inflicts lethal damage when the critical weight is reached

What This Mod Doesn't Do


 

  • Touch anything to do with nutrition (still applies health bonuses with a varied diet)
  • Change any saturation values 

Bonuses and Penalties


 

Here are the default bonuses and penalties:

Default buffs/debuffs
Weight WalkSpeed MiningSpeed MaxHealth MeleeDamage RangedDamage HealingEffectiveness HungerRate RangeWeaponAccuracy RangedWeaponsSpeed RustyGearDropRate AnimalSeekingRange BowDrawStrength GliderLiftMax GliderSpeedMax JumpHeightMul
40 -0.3 -0.25 -3 -0.5 -0.3     -0.6 -0.6 0.3 -0.3 -0.6 0.3 0.3  
50                              
60 0 0 0 0 0     0.1 0 0   -0.2      
70                         0 0  
80 0.2   5   0.3     0.3     0        
90                              
100 -0.2 0.3 3 0.3 0.1     0.1 0.2   0.3 0.2 -0.5 -0.5  
                    //lucks gotta turn around at some point right??? //animals will find the extra fat extra tasty        

 

The value of the buff is linearly interpolated between points. If it's the first in the list then it'll assume a 0 at the critical weight and fade in from there but if it's the last weight in the list it'll stick at the max value unless you add buff with a value of 0 at the MaxWeight.

For example imagine you've created a custom list that has a value of 1 at 60kg and a value of 2 at 80kg the values would look like this:

When player weight is 40kg then the value would be 0

When player weight is 50kg then the value would be 0.5

When player weight is 60kg then the value would be 1

When player weight is 70kg then the value would be 1.5

When player weight is 80kg and above then the value would be 2

Commands


 

There are some debug commands you can use if things go awry or you want to do some testing:

/weight set <weight in kg>

/weight playerset <player name> <weight in kg>

/weight clearaveragegain //clears the average gain tracker back to 0 if it gets weird

 

Configuration


 

This mod is highly configurable and will need some tweaking initially - the intention is to find a sweetspot after a few people have tried it 😎

Here are the properties you can change along with their defaults and what they do:

Configurable Properties
  • HealthyWeight (75) - Used to calculate how long a healthy person would take to starve using ExpectedSaturationPerDay and NumberOfMonthsToStarve.
  • CriticalWeight (40) - The lowest weight you can be before you suffer organ failure and damage starts being applied.
  • MaxWeight (100) - The maximum weight you can be.
  • ExpectedSaturationPerDay (2500) - Roughly how much saturation per day you'd expect to eat to maintain your weight.
  • NumberOfMonthsToStarve (1.5) - Roughly how long it would take to starve from HealthyWeight to CriticalWeight. This is then used to calculate how much saturation that would be like this:
    ExpectedSaturationPerDay * World.Calendar.DaysPerMonth (world gen days per month setting) * NumberOfMonthsToStarve;​
  • ThrowUpThreshold (250) - How much saturation you can eat over the max saturation before you vomit.
  • ApplyWeightBonuses (true) - Whether or not the mod will apply weight bonuses.
  • WeightLossOnDeath (3) - What percentage of your current weight that you'll lose on death (100kg -> 97kg etc).
  • LowestPossibleWeightOnRespawn (45) - A cap on how low you can go when you die and lose bodyweight.
  • PlayerStartingWeight (60) - The weight that the player spawns in with.
  • WeightBonuses - The bonuses applied to the player. This one is a little more complicated and I'll explain in the next section.
  • StoodStillModifier (0.25) - How much less energy the player burns when standing still. By default 4 times less.
  • SleepModifier (0.25) - How much less energy the player burns when sleeping. By default 4 times less.
  • SprintModifier (0.1) - How much more energy the player burns when sprinting. By default 10% more.
  • AlwaysConsumeFullMeal (true) - Whether or not the player will always eat the full meal or leave portions.
  • ApplyFatalDamageOnCriticalWeight (true) - Whether the player can die from hunger.
  • AverageGainCheckWindowInHours (12) - Used to tune the average weight gain check. How many hours the average weight gain check is based on.
  • AverageGainCheckFrequencyInHours (1) - Used to tune the average weight gain check. How long between the average weight checks.
  • WeightGainMultiplier - A multiplier to control how much weight you gain as your saturation depletes.
  • WeightLossMultiplier - A multiplier to control how much weight you lose overall during gameplay.

Updating the Bonuses


 

The bonuses that are applied are also configurable and the GUI should automatically update to accomodate them. The bonus types past 14 are not properly supported but I may add them if there's interest. Here are the values for each bonus that can be applied:

 

Bonus Types
  • WalkSpeed = 0
  • MiningSpeed = 1
  • MaxHealth = 2
  • MeleeDamage = 3
  • RangedDamage = 4
  • HealingEffectiveness = 5
  • HungerRate = 6
  • RangeWeaponAccuracy = 7
  • RangedWeaponsSpeed = 8
  • RustyGearDropRate = 9
  • AnimalSeekingRange = 10
  • BowDrawStrength = 11
  • GliderLiftMax = 12
  • GliderSpeedMax = 13
  • JumpHeightMul = 14

 

 --Not supported but might still work--

  • WholeVesselLootChance = 15
  • TemporalGearRepairCost = 16
  • AnimalHarvestTime = 17
  • MechanicalsDamage = 18
  • AnimalLootDropRate = 19
  • ForageDropRate = 20
  • WildCropDropRate = 21
  • VesselContentsDropRate = 22
  • OreDropRate = 23
  • ArmorWalkSpeed = 24
  • ArmorDurabilityLoss = 25

 

You then choose the bonus type, value and weight to be applied at and add it to WeightBonuses. Check the default config if you're not used to JSON

e.g A 30% boost to melee damage at 65kg

{
     "Weight": 65.0,
     "Type": 3,
     "Value": 0.3
},

Incompatibilities


 

Currently soft incompatbility with Hydrate or Diedrate as it overwrites OnEntityReceiveSaturation which means that you're unable to eat past max sat and vomit. Currently working on it though as I'd quite like to use them together personally :) - Has now been updated to improve the way they handle OnEntityReceiveSaturation so should be compatible now. I'll be doing some testing soon to make sure everything works.

Please let me know if you find anything else 🕺

Project description from Vintage Story Mod DB.

Pick your setup

Max's Simple Starvation and Hunger System releases for each Vintage Story version.

Choose the version and loader you play, then open the matching release.

32 available setups

Showing the newest 12 of 32 game versions. Older files are in the list below.

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

Max's Simple Starvation and Hunger System versions and loaders

1 of 10 releases match
Clear filters

Looking for an older file? The official Vintage Story Mod DB project page is in Resources.