Hydrate or Diedrate

Hydrate Or Diedrate

Overview

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.

Key Features

Thirst Mechanic

• Thirst Bar: Keep an eye on your thirst bar, which depletes over time, especially in hot climates.
• Weather Influence: Thirst drains faster in hot temperatures. Manage your hydration carefully when trecking to the south!
• Cooling Stat: Most clothing items now have a cooling stat that helps mitigate heat, slowing down the rate of thirst depletion.
• Wetness and Shelter: Being wet or seeking shelter can help you stay cool. Sometimes, wearing nothing is better than being fully clothed in the heat.
• DEATH: Not staying hydrated WILL kill you and fast. Currently it will do roughly double the damage of starving to death.
• Liquid Encumbrance: Liquid Containers that contain more than 4 litres (configurable) will encumber the player and slow movement speed.

Hydration from Food and Drinks

• Hydration Stat: Every food and drink item now has a hydration stat that replenishes your thirst.
• Special Effects: Soups and juices temporarily pause thirst, while alcohol can pause it for much longer, reflecting a unique way Seraphs process alcohol.
• Water Sources: Drink directly from water sources with ctrl + right-click (this is an actual keybind now, beware base game does not properly show modifiers on mouse keybinds in the menu). However, this method increases hunger, encouraging players to process drinks or make soups for a more efficient hydration solution.
• Rain Water: All liquid containers can now be set out in the rain to collect rain water. Rain water is a great early to mid game alternative to regular water as it replenishes more thirst and reduces hunger at half the rate of regular water.

Kegs:

• Craftable Kegs: 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.

• Long-Term Preservation: Untapped kegs significantly slow down the spoilage of stored liquids, making them ideal for preserving your precious resources.

• Keg Tapping: 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.

• Recycling Kegs: 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.

Tuns:

• Craftable Tuns: 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.

Wells:

• Dig your own well: 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. 

Customization and Compatibility

• Fully Configurable: The mod comes with a JSON configuration file located in the modConfig folder, allowing you to tweak various settings to fit your gameplay style. See in game handbook entry for a description of all the config options.
• ConfigLib Support: Settings config options are editable in game with ConfigLib. Item patching configs will still need to be adjusted manually.
• Easy Integration: Adding compatibility for new clothing, food, and drinks is straightforward with the included custom JSON patching method. All vanilla items have been patched using this method, and examples can be found in the config folder. Simply include a json in the modconfig folder with either the name name.AddHydration.json or name.AddCooling.json. And my patcher will detect it and patch the item accordingly. The priorty level goes from 1-5 with 1 being top priority for the purpose of overwriting other patches.