Welcome to 'Hydrate or Diedrate', a comprehensive thirst mechanic mod for Vintage Story that introduces a hydration system influenced by weather conditions and player activities.<\/p>\r\n
Kegs:<\/strong><\/p>\r\n Craftable Kegs<\/strong>: Kegs can be crafted using wood, sticks, and iron hoops (see handbook for recipe). Initially, kegs are untapped, allowing you to fill them with liquids, but preventing liquid extraction until tapped.<\/p>\r\n<\/li>\r\n Long-Term Preservation<\/strong>: Untapped kegs significantly slow down the spoilage of stored liquids, making them ideal for preserving your precious resources.<\/p>\r\n<\/li>\r\n Keg Tapping<\/strong>: To access the stored liquids, you’ll need to craft a Keg Tap using brass at the anvil. Once you have the tap, use a hammer in your off-hand and the tap in your main hand and hold right-click on the keg to tap it, permanently enabling liquid extraction and refilling, but significantly reducing its preservation ability.<\/p>\r\n<\/li>\r\n Recycling Kegs<\/strong>: If needed, tapped kegs can be recycled. Use an axe to break down the keg and recover some of the metal materials. (hold right click with axe) However, be aware that there's a chance some materials will be lost during the process.<\/p>\r\n<\/li>\r\n<\/ul>\r\n Tuns:<\/strong><\/p>\r\n Craftable Tuns<\/strong>: A very large barrel (2x2x2) block that can store up to 950 liters of liquid (configurable). Does not get any benefit to spoil rate like the keg but can be used to store long lasting drinks or non spoiling liquids in bulk. By default has roughly the same spoil rate as a vanilla barrel (configurable). See handbook for crafting recipe.<\/p>\r\n<\/li>\r\n<\/ul>\r\n Wells:<\/strong><\/p>\r\n Dig your own well<\/strong>: Dig a well for your community to provide a long term source of clean water! The world now generates with aquifers and using the prospecting pick will give you a reading of the aquifer in the area. Dig deeper to find heavier wells! Once you find an appropriate spot, use the new tool mode on the pickaxe to dig a well spring (or use the shovels version to dig shallow surface wells for early muddy water which is cleaner than source blocks, but be sure to dig these close by to actual water). Well springs will fill their shaft up to 5 blocks by default so long as the shaft is unobstructed and has a solid horizontal neighbor at each level. Upgrade your shaft with clay brick to increase its capacity to 7 blocks, or 10 if you use stone brick (configurable). Craft a well winch to access your well water from the convenience of the surface. <\/p>\r\n<\/li>\r\n<\/ul>\r\n <\/p>\r\n MaxThirst<\/strong> ( ThirstDamage<\/strong> ( ThirstDecayRate<\/strong> ( ThirstDecayRateMax<\/strong> ( HydrationLossDelayMultiplierNormalized<\/strong> ( EnableThirstMechanics<\/strong> ( WaterSatiety<\/strong> ( SaltWaterSatiety<\/strong> ( BoilingWaterSatiety<\/strong> ( RainWaterSatiety<\/strong> ( DistilledWaterSatiety<\/strong> ( BoiledWaterSatiety<\/strong> ( BoiledRainWaterSatiety<\/strong> ( SprintThirstMultiplier<\/strong> ( EnableBoilingWaterDamage<\/strong> ( BoilingWaterDamage<\/strong> ( MaxMovementSpeedPenalty<\/strong> ( MovementSpeedPenaltyThreshold<\/strong> ( EnableLiquidEncumbrance<\/strong> ( EncumbranceLimit<\/strong> ( LiquidEncumbranceMovementSpeedDebuff<\/strong> ( HarshHeat<\/strong> ( TemperatureThreshold<\/strong> ( ThirstIncreasePerDegreeMultiplier<\/strong> ( HarshHeatExponentialGainMultiplier<\/strong> ( UnequippedSlotCooling<\/strong> ( WetnessCoolingFactor<\/strong> ( ShelterCoolingFactor<\/strong> ( SunlightCoolingFactor<\/strong> ( DiurnalVariationAmplitude<\/strong> ( RefrigerationCooling<\/strong> ( DromedaryMultiplierPerLevel<\/strong> ( EquatidianCoolingMultipliers<\/strong> ( EnableRainGathering<\/strong> ( RainMultiplier<\/strong> ( EnableParticleTicking<\/strong> ( KegCapacityLitres<\/strong> ( SpoilRateUntapped<\/strong> ( SpoilRateTapped<\/strong> ( KegIronHoopDropChance<\/strong> ( KegTapDropChance<\/strong> (\r\n
\r\n
\r\n
Customization and Compatibility<\/h4>\r\n
\r\n
\r\n
\r\n
Thirst Settings<\/h2>\r\n
\r\n
float<\/code>)
The upper bound of the player’s thirst gauge (default: 1500).<\/p>\r\n<\/li>\r\nfloat<\/code>)
Damage dealt to the player each interval once fully dehydrated (default: 1).<\/p>\r\n<\/li>\r\nfloat<\/code>)
Base rate (units\/tick) at which thirst increases under normal conditions (default: 10).<\/p>\r\n<\/li>\r\nfloat<\/code>)
Maximum multiplier applied to ThirstDecayRate<\/code> under extreme conditions (default: 5).<\/p>\r\n<\/li>\r\nfloat<\/code>)
Scales the thirst reduction delay you get from drinking drinks. (default: 1).<\/p>\r\n<\/li>\r\nbool<\/code>)
Master switch for the entire thirst\/dehydration system (default: true).<\/p>\r\n<\/li>\r\nfloat<\/code>)
Thirst reduction when drinking fresh water (default: –100).<\/p>\r\n<\/li>\r\nfloat<\/code>)
Thirst reduction when drinking salt water (default: –100).<\/p>\r\n<\/li>\r\nfloat<\/code>)
Thirst reduction when drinking boiling water (default: 0).<\/p>\r\n<\/li>\r\nfloat<\/code>)
Thirst reduction when drinking collected rainwater (default: –50).<\/p>\r\n<\/li>\r\nfloat<\/code>)
Thirst reduction when drinking distilled water (default: 0).<\/p>\r\n<\/li>\r\nfloat<\/code>)
Thirst reduction when drinking boiled (but not rain) water (default: 0).<\/p>\r\n<\/li>\r\nfloat<\/code>)
Thirst reduction when drinking rainwater that’s been boiled (default: 0).<\/p>\r\n<\/li>\r\nfloat<\/code>)
Multiplier to thirst\u2011decay rate while sprinting (default: 1.5).<\/p>\r\n<\/li>\r\nbool<\/code>)
Whether drinking boiling\u2011hot water inflicts damage (default: true).<\/p>\r\n<\/li>\r\nfloat<\/code>)
Damage dealt when consuming boiling water (default: 5).<\/p>\r\n<\/li>\r\n<\/ul>\r\n
\r\nMovement Speed Penalty<\/h2>\r\n
\r\n
float<\/code>)
The cap on speed reduction (as a fraction) from dehydration or liquid weight (default: 0.3 = 30%).<\/p>\r\n<\/li>\r\nfloat<\/code>)
Thirst level at which movement penalties begin (default: 600).<\/p>\r\n<\/li>\r\n<\/ul>\r\n
\r\nLiquid Encumbrance<\/h2>\r\n
\r\n
bool<\/code>)
Toggles speed penalties for carrying heavy liquid loads (default: true).<\/p>\r\n<\/li>\r\nfloat<\/code>)
Litres of liquid you can carry in a single slotbefore incurring penalties (default: 4 L).<\/p>\r\n<\/li>\r\nfloat<\/code>)
Additional speed reduction when encumbered by liquid (default: 0.4).<\/p>\r\n<\/li>\r\n<\/ul>\r\n
\r\nTemperature & Heat<\/h2>\r\n
\r\n
bool<\/code>)
Enables accelerated dehydration in high\u2011temperature locations (default: true).<\/p>\r\n<\/li>\r\nfloat<\/code>)
Ambient °C above which thirst decay starts ramping up (default: 27 °C).<\/p>\r\n<\/li>\r\nfloat<\/code>)
Additional thirst units per °C above the threshold each second (default: 5).<\/p>\r\n<\/li>\r\nfloat<\/code>)
Exponential scaling factor for thirst gain in extreme heat (default: 0.2).<\/p>\r\n<\/li>\r\n<\/ul>\r\n
\r\nCooling Factors<\/h2>\r\n
\r\n
float<\/code>)
Cooling bonus for each empty armor\/clothing slot (default: 1).<\/p>\r\n<\/li>\r\nfloat<\/code>)
Cooling effect of being wet (default: 1.5).<\/p>\r\n<\/li>\r\nfloat<\/code>)
Cooling bonus when in a room (default: 1.5).<\/p>\r\n<\/li>\r\nfloat<\/code>)
Cooling effect in shade (default: 1).<\/p>\r\n<\/li>\r\nfloat<\/code>)
Temperature swing between day and night in °C (default: 18).<\/p>\r\n<\/li>\r\nfloat<\/code>)
°C reduction provided by refrigeration blocks (if supported mod is installed) (default: 20).<\/p>\r\n<\/li>\r\n<\/ul>\r\n
\r\nXSkills<\/h2>\r\n
\r\n
float<\/code>)
Thirst\u2011decay reduction per level in the “dromedary” trait (default: 0.3).<\/p>\r\n<\/li>\r\nfloat[]<\/code>)
Array of cooling bonuses per level in the “equestrian” trait (default: [1.25, 1.5, 2.0]).<\/p>\r\n<\/li>\r\n<\/ul>\r\n
\r\nRain Gathering<\/h2>\r\n
\r\n
bool<\/code>)
Allows containers to collect rainwater automatically (default: true).<\/p>\r\n<\/li>\r\nfloat<\/code>)
Scales how much water is gathered per tick of rain (default: 1).<\/p>\r\n<\/li>\r\nbool<\/code>)
Toggles per\u2011tick updates for rain particles (performance trade\u2011off) (default: false).<\/p>\r\n<\/li>\r\n<\/ul>\r\n
\r\nKeg & Tun<\/h2>\r\n
\r\n
float<\/code>)
Storage capacity of a keg in litres (default: 100 L).<\/p>\r\n<\/li>\r\nfloat<\/code>)
Hourly spoilage rate when a keg is sealed (default: 0.15).<\/p>\r\n<\/li>\r\nfloat<\/code>)
Hourly spoilage rate when a keg is open\/tapped (default: 0.65).<\/p>\r\n<\/li>\r\nfloat<\/code>)
Chance (0–1) of recovering the iron hoop when dismantling a keg (default: 0.8).<\/p>\r\n<\/li>\r\nfloat<\/code>)
Chance of recovering the tap when dismantling (default: 0.9).<\/p>\r\n<\/li>\r\n