File information

Last updated

Original upload

Created by

Clockmon

Uploaded by

clockmon

Virus scan

Some manually verified files

About this mod

This mod expands upon the original Simple Needs mod from Treb by altering various aspects of the eating, drinking, and sleeping needs, including making many factors configurable.
Please see the article for proposed V2.0.

Requirements
Permissions and credits
Changelogs
Name: Simple Needs Expanded
Requirements: 7-Zip, SimpleNeeds.esm, FOSE
Recommended: Fallout Mod Manager
Author: Clockmon

Description Summary
===================
This mod expands upon the original Simple Needs mod from Treb by altering various aspects of the eating, drinking, and sleeping needs, including making many factors configurable.

Summary Overview
================
I really liked Treb's Simple Needs mod for basic food, water, and sleep requirements.  I decided to change it and have used it for a while.  After a time I thought maybe others would enjoy my "expanded" version like I do.
1 - Adds a menu to configure various factors with default levels, such as how often to check your needs, how much of each you need daily, and player feedback.
2 - Increased the number of needs levels from 4 to 5.
3 - Change the levels of ill effects from 1 to 5 with increasing difficulty.
4 - Changed some of the processing, including how sleeping works.

If you installed the Unofficial Fallout 3 patch by Benwah and team, every effort is taken to ensure this mod and compatibility patches incorporate those fixes so they are not undone.

If you want a more in-depth needs system, I recommend:
  BasicNeeds by AnT01, https://www.nexusmods.com/fallout3/mods/1222
  RI - Primary Needs by KSchenk, https://www.nexusmods.com/fallout3/mods/2125

Full gory details are at the bottom.

Required Mods
=============
Simple Needs by Treb, https://www.nexusmods.com/fallout3/mods/3769.

Required Files
==============
SimpleNeeds.esm

Optional Compatibility Files
============================
Use the following compatibility mods for the DLCs.  Due to the variety of sources, I recommend making a merged DLC esp once they are all installed for easier managing.

(1) Operation Anchorage: use my Simple Needs Expanded - Anchorage.esp, included as an optional file with this mod.  Do not use Treb's SimpleNeedsAnchorage since there are differences.

(2) The Pitt: use Captain Cookie's DLC patch at https://www.nexusmods.com/fallout3/mods/7662.  It makes Slop compatible.
(2.1) The Pitt: also use my Simple Needs Expanded - The Pitt Beds.esp, included as an optional file with this mod.  It makes a new bed type compatible as a regular bed.  If you use "SimpleNeeds - The Pitt Beds.esp" instead https://www.nexusmods.com/fallout3/mods/22998, the beds will be player beds.  Your choice.

(3) Broken Steel: use Captain Cookie's DLC patch at https://www.nexusmods.com/fallout3/mods/7662.  It makes the new waters and basin water compatible.

(4) Point Lookout: use Captain Cookie's DLC patch at https://www.nexusmods.com/fallout3/mods/7662.  It makes punga fruits and moonshine compatible.
If you want it to follow the Expanded rules, use FO3Edit to change 2 items:
Wild Punga Fruit: value and restore health from 10 to 2.
Refined Punga Fruit: Value from 30 to 15, restore health and rads from 15 to 8.

(5) Zeta: use my SimpleNeeds - Zeta.esp, at https://www.nexusmods.com/fallout3/mods/23030.  It makes alien food compatible and fully meets the Expanded rules.

NOTE: You can use the following compatibility patches (made for the original Simple Needs), and your eating, drinking, and sleeping needs will be fulfilled.  These do not adjust the item values or restore healing/rad effects per my Expanded guidelines.  Look for "Simple Needs Expanded" compatibility patches if you want those rules followed (if so desired).
  -- ContagiousCure's Compatibility Patch for MMM and Simple Needs, https://www.nexusmods.com/fallout3/mods/20955
  -- Simple Needs - A World of Pain FO3 Compatibility Patch, https://www.nexusmods.com/fallout3/mods/22989
  -- Simple Needs - DC Interiors Project Compatibility Patch, https://www.nexusmods.com/fallout3/mods/23001
  -- Simple Needs - Busworld Compatibility Patch, https://www.nexusmods.com/fallout3/mods/23003

- Finally, I have included a full listing (rich text and pdf for easier viewing) of the ingestibles affected by the base Simple Needs Expanded esm.

Install
=======
1. Ensure you have Treb's Simple Needs V4.5 installed.
2. Extract the Simple Needs Expanded.esm in the archive to the Fallout 3 Data folder.  Do the same with any desired compatibility esps.
3. Start Fallout 3 Launcher or FOMM and disable all Simple Needs files.
4. Start Fallout 3, save the game, and exit.
5. Enable SimpleNeeds.esm, Simple Needs Expanded.esm, and any compatibility esps (Expanded versions instead of original Simple Needs if installed).
6. Start Fallout 3 and load the game you just saved.  All processing has been reset and your "Needs Status" quest will restart.  Save your game.
   *** If you do NOT see the "NEEDS STATUS" quest appear, the mod will not function correctly! ***

Load Order
==========
- Main esm: Load low after SimpleNeeds.esm.  Load after any mod that changes food, drink, or beds since those will delete the Simple Needs effects.
- DLC compatibility patches: Load after the main esm and after any associated DLC.

Uninstall
=========
1. Disable the esm/esp files.
2. Delete the Expanded esm/esp files.

Upgrade (if available)
======================
Follow the installation instructions and overwrite any files.  You will need to restart the NEEDS STATUS quest.

Compatibility
===============
- This mod works with Treb's and Cipscis' Blanket mod https://www.nexusmods.com/fallout3/mods/5279, and it will be player-owned for the Well Rested perk.  I have found it to be very comfortable while out exploring.
- This mod is compatible with Dark Uncle's "RI Primary Needs or Simple Needs Plugin for DUI" (shows needs quotas in the HUD), https://www.nexusmods.com/fallout3/mods/11329.  Use the SimpleNeeds_DUI_Plugin.esp, and I recommend turning quota addition/deduction messages OFF.  In case you cannot get the HUD mod to work, you can use the Display Quotas function included with my mod.

Incompatibility
===============
- Will conflict with other mods that add or change food, water, or beds such that they delete the Simple Needs effect.  I will work on compatibility mods if allowed.  Otherwise, you should be able to make your own patches using FO3Edit like I began with.
- Compatibility patches for the original Simple Needs will work with this mod but with some differences:
  -- All new beds will provide the Well Rested perk as they are designated player beds.
  -- Item values and restore health/rads effects will be unchanged (not a major issue).

Known Issues or Bugs
====================
- Just like the original, Simple Needs Expanded needs compatibility patches to support official downloadable content and other mods that add new ingestibles or beds.
- Status messages may lag a bit from the actual quest status.  This means warning messages may still appear after you remedy the situation - please be patient as the processing catches up.
- Due to the fraction rounding with certain settings, you may fall just short of 100%, but still well within the upper needs tier.  Sleep calculations are adjusted to ensure sleeping the required amount grants the Well Rested perk (if using a player-owned or rented bed).
- IMPORTANT: If your sleep is stopped by the system, the game clock advances an hour sometime after the sleeping scripts, and would deduct an hour's worth from your quotas.  I included a workaround for this, but you will get false deduction messages for the event.  I have tried to fix it, but am stumped by this one.  There is an option in the Simple Needs menu to skip this processing if the false messages become too irritating.  Your Display Quota function will display the correct levels.

History
=======
1.0 - Initial release.  Main file, Anchorage and Pitt Beds compatibility patches.

Contact
=======
You can find me on the official Fallout 3 Nexus forums as 'Clockmon."

Credits
=======
- Bethesda for creating Fallout 3.
- NexusMods for a one-stop-shop resource for authors and players.
- LHammonds for the Readme Generator this file was based on at http://hammondslegacy.com.
- Treb for creating Simple Needs and Anchorage patch, https://www.nexusmods.com/fallout3/mods/3769, and permitting me to work on this effort.  Thank you!  I learned much while reviewing your work, made easier with your script comments.
- CaptainCookie for the original Simple Needs DLC patches for Broken Steel, The Pitt, and Point Lookout, at https://www.nexusmods.com/fallout3/mods/7662.
- BenWah, Hairylegs, RoyBatterian, and prisoner416 for the Unofficial Fallout 3 patch at https://www.nexusmods.com/fallout3/mods/19122.
- Cipscis for helpful menu tutorials at http://www.cipscis.com.
- Lork for the Sprint Mod, https://www.nexusmods.com/fallout3/mods/1854, whose menu methodology provided the insight I needed to make mine.
- ContagiousCure for Compatibility Patch for MMM and Simple Needs, https://www.nexusmods.com/fallout3/mods/20955.

Tools Used
==========
- Q and Timeslip's Fallout Mod Manager - https://www.nexusmods.com/newvegas/mods/54991
- ElminsterAU's Fallout 3 Editor - https://www.nexusmods.com/fallout3/mods/637
- Garden of Eden Creation Kit - http://geck.bethsoft.com or https://www.nexusmods.com/fallout3/mods/759
- 7-Zip at https://www.7-zip.org/ or http://www.tesnexus.com/downloads/file.php?id=15579

Licensing/Legal
===============
Per the permissions area in the mod page.


========================
Now for the Gory Details
========================
First of all, I continued to use Treb's 24-hour needs cycle and the guidelines for food weight and restorative quality; the food's weight indicates the degree to how much of your food quota it restores.  I have included a separate file that lists food, drink, and stimulants.

1.  The first major addition you will notice is a menu to set many configurable variables, some of which are connected to new features.  You can change these at any time and don't have to reset the Needs Status quest.  However, if at any time you need to reset the quest just do the following (I did this a lot during testing):
    - disable all Simple Needs and Expanded esms and esps
    - start, save the game, and exit
    - enable the esms and esp
    - start the game and load the game you just saved.

[Expanded Default value]

I have included the original Simple Needs default values within the menus if you want to use those instead.
1.1  Update quota rate (hours)        [1], 2, 3, 4, 5, 6
Each needs quota is lowered hourly instead of 6 hours, but the quotas drop at the same overall rate - about 4.17% every hour.

1.2  Food needed daily (pounds)       1, 2, [3], 4, 5, 6
By default you need 3 instead of 1 pound of food a day.  Food that weighs 1 pound will do more good than food than weighs only 0.1 pounds.  Cannibalism provides 1 pound worth of food instead of 100% of daily food needs.  If you have the Hematophage Perk, a Blood Pack provides 1 pound worth of food and 1 equivalent bottle of purified water.

1.3  Water needed daily (bottles)     1, 2, 3, [4], 5, 6, 7, 8
You now need 4 bottles worth of purified water instead of 2 (more for lower quality water sources).

1.4  Sleep needed daily (hours)       1, 2, 4, 6, [8], 10
You now need 8 instead of 6 hours of sleep a day.  Sleeping restores your sleep quota based on how many hours you set.  For example, with 8 hours a day, 1 hour of sleep restores 12.5 points to your 100-point quota.  For 6 hours of sleep needed, 1 hour restores 16.67 points (approximately).

1.5  Stimulants (hours)               1, [2], 4, 8, 12, 24
Stimulants restore a flat amount to your sleep quota and is independent of your daily sleep need (for example, 6 or 8 hours a day).  A 2-hour stimulant will restore 2 hours or just over 8% of your 24-hour (100-point) sleep quota.  The default went from 24 to only 2 hours.

1.6  Well Rested sleep req (hours)    1, 2, 3, [4], 5, 6, 7, 8
You need 4 hours of interrupted sleep in a player-owned or rented bed to get the Well Rested perk.  If you cancel before the 4 hours, you do not get the perk.  The original default was technically 0 hours (start sleeping and cancel immediately, a bug in the original game).

1.7  Show quota addition messages     [ON], OFF
1.8  Show quota deduction messages    [ON], OFF
There are messages for when any quota drops (due to time) or rises (due to eating, drinking, and sleeping).  You can turn these off if you want.  The main reason you would disable them is if you are using another mod that shows your needs quotas on your HUD (such as Dark Uncle's patch for Simple Needs).

1.9  Map Display Quota message key    [L], any key not used by the game
This was a mod for the original Simple Needs that is included with the Expanded version.  If you press the "L" key, a message will display your current needs quotas, how many hours until the next drop, and the projected levels.  I used the L key (list quotas) since the N and G keys are often used for nightvision goggles and grenades, respectively.  You can set the key to anything not used by the game.

1.10 Ill effect difficulty            [1], 2, 3, 4, 5
There are more ill effects available at more quota levels (see below).  It is set to Treb's original effects by default.  Increase the severity for a greater survival challenge.

1.11 Toggle future checks             [ON], OFF
This allows you to skip checking for future starvation and dehydration while sleeping.  This processing has a minor bug that produces false deduction messages for food and water.  If these messages become too annoying or if you want to sleep and risk the chance of waking up starving or dehydrated, turn this OFF.

1.12 Warning message delay (hours)    0.25, [0.50], 1, 2, 6
You will get warning messages to remind you of any ill effects you are suffering.  This is useful if you happened to miss the alert due to a high-intensity situation.  If the ill effects difficulty is set to very easy or easy, you will get warning messages when your quotas fall below 25%.  Use the 6-hour option to effectively turn them off.


2. There are now five instead of four levels for food, water, and sleep with new descriptions.

Level     Food                             Water                            Sleep
--------              --------------                     -----------                         -------------
>75                 Not Hungry                 Not Thirsty                 Not Tired
>50, <=75     Mildly Hungry             Mildly Thirsty             Mildly Tired
>25, <=50     Moderately Hungry  Moderately Thirsty   Moderately Tired
>0,  <=25       Extremely Hungry     Extremely Thirsty      Extremely Tired
0                      Starving                       Dehydrated                  Fatigued


3.  There are more ill effects to suffer from.
Level 1: Very Easy
FoodStarvation: AGL-1, AP-20, -1hp/sec
WaterDehydration: END-1, DR-10, -1hp/sec
SleepFatigue: PER-1, INT-1

Level 2: Easy (added hp loss if Fatigued)
FoodStarvation: AGL-1, AP-20, -1hp/sec
WaterDehydration: END-1, DR-10, -1hp/sec
SleepFatigue: PER-1, INT-1, -1hp/sec (added hp loss)

Level 3: Moderate (added ill effects at extreme levels)
FoodExtreme hunger: AGL-1, AP-20
FoodStarvation: STR-1, AGL-2, AP-30, -1hp/sec
WaterExtreme thirst: END-1, DR-10
WaterDehydrated: PER-1, END-2, DR-15, -1hp/sec
SleepExtreme tiredness: PER-1, INT-1
SleepFatigued: PER-2, END-1, INT-2, -1hp/sec

Level 4: Hard (added ill effects at moderate levels)
FoodModerate hunger: AGL-1, AP-20
FoodExtreme hunger: STR-1, AGL-2, AP-30
FoodStarvation: STR-2, CHR-1, AGL-3, AP-40, -1hp/sec
WaterModerate thirst: END-1, DR-10
WaterExtreme thirst: PER-1, END-2, DR-15
WaterDehydrated: PER-2, END-3, AGL-1, DR-20, -1hp/sec
SleepModerate tiredness: PER-1, INT-1
SleepExtreme tiredness: PER-2, END-1, INT-2
SleepFatigued: PER-3, END-2, CHR-1, INT-3, -1hp/sec

Level 5: Very Hard (added ill effects at mild levels)
FoodMild hunger: AGL-1, AP-20
FoodModerate hunger: STR-1, AGL-2, AP-30
FoodExtreme hunger: STR-2, CHR-1, AGL-3, AP-40
FoodStarvation: STR-3, CHR-2, AGL-3, AP-50, -1hp/sec
WaterMild thirst: END-1, DR-10
WaterModerate thirst: PER-1, END-2, DR-15
WaterExtreme thirst: PER-2, END-3, AGL-1, DR-20
WaterDehydrated: PER-2, END-3, AGL-2, DR-25, -1hp/sec
SleepMild tiredness: PER-1, INT-1
SleepModerate tiredness: PER-2, END-1, INT-2
SleepExtreme tiredness: PER-3, END-2, CHR-1, INT-3
SleepFatigued: PER-3, END-2, CHR-2, INT-3, -1hp/sec


4.  Processing and item changes:

4.1  Food:
  - Radroach Meat was changed from 0.5 to 0.2 to be comparable to Ant Meat (yuck).
  - NukaLurk Meat now provides a stimulant effect, probably from having grown up around Nuka-Cola products and supplies.  You might notice a slight tingle from it!
  - Cave Fungus is now compatible (snack food).

4.2  Food item values and restore health/rads effects are changed according to any weight adjustments.  This is so they do not become more valuable per pound if the weight drops.  Values are rounded up to the nearest integer.  Chem and drink values are not changed.  Negative effects such as radiation damage from irradiated food are left unchanged.  These changes should make Stimpaks and the Food Sanitizer more valuable to the player.

4.3  Actor Effects are changed for some Fallout 3 water types:
  * Purified Water went from 25% to 50% (Good water, assumes purified water quality)
  * Good and Average Waters stays at 25% (Thirst quencher, not to be confused with the needs category "Good Water")
  * Bad, Terrible, and Lethal Water went from 25% to 20% (Lite Drink).
Although primarily based on the radiation level, I considered the rating also reflects the water quality.

4.4  If you let 30 minutes pass then "wait" one hour, your quota is reduced by 1.5 times the reduction factor to account for the extra time since the last quota deduction.  Also, if you are just a few points away from 0%, the system will not wait for the full cycle until the final points are deducted.  For example, if you are using the 6-hour quota frequency and just went to 1 point after the most recent deduction, it won't wait another 6 hours for you to go to 0.  Keep those quotas up!

4.5 If you happen to eat just before the deduction cycle, what you just ate is not deducted; the oldest "calories" in your body are deducted.  If you were at 0%, the system will wait until those calories are deducted - they cannot immediately go away.

4.6  Regular beds that are not player-owned or rented do not provide the Well Rested perk anymore.

4.7  You cannot start the sleep cycle if you are currently Starving or Dehydrated.

4.8  Once you select how long you want to sleep, the process is cancelled before you start sleeping if your food or water quotas will go to zero while sleeping.  This is the source of the bug mentioned earlier.  I originally wanted to wake up the player at the point you became starving or dehydrated, but could not get that to work.  The current process is a compromise.  Just be sure your food and water quotas are sufficient before prolonged sleep.  Try to avoid sleeping if your food or water quotas are at the Extreme level (under 25%).  Or, turn the future condition processing OFF and risk waking up starving or dehydrated.

Final Note: If you have any suggestions for improving the mod or the script code, please contact me.  This is my first major scripting mod, so it will not be optimal.  I'm sure it doesn't use the full capability of the functions and techniques available.  I used brute force in many solutions, and kept it as easy as possible for me to understand.  Thank you, and enjoy!
REPORT BUG
Top