Basic Needs for OpenMW

A small mod I made just to learn how to use OpenMW's Lua API.

The mod is still fresh and there might be bugs and other oddities, due to OpenMW Lua still being a moving target, and me still getting acquainted with the scripting API.

Requires a recent development build of OpenMW (mine was built straight from 0.49.0 sources in June 2023), as the mod uses the fresh Actor Spells API to dynamically add and remove debuffs from the player.

Mod requires a new game.
Disabling mod and enabling it again mid-playthrough is NOT supported, as it breaks data mapping.

Features

• Accumulate thirst, hunger and exhaustion while adventuring, accrue penalties for untending needs for too long. Drink, eat and sleep to recover. Player gets informed whenever their status changes and there is a widget on the HUD.
• Uses an internal whitelist table to determine how much a consumable changes thirst, hunger or exhaustion. You can stave off exhaustion with a tactical use of moon sugar or skooma. No changes to existing items, all is powered by OpenMW Lua.
• Press Sneak while swimming to refill a single water container in your inventory. This works with most of the bottles and jugs in the game, as well as of those in the supported mods. Bottle refilling is disabled if Thirst is disabled.
• Sleep in a bed, hammock or bedroll for at least 7 hours and gain a Well Rested (+5 Luck) bonus for 8 next hours. Resting or waiting without a bed will recover exhaustion only at a half rate. Well Rested functionality is disabled if Exhaustion is disabled.
• When fast travelling, trip length is a factor. The longer the trip, the more you'll get accommodated during the travel. Multiple short trips will accumulate needs at a faster relative rate than a single long one, where we can assume the shipmasters and caravaners will provide some provisions and a place to rest for the travelers.
  
  

Known bugs, oddities

• Used bottles doesn't show up in inventory immediately, but requires one to close and reopen inventory screen, or do some other action in the inventory. This is just a visual oddity.
• Bed recognition isn't 100% accurate. It might not always work, if you activate a bed from weird angles or spots, but it works most of the time. I can't do anything about this right now, but fix might be possible in the future OpenMW versions. It's still better than no bed recognition at all.
• You must start a fresh new game for mod to work properly. The mod relies on creating new item records for water bottles at the start of the game. Adding a new mod in the middle of a playthrough, even if the mod is listed as supported, doesn't add functionality to the new items.
  

Effects

Thirst
As your thirst grows, you'll start feeling dizzy and may find it harder to focus on activities requiring concentration or fine-motor skills.

- 0-199 :: Quenched (No effect)
- 200-399 :: Mildly Thirsty (-6 Willpower, -3 Agility)
- 400-599 :: Thirsty (-9 Willpower, -6 Agility)
- 600-799 :: Parched (-12 Willpower, -9 Agility)
- 800-999 :: Dehydrated (-15 Willpower, -12 Agility, Stunted Magicka)
- 1000- :: Death

Hunger
As hunger increases, your muscles weaken, your ability to recover diminishes and your mood darkens.

- 0-199 :: Sated (No effect)
- 200-399 :: Peckish (-6 Strength, -3 Endurance)
- 400-599 :: Hungry (-9 Strength, -6 Endurance, -3 Personality)
- 600-799 :: Famished (-12 Strength, -9 Endurance, -6 Personality)
- 800-999 :: Starving (-15 Strength, -12 Endurance, -9 Personality)
- 1000- :: Death

Exhaustion
As you become more and more tired, your movements and ability to think get increasingly sluggish and your immune system weakens.

- 0-199 :: Refreshed (No effect)
- 200-399 :: Mildly Tired (-6 Speed, -3 Intelligence)
- 400-599 :: Tired (-9 Speed, -6 Intelligence, Weakness to Blight/Disease +30%)
- 600-799 :: Drained (-12 Speed, -9 Intelligence, Weakness to Blight/Disease +60%)
- 800-999 :: Exhausted (-15 Speed, -12 Intelligence, Weakness to Blight/Disease +90%)
- 1000- :: Death

Consumable values, water containers
The mod supports patches for other mods, so there are too many items to list here. Consult the data tables to find the most up-to-date information on different consumables.

Supported mods

• Tamriel_Data
• OAAB_Data
  

See the GitHub repository README for more.