Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
SurvivalNeeds
Hunger, thirst and energy with a sleek HUD. Food tiers by health value, a refillable leather Waterskin, drinking from water, comfort-based resting, starvation damage and exhaustion. Server-synced config via Jotunn.
| Last updated | 3 days ago |
| Total downloads | 62 |
| Total rating | 0 |
| Categories | |
| Dependency string | StribbotStudios-SurvivalNeeds-1.0.1 |
| Dependants | 0 other packages depend on this package |
This mod requires the following mods to function
ValheimModding-Jotunn
Jötunn (/ˈjɔːtʊn/, 'giant'), the Valheim Library was created with the goal of making the lives of mod developers easier. It enables you to create mods for Valheim using an abstracted API so you can focus on the actual content creation.
Preferred version: 2.30.2
denikson-BepInExPack_Valheim
BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.
Preferred version: 5.4.2360README
SurvivalNeeds
Hunger, Thirst and Energy for Valheim, with a clean roleplay-server style HUD, food tiers, a refillable leather Waterskin and comfort-based resting.
Features
HUD
- Three slim rounded bars on a translucent dark backing, placed at the bottom left next to the health bar: Hunger (orange), Thirst (blue) and Energy (yellow), each with its own icon.
- Smooth fill animation. A bar pulses red when it drops below 15%.
- The position is worked out from Valheim's own health bar, food slots and Forsaken power icon, so the bars stay clear of them. Offset, scale, placement and percentages are configurable.
Needs
- Each need runs from 0 to 100.
- Default drain: hunger empties in 60 real minutes, thirst in 45 minutes, energy in 90 minutes awake. Sprinting drains energy 3x faster.
- Values are saved on your character and survive logout. By default they refill when you die.
Food tiers
The food's health value sets its tier, and the tier decides how much hunger it fills:
| Tier | Food health | Hunger filled |
|---|---|---|
| T1 | under 20 | 10% |
| T2 | 20 to 39 | 20% |
| T3 | 40 to 59 | 30% |
| T4 | 60 to 79 | 40% |
| T5 | 80 and up | 50% |
- The food's stamina value also restores energy (0.25% per stamina point), up to 25% per food item.
- Meads and other drinks fill 25% thirst.
- Food tooltips show the tier and what the item restores.
Waterskin
- Crafted at the Workbench from 4 Leather scraps and 2 Deer hide.
- Holds 3 charges. Each drink restores 25% thirst and uses one charge. The Waterskin is never used up.
- Use it like any other hotbar item or consumable. When it's empty you'll see "Empty, refill at water".
- It refills when you stand, wade or swim in water, or when you use it within 3 m of water. Charges show in the tooltip and on the item icon.
Drinking from water
- Press Y while standing in water to drink straight from it (20% thirst per sip).
Resting
- While you're sitting, resting or in bed with the Rested or Resting status, energy refills by 1 point per second per comfort level (Valheim's own comfort calculation).
- Sleeping through the night fully restores energy.
Starvation, dehydration and exhaustion
- When hunger or thirst is empty, you take 1 damage per second. Having both empty still deals 1 per second. A Starving or Dehydrated status icon and a warning message are shown.
- When energy is empty you are Exhausted: stamina is locked at 0 and you can't sprint until your energy rises above 0.
Console commands
These need devcommands or server admin rights.
| Command | Effect |
|---|---|
sn_hunger <0-100> |
Set hunger |
sn_thirst <0-100> |
Set thirst |
sn_energy <0-100> |
Set energy |
sn_all <0-100> |
Set all three |
sn_refill |
Refill every Waterskin in your inventory |
sn_status |
Print the current values, resting state and comfort level |
Configuration
The config file is BepInEx/config/com.survivalneeds.valheim.cfg. Entries marked Server are admin-only and sync from the server. Entries marked Client are personal.
| Section | Key | Default | Scope | Description |
|---|---|---|---|---|
| 1 - HUD | Enabled | true | Client | Show the bars |
| 1 - HUD | Placement | Auto | Client | Auto, RightOfHealth or AboveHealth |
| 1 - HUD | OffsetX | 0 | Client | Horizontal offset in HUD pixels |
| 1 - HUD | OffsetY | 0 | Client | Vertical offset in HUD pixels |
| 1 - HUD | Scale | 1 | Client | Bar size multiplier (0.5 to 3) |
| 1 - HUD | ShowPercentages | true | Client | Show a percentage next to each bar |
| 1 - HUD | LowWarningPercent | 15 | Client | A bar pulses below this value |
| 2 - Decay | HungerMinutes | 60 | Server | Minutes for hunger to drain from full to empty |
| 2 - Decay | ThirstMinutes | 45 | Server | Minutes for thirst to drain from full to empty |
| 2 - Decay | EnergyMinutes | 90 | Server | Minutes awake for energy to drain from full to empty |
| 2 - Decay | SprintEnergyMultiplier | 3 | Server | Energy drain multiplier while sprinting |
| 2 - Decay | ResetOnDeath | true | Server | Refill all needs on death |
| 3 - Food | Tier2MinHealth | 20 | Server | Minimum food health for T2 |
| 3 - Food | Tier3MinHealth | 40 | Server | Minimum food health for T3 |
| 3 - Food | Tier4MinHealth | 60 | Server | Minimum food health for T4 |
| 3 - Food | Tier5MinHealth | 80 | Server | Minimum food health for T5 |
| 3 - Food | Tier1Fill to Tier5Fill | 10/20/30/40/50 | Server | Hunger filled per tier |
| 3 - Food | StaminaToEnergy | 0.25 | Server | Energy per point of food stamina |
| 3 - Food | MaxEnergyPerFood | 25 | Server | Most energy one food item can restore |
| 3 - Food | DrinksFillThirst | true | Server | Meads and drinks fill thirst |
| 3 - Food | DrinkThirstFill | 25 | Server | Thirst filled per drink |
| 3 - Food | DrinkItems | Mead,BarleyWine | Server | Prefab name prefixes that count as drinks |
| 4 - WaterSkin | Charges | 3 | Server | Charges in a full Waterskin |
| 4 - WaterSkin | ThirstPerCharge | 25 | Server | Thirst restored per charge |
| 4 - WaterSkin | Recipe | LeatherScraps:4,DeerHide:2 | Server | Crafting cost |
| 4 - WaterSkin | CraftingStation | piece_workbench | Server | Station prefab name, or empty to craft by hand |
| 4 - WaterSkin | CraftingStationLevel | 1 | Server | Required station level |
| 4 - WaterSkin | AutoRefillInWater | true | Server | Refill while standing, wading or swimming |
| 4 - WaterSkin | RefillOnUseNearWater | true | Server | Using a Waterskin that isn't full near water refills it |
| 4 - WaterSkin | RefillDistance | 3 | Server | Meters that count as near water |
| 5 - Drink From Water | Enabled | true | Server | Allow drinking from water |
| 5 - Drink From Water | Key | Y | Client | Drink key |
| 5 - Drink From Water | ThirstPerSip | 20 | Server | Thirst restored per sip |
| 5 - Drink From Water | CooldownSeconds | 1.5 | Server | Seconds between sips |
| 6 - Rest | EnergyPerTick | 1 | Server | Energy per tick. One tick per second per comfort level |
| 6 - Rest | SleepFullRestore | true | Server | Sleeping through the night restores all energy |
| 7 - Starvation | DamagePerTick | 1 | Server | Damage per second at 0 hunger or thirst (does not stack) |
| 7 - Starvation | WarningIntervalSeconds | 30 | Server | Seconds between repeated warnings |
| 8 - Exhaustion | Enabled | true | Server | Lock stamina at 0 and block sprinting at 0 energy |
Multiplayer
- Every player needs the mod, and Jotunn checks the version when you connect.
- Each client tracks its own hunger, thirst and energy and saves them on its own character.
- Server entries sync from the server through Jotunn and only admins can change them. Client entries stay personal.
- The Waterskin recipe follows the server's settings after you connect.
Compatibility
- Other mods that add hunger, thirst or energy systems will stack with this one. Use only one needs mod at a time.
- World Edit / ValheimCityBuilder: the Waterskin is not counted as goods, so unloading your backpack leaves it with you. Don't put a Waterskin into a chest inside a World Edit town building: the town absorbs chest contents into its warehouse, and the charges are lost.
- The drink key ignores presses while you hold Ctrl or Alt, and while a hammer, hoe or cultivator is in build mode. This avoids clashes with build tool shortcuts such as Ctrl+Y redo.
