Environmental Awareness: The Trials of Toil

The creatures of Valheim don't want your blood - the world itself does too!

This mod is a survival expansion to Valheim that currently adds three new mechanics: Vitality, Energy, and Capability.

Vitality

Vitality is a measure of how well you are surviving in your environment and will go up or down based on what situations you put your character through. As you continue to expose yourself to adverse conditions, your Resistance skill will level up.

Vitality starts at 100% and will go up or down depending on the following factors:

• Being wet, cold or frozen will decrease your vitality as you spend longer in unfavourable weather. If you're both wet AND cold, watch out!
• Getting hurt by enemies or the environment will lower your vitality with each hit sustained, depending on how much damage was dealt to you.
• Staying in extreme biomes like Ashlands and Deep North will slowly sap you of your vitality due to extreme temperatures.
• Being hungry with no food will greatly lower your vitality if you go too long without eating. Don't starve to death!
• Getting poisoned will severely lower your vitality until it wears off.
• Getting set on fire, being frozen, or getting zapped will severely lower your vitality until it wears off.
• Standing near a fire anywhere will raise your vitality, as long as the environment is not freezing and you're not on fire.
• Staying sheltered will raise your vitality, as long as the environment is not freezing. If it's freezing, you need a fire too.
• Being warm and sheltered will raise your vitality in freezing environments, and more if the environment is not freezing.
• Resting or having the rested status will raise your vitality, or slow down the rate which it lowers if in an unfavourable environment.
• If the player is not hungry, at full health, not in an unfavourable biome, and the weather is not raining or cold, the player will slowly recover vitality.

As your vitality drops, you will notice some additional debuffs get applied, which worsen as it gets lower.

• Stamina will regen slower as your vitality gets lower.
• You will take more damage from physical or elemental hits, developing a Weak status effect for each damage type apart from Spirit.
• You will start to move more slowly as your vitality gets lower.
• Duration and stats of food will get lower if your vitality gets too low.
• Eventually you will start sustaining damage, seek shelter and a fire immediately before it's too late!

You have several ways to resist vitality loss.

• Having resistant or very resistant to frost will slow down vitality drain from being cold or frozen, or in the Deep North.
• Having resistant or very resistant to poison will greatly slow down vitality drain from the Poisoned status.
• Having resistant or very resistant to fire will slow down vitality drain from being in the Ashlands or being on fire.
• Wearing armor will slow down all vitality drain as your armor rating gets higher.
• Eating food will slow down your vitality drain depending on how many hit points are granted.
• Health meads will grant a vitality boost over their cooldown duration.
• Being in harsh conditions will slowly raise your Resistance skill. The higher it is, the more resistant you are to vitality loss.

Energy

Energy is a measure of your overall physical and mental capabilities and will go up or down based on your activities. As you expend energy, your Fitness skill will level up.

Energy starts at 100% and will go up or down depending on the following factors:

• Being wet, cold or freezing will slowly sap your energy.
• Expending stamina will lower your energy the more you use.
• Carrying heavy loads will have an increasing effect on your energy drain. By default this effect starts as your weight goes over 60% of its maximum.
• Being hungry will slowly lower your energy.
• Eating food will raise your energy proportional to its stamina value.
• Sitting down will raise your energy slowly as long as you're not wet, cold, freezing or hungry.
• Resting will quickly raise your energy.
• Sleeping will restore a good chunk of your energy.

As your energy drops, you will notice some additional debuffs get applied, which worsen as it gets lower.

• You will start to move slower as your energy drops.
• Stamina regen will slow down the more energy you lose.
• Stamina regen delay will increase as you get more tired.
• If you're extremely tired, you will suffer a temporary loss to your maximum available stamina.
• If you're extremely tired, your skills level up slower.
• If you're extremely tired, the Rested status will automatically be removed even if there is time left.

There are several ways to resist energy loss:

• While under the effect of a stamina mead, you will slowly recover energy and have a resistance to energy loss for the duration.
• Being rested will provide a resistance to energy loss.
• Using energy will slowly raise your Fitness skill, making it take longer for your energy to drain.

Capability (new for 1.2.0)

Capability is a measure of how long you can stay alert over extended time periods. Think of it as 'long term energy'. As you stay awake and do activities for longer periods of time, your Capability will slowly drain. You can recover capability by sleeping.

Capability starts at 100% and will go up or down depending on the following factors:

• Being awake will slowly lower your Capability. As more time passes, the more your capability will drop.
• Having low vitality or low energy will increase the speed of your capability drain. Make sure to stay well and rested.
• Sleeping will provide a sharp boost to your capability. This is the main way to recover your capability.

As your Capability drops, it will only provide one main drawback - your maximum Vitality and Energy stats will be capped, preventing them from reaching 100% and thus incurring some of the debuffs from having those stats lower than optimal.

There are several ways to resist Capability loss or restore it:

• Sleeping is the easiest way to restore a large amount of capability.
• Spending a lot of time not sleeping will slowly raise your Perseverence skill, which increases the amount of time you can go without needing to sleep.
• Being well rested, and having high Vitality and Energy will slow down the rate of Capability loss.
• Drinking Tasty Mead will increase your overall Capability - but there is only a certain number of times you can do this before needing to sleep again.

Hunger

This is a small status effect that will appear when your character hasn't eaten food for a while. This will cause your vitality to drop if left unattended, which makes it possible for your character to starve to death. Be mindful and make sure to take some extra food with you on longer journeys.

Compatibility

This mod also has some built-in compatibility for Seasonality or Seasons. If you are using Seasons, be sure to turn on Seasonal Global Keys for the effects to work.

• Each season will apply a multiplier to your vitality and energy loss.
• During spring and summer, your vitality and energy will go down more slowly.
• During autumn, your vitality and energy will go down at a normal rate.
• During winter, your vitality and energy will go down much quicker if you're out too long in the cold.

Configuration

All values are configurable in the config file. You can turn individual features of this mod on and off to adjust the difficulty. All options are fully documented.

Bugs

This mod may have quite a few bugs and so I'd advise using this on a new save, or backup your old saves if you want to add it to your current world.

For the Future

I'd like to work on the following things in the future:

• Some positive effects for the Resistance and Fitness skills as they get above level 50, perhaps an increase to your health and stamina regeneration respectively.
• Guardian powers having effects on Vitality and Energy while active, with integration for Passive Powers and other mods that add status effects.

Credits

• ProbablyKory: For inspiration for this mod with their StormExposure mod.
• Azumatt: For instructing me on where to go to get a working copy of Valheim's assets in Unity.
• OrianaVenture: For assistance with figuring out whether this type of mod was even possible.
• GsiX: Help with sprite sizes.
• HugoTheDwarf: Help with sprite sizes.
• Blaxxun: ServerSync, SkillManager and LocalizationManager.
• Blacks7ar: Help with extracting skill levels from a custom-added skill.
• Soloredis: Help with extensive testing and reporting compatibility bugs with other mods.

Translators

• Love5225: Korean localization

Contact Me (Bug Reports & Suggestions)

If you have any suggestions, or experience bugs / problems using this mod please get in touch with me on my Discord.

Installation (Manual Download)

Move the 'plugins' folder from the archive to your BepInEx folder.

Changelog

1.2.3 (Experimental, use 1.1.2 if you have lots of issues)

• Added a new GUI element to house the status effects added by this mod. It is disabled by default, but can be enabled any time in-game or via configuration. You can position the UI element via configs. Recommended to use a configuration manager for changes as they will register on the fly.
• Added more config options for debug logging to change frequency of status effect reporting in the console.

1.2.2 (Experimental, use 1.1.2 if you have lots of issues)

• Added configuration option to make it so that when a player is laying down, but not sleeping, they can slowly recover their Capability over time. This should help on multiplayer servers where not everybody wants to sleep.
• Added passive tasty mead digestion to the player's Capability effect so that they don't have to sleep to slowly reset the amount they can consume to recover more Capability. This comes with a new config option.
• Added a new save option for the amount of time left for tasty mead digestion.

1.2.1 (Experimental, use 1.1.2 if you have lots of issues)

• Added config options to enable advanced stat tracking in the status effect screen to help with debugging.
• Added config options to turn saving on or off for status effect values.
• Added a small check to warning messages so they have to wait for a time before being shown if they have been seen recently. This should cover a very small edge case where levelling up a skill changed the percentage value of its associated status effect and showed a repeated warning message if the new value was just below the warning threshold.
• Added a config change event listener so that using a configuration manager in game will force the status effects on the player to refresh to get the new values without needing to restart the game. Not sure how this will play on servers for connected clients, so if anybody wants to test making config changes as an admin and seeing what happens on client machines, it would be handy!
• Added a file watcher to also detect manual config changes or for those made in Thunderstore. It should also force a status effect refresh. Again not sure how this will act from non-admins trying to make changes to the files, but hopefully it will just request the server data again. Please feel free to test and let me know.
• Fixed an issue where disabling the Capability status effect after having save data would cause the player's max stats to be capped at less than 100% if capability stat was low enough. Disabling any of the features will now discard all of its save data and force all of the status effects in the mod to be recalculated.
• Fixed Vitality not levelling up the Resistance skill. It should now increase normally.
• Fixed Perseverence skill not providing bonuses to the Capability status effect.

1.2.0 (Experimental, use 1.1.2 if you have lots of issues)

• Added a new status effect (Capability) and associated skill (Perseverence). Capability is a measure of how long your character has gone without sleeping. As you go longer without sleeping you will level up your Perseverence skill, which will allow you to go for longer durations without sleep. Staying awake too long will negatively impact your Vitality and Energy, so take care and prepare to make camps on long journeys! This new effect skill pair comes with full configuration options and can be turned off if desired.
• Added a new save system that will remember your last Vitality / Energy / Capability skills on logout and subsequent login. Thank you OrianaVenture for help with saving custom data.
• Recoded a ton of the mod to help optimise things - this doesn't have much noticeable impact in game but calculations should now only occur when needed and hopefully will improve performance slightly on lower end machines.
• Updated BepInEx dependency to 5.4.2333
• Fixed an issue where screen would flash when the player was under the effect of the Staff of Protection but not receiving any damage from the mod's status effects.

1.1.2

• Updated ServerSync to fix Playfab error

1.1.1

• Old DLL was still present in the zip archive. Correct updated version now included. No change from 1.1.0

1.1.0

• Compiled against the latest version of Valheim 0.220.3
• Updated BepInEx dependency to 5.4.2202

1.0.8

• Replaced the temporary skill loss to max stamina reduction on low energy to try fixing compatibility with NorseDemigods and any other mods that determine sumoon strength from skill levels. (Thanks Solo for testing!)
• Replaced config options for skill loss with max stamina loss. The default value is a 50% loss of max stamina at 0% energy.
• Removed some unused scripts still floating around from 1.0.6 and prior versions that survived in case 1.0.7 was still bugged on servers.
• Updated localizations for new messages based on max stamina reduction in the player HUD.
• The [skill_all] message should no longer appear in the compendium, since this mod no longer affects skill level changes, only skill gain rates. Thank you to everyone who reported this one - I tried to localize it in the past with no success, but now it's no longer an issue anyway.

1.0.7

• Major rewrite of the player environment stat and food tracking to hopefully resolve some issues on servers.
• Replaced static player environment stats and food cache with a new invisible status effect, which is individual to the player. This will hopefully eliminate the need for all mods to link to all player cached data, which was probably the issue causing logout crashes.
• Cold and freezing multipliers for vitality loss no longer stack when the environment is set to cold and freezing. Now it will only apply the worse of the two situations.

1.0.6

• Added Korean translations provided by Love5225 - thank you!
• Changed player environment stat logging slightly to catch potential compounding data issue (thanks Solo, hope this helps maybe!)

1.0.5

• Fixed the physical and elemental weakness debuffs not being removed properly and instead instancing over and over again when vitality gets too low.
• Added missing localization for missing keys.

1.0.4

• It helps when I press the save button before compiling the DLL, lmao.
• No change from 1.0.3, other than the fact you'll actually have version 1.0.3 (now labelled 1.0.4) this time. Sorry about that.

1.0.3

• Fixed issue with player carry weight changes. Additional energy loss will calculate based on current player carry weight limit after status effect changes and not just the base carry weight of the player.

1.0.2

• Fixed Energy status effect disappearing when energy falls below 40% due to icons not loading properly.

1.0.1

• Fixed Hugin's tutorial labels in the compendium. They should now appear like the others on new saves.

1.0.0

• Initial Release