UPDATE

By courtesy of pietro0games1 an alternative Nourishment mod has been uploaded. He reworked the original Nourishment mod to use a magic effect to raise the stats instead of altering the actor values, so mod removal should be cleaner. It comes with a Complete Alchemy Overhaul patch. Use either the original mod or pietro's - the caco patch is not compatible with the original Nourishment.


PREFACE
This mod was inspired by a well known mod called SPERG, a perk overhaul that debuted on LE, the author seorin is a good friend of mine whose programming and logic talents I deeply admire and impelled me to build this mod. Although he is retired, his mod became ported to SE, though with a bit limited support, thus it is a little hard to make it compatible with newer mods in the scene, specially the lesser (still amazing) functions that didn't come with the perks. This mod is a standalone version (with a slight different approach/vision) of one of my favorite functions that his mod had, in which you could eat food and, in time, permanently raise your stats the more you eat.

A fun thing in Skyrim is the feeling that everything you do (while actually playing the game and not playing some daunting grinding activity like getting constantly pinched by a mudcrab at riverwood) contributes to your character development. This mechanic adds to that feeling.

WHAT DOES IT DO?
Whenever you eat a food item, this script runs and checks what effects are associated with it. Whenever it finds a Health/Stamina/Magicka related effect, it will consider the Magnitude and Duration of that effect, then it will create a proportional amount of Health/Stamina/Magicka Experience and bestow it to the player. When you eat enough foods that affects certain atributes, your atributes will level up and raise by 1 point permanently each time. Carry Weight is also affected.

HOW DOES IT WORK INTERNALLY?
Each food item may have one or more magic effects. Internally these magic effects have "keywords" associated, these are mostly used to identify the nature or characteristics of these effects and check them in code to do specific things. Like, for example, MagicAlchRestoreHealth is a keyword every vanilla food piece that has restores health effect has - whenever you eat a Red Apple (restore 2 points of health), the script checks for this Keyword, and if it finds it, gives your player health nutrition.

WHAT DOESN'T IT DO?
This mod doesn't add new food magic effects, it neither alters the existing food magic effects for maximum compatibility, except for adding a missing Keyword on some of them. Also, Homecooked Meal was altered - check compatibility for further details.

FEATURES

• Provides Health, Magicka and Stamina permanent gains when consuming enough food items.
• Carry Weight is also affected - any piece of food or drink (except potions and ingredients) (regardless of effect) nourishes your character and enhances their carry weight stat, so every snack and meal will contribute to your carry weight nourishment. It is balanced to avoid much faster gains than the other atributes.
• The stats are added via scripting, not magical effects, so your stats will rise just as they do when you level up - no Active Effects clutter. (Though there is currently no way to know how many stats you have raised from eating).
• Whenever you reach an atribute level up, you will get a notification on the top left corner.
• Food stat gains cap at 500 points in each atribute. (Subject to change or become adjustable).
• Alcoholic food items that harm stamina will still yield Stamina nourishment, but the calculated experience from it's comsumption becomes severily hampered.
• The greater the food effects are, the greater the experience amount you'll get. The most powerful stews and dishes will nurture you the most on multiple atributes.
  

COMPATIBILITY.

• This was made on downgraded Skyrim 1.5.97 - it uses SKSE pre-AE so this may not work on Anniversary Edition, sorry, I started learning papyrus on this madness of a transition and it all goes way over my head.
• Compatible with Unnoficial Skyrim Special Edition Patch.
• Comes with a very small patch for Creation Club's Survival Mode within the main file. You can deactivate it or just delete it if you don't want it.
• It is compatible with Creation Club's Fishing, out of the box (all the fishes use the same health restoration effect).
• Provided a patch for Apothecary - An Alchemy Overhaul's Food and Drink Addon - their mod introduces new magic effects with new keywords, I basically put a vanilla keyword on those new effects and balanced the experience gains, their effects had much greater magnitudes and durations. NOTE: this patch is not intended for "Apothecary Food Duration Tweaks", if only duration tweaks were changed, there will be no problem using it, you just may find very slow to level up your stats with the new smaller durations.
  NOTE: Apothecary Food Addon developed a little on the drug items like skooma - items they marked as a drug won't contribute to nutrition in any way.
• Nourishment doesn't conflict with SunHelm in any way, according to SSEEdit.
  

NOTE: Any mod that alters vanilla foodMagicEffects or that replaces them on the food items with their own, most likely will contain their own keywords (like CACO), in that case, Nourishment won't be able to identify the ingestibles's atributes.
WHAT DID THIS MOD CHANGE IN THE ORIGINAL RECORDS?

• FoodFortifyMagicka magic effect lacked any keywords - added MagicAlchBeneficial and MagicAlchFortifyMagicka to it.
• Homecooked Meal used to bestow a full perk that would give the player Health, Stamina and Magicka regeneration rate. It was mighty redundant and weird so instead, upon eating it, you will get the 3 magic effects directly, this was made so Homecooked Meal worked with this mod. Turns out this was already done in Unnoficial Skyrim Special Edition Patch, so no biggie if you're using it already.
  

FIXES

• Implemented a fix (well, a workaround), in which thanks to Anniversary Edition, Survival Mode, or IDK, pretty much any mod that would alter carry weight base value stat in some manner I still don't know), your Carry Weight food stat gains would become lost on game loading. I don't know man, carry weight is so weird it just doesn't stay put. I detected this issue with SPERG on SE as well but the script there had much more functions that I couldn't understand why.
  Your carry weight level ups will be stored on a global variable. Everytime you load the game, a quest with a small script will run one time, check for your Carry Weight level ups and apply them to the player's reverted carry weight, you will get a notification on the top left corner everytime you load, stating how much carry weight points have been restored, sorry; subject to change.Anyway, you shouldn't, but if you see you're getting free carry weight points on every game load, please do let me know.

UNINSTALLATION

• Open the console and type "Help Nourishment"
• Search for SPEL: <nourishment ability ID> 'Nourishment' line.
• Type player.removespell <nourishment ability ID> hit enter.
• Quit the game and remove the mod.
• WARNING: I'm no professional regarding the technicisms behind baked save files and stuff, I don't know if this will be enough to leave your save clean from nourishment. Please try the mod on a separate save file and determine if you like it or not before commiting.
• WARNING: If you remove the mod, you will retain your Health, Magicka and Stamina permanent gains, but Carry Weight level ups will become lost on the next save load.
  

TO DO LIST
-I will try to make it compatible with Complete Alchemy Overhaul in the future, I don't use it anymore but I reckon it's immensely used. But it'll have to wait a bit.
-Learn to do MCM for adjustable settings.

DISCLAIMER
I wanted to keep seroin's vision about contributing to the community (I've downloaded many mods and until now I wasn't able to give something in return other than endorsements), so the source code of my script is fully open and fully comented if you want to take use it as a guide, inspiration, or an excercise if you want to dive into papyrus. Feel free to tweak it. Just do please make some mention of my username.

This is my second mod, but it is my first time programming a script, I used the wiki documentation and read other author's mods source scripts out there to see how things worked, feel free to point in redundant or silly approaches of mine if you think they could be optimized.

Special thanks to MrowrPurr for her fantastic scripting video tutorials on youtube.