Extention/Expansion
for/of
Motion System
or E-Motion for short xD
Its a system? Theres a system?!
No idea. Sounds cool tho. :3

Author(s): theimmersion
Current Version: v0.3.0.0000a (public alpha build)

UPDATED DESCRIPTION due to many TL;DR complaints. xD
Tho i absolutely understand, so i changed it.
The IMPORTANT stays the same tho.
==================
    IMPORTANT!
==================
THIS IS A PUBLIC ALPHA BUILD
The code/scripts on lower end PCs might respond slower (Script Lag).
That can affect the overall papyrus functionality and impact game performance and/or other mods might misbehave.

This mod changes "SpeedMult" value and uses "ForceActorValue" function to do it.
Use this mod at your own risk!
I made a thread to get more info upon that and its risks but nobody responded. :(
So, im gonna treat it as a potential risk to use. And your responsible for using it because you have been warned.
Personally im using it for years now (VERY OLD MOD OF MINE). Never had issues.
I think i tried SetActorValue but if i remember, it didnt cut it. Old script recoded so cant remember.
Probably used ForceAV for a reason tho. :/

If starting a new game, dont enable the mod until your out of the cave!
Or at least after the headsman's scene.
Or at least least after the cart scene.
But thats it, SRSLY! AFTER THE CART SCENE!
Especially dont enable the mod before the starting sequence in the cart. xD
Potential flying cart bug and other weird behaviour with that thing. xD
Funny as h*ll tho. You can try to see it but dont continue with it, start over with the mod disabled.
TRUST ME D*MMIT, I MADE THIS MOD! xD      aaaand beacuse i made this mod. xD

Also, very important!
Use MCM to uninstall.
Since it modifies the SpeedMult Actor Value and some other core settings.
It is very important that you use the uninstall function in the MCM menu before removing the mod.
Uninstall process will return the SpeedMult to its default value, made when the mod first initialized.
And the rest of the settings as well.
And also, script bloat might be an issue if you dont follow the uninstall instructions.
As all the scripts do with papyrus tho. -.-
The only risk even after uninstallation still remains with SpeedMult Actor Value tho. So keep that in mind.
But theres also a chance to fix it too if it comes to that. ForceAV SpeedMult in console.
Google for more information about all that.

Now that we have the risks out of the way. xD


===================
    DESCRIPTION
===================
This mod is aimed and everything motion related.
It is a immersion mod to try and emulate real world movement behavior in many various ways.
Like:
Adds stamina drain to running and jumping. (starting off with something easy on ya.)
Modifies the jump height and drain by Race, stamina and carry weight.
Modifies movement speed based on Race and carry weight.
Modifies fall height by Race and carry weight. Drastically.
Modifies (slows down) sneak running.
Adds functionality to Sprint key when walking to walk faster.
Adds a dynamic movement ramping system.
Adds stamina drain when swimming based on Race and carry weight.
Modifies swimming speeds based on Race and carry weight and stamina.
Enables faster movements when overencumbered. Emulates running and sprinting.
Removes overencumbered notification.
Adds a slow casual walk key (X). - It makes you super fast if your a vampire tho.
(Now you can walk and run through Solitude or Whiterun etc and not look like your being chased by wolfs.) xD
Adds a super jump for lack of climbing on (V) key. (To be redone, its kinda cheaty atm. Will remain same when being a vampire tho.)
Also, walking lowers the possibility of getting hurt when climbing down from some heights.
Crouching helps even more. Youll get hurt sometimes but you want be knocked down.
Like in RL when you sit on a ledge and then slide down to lower the distance between your feet and ground as much as possible.
You dont crash but your feet sometimes hurts from the fall. Like ya never climbed a tree as a kid before?! xD

Now this is the most base description i could make.
It maybe doesnt mention a few things, sorry in that case.
When i say based or Race, i really mean i researched the Race Lore (Where they lived and how they lived),
and made comparisons to RL species that could be compared.
Mostly was taken in account the muscle types and the ration and location of them since the physiology doesnt compare other than to humans.
And i was researching some stuff myself with my buddies with jumping and running while carrying heavy stuff etc. Not kidding. xD
(not the swimming tho, its still cold as f*ck to go for a swim) xD
My buddies because i needed a tall and a short guy (thnx guys xD) and we just made fun of the fat guy (sorry bro. xP).
We tested the person height and leg spans when jumping and running around (tall guy vs short guy).
Some how tho, i was the one that made most testing when carrying heavy stuff. >:\ (fat guys payback xD)
Their my fiends dont worry about the cheesy calls. They rather like that than telling real names.
Mofo CIA on internet issues, i guess. xD

Only the player should be affected.
Only playable Races are part of the formula and Werebear race for mods that enable that transformation
and only if that mod does that with the vanilla Werebear race.

About the jogging speed when overencumbered.
This should actually incurage players to get overencumbered,
while still punishing the player enough to not totally ignore weight limit.
It will greatly ease travel when overencumbered making it viable alternative to (frankly and honestly) mostly ending up in cheating (TGM)
or leaving items or dropping/swap inventory items for new ones.
And thus, making players avoiding the weight limit at all possible costs,
making unesecary sacrifices (leaving gear behind and most of the time never getting it back again)
or falling back to TGM cheat to bypass run and travel limitations, making the player not invest into the situation at all.
This should actually make players invest more, think of the situation, items and travel efficiency and if worth the trouble.

THERE! YA HAPPY NOW? xD xP kidding.
(wrote kidding because people ignore this -> xD <- its a hard and fond laugh symbol.)

Please give my mod a chance.


==================
    WHATS NEW?
==================
Added almost everything that the mod changes in MCM configuration.
Its rather raw but with most features manipulated by MCM now.
Ill have to recode from scratch in the future to get most out of MCM configuration capabilities.


============
    NOTE
============
Due to a mistake on my part, for the mod to do its job, you need to be in walk mode all the time.
Im working on it.
I play like that so i coded like that. Im seeing to it to recode the whole script from scratch (Who knows for which time im doing it.)
to make it more efficient (faster, more responsive and less intensive on performance)
and to fix any left over bugs or mistakes i might have done.

When overencumbered and using God mode.
Use TGM Switch by holding the (V) key for longer than 1.2 seconds.
Once out of overencumbered state or disabling God mode,
press the key again for longer than 1.2 seconds to disable the switch.
Has to be like this due to lack of functions.
[if SKSE team stumbles on this] - (if ever and if possible ofc)
Need UpdateSpeed() that works like UpdateThirdPerson() for movement update.
Need PlayerRef.IsGodMode() return value false true function.
Need GetAngleCrosshairX,Y,Z() to return values when in third person without weapon ready.


=====================
    COMPATIBILITY
=====================
General:
Should not make any hard conflicts with any mod.
Its pure script mod.
Only vanilla record edit in the plugin is a condition on sprint animation start tree
and Encumbered message modification in Game Settings. (Empty string to disable the constant popup.)

Specific Incompatible Mods:
Statistics and Leveling Re-Vamped


==============================
    SUPPORTED CUSTOM RACES
==============================
NONE AT THE MOMENT
When using custom race that arent supported, there is a work around in the MCM config menu.
A list of presets from all supported vanilla Races.


====================
    REQUIREMENTS
====================
Latest version of Skyrim
Latest version of SKSE
Latest version of SkyUI


================
    UPDATING
================
Make a clean save before updating.

For those that after 4 years of Skyrim modding still dont know what that means. xD
Uninstall the mod (refer to the uninstall section);
Make a new save with mod uninstalled;
Install the new version (refer to install section);
Enable the mod & DONE. ^^


====================
    INSTALLATION
====================
Install like any other mod.
Copy to data folder if manual or install with preferred mod manager.
Enable mod/plugin & enjoy! ^^


======================
    UNINSTALLATION
======================
Uninstall the mods scripts from within the MCM menu.
Wait for the mod to uninstall. You will be notified.
Delete files in the data folder (refer to file section) if manual or uninstall the usual way with mod manager.


=============
    FILES
=============
E-Motion.esp
E-Motion readme.txt
Scripts\
theimmersionEMotionHandler.pex
theimmersionEMotionCalculation.pex
theimmersionEMotionMCM.pex
theimmersionEMotionAlias.pex
Scripts\Source\
theimmersionEMotionHandler.psc
theimmersionEMotionCalculation.psc
theimmersionEMotionMCM.psc
theimmersionEMotionAlias.psc


===============
    CREDITS
===============
ME :P

Who ever had that idea of something called internet. BTW I HATE YOU!
I could have a girl and loose my vi- lets not get into too much details now.
Instead im here infront of this monitor. All d*mn day long.
JUST KIDDING EVERYONE! xD

AAAND A BIG FAT THANKS TO:
lofgren & Arocide
They helped me a lot and cured/prevented lots of headaches. Thnx guys! :D

And ofc thnx to:
Beth for the games, duh.
SKSE team.
Tool makers! <3
like plugins for modeling softwears and notepad pluguin creators, ModOrganizer, TES5Edit, BSA browser, etc.
Best free editor eva! Notepad++ <3
Firefox for browsing the h*ll out of google to figure out the scripting.
Google.
Cipcis, i mean, do i need to tell why?
Gopher and his tutorial videos for utility.
All those guys on YouTube with modeling tutorials. Like NightasyTutorials.
Mod Authors like: USKP, SkyUI, and all the others and so many good mods.
Like Halo from HaloFarm. Cool guy and very open. I like him. :D
HDT author, FlyingMod author and so many many more.
Nexus for everything else in modding!
All the other sites for modding too.
And the people & community on all the sites and threads and pages for helping out others in many various ways.
And last but not least, any other mod makers and users.
If i start listing everything and everyone, its gonna bring down all the nexus servers. xD

Holly s*it, the credits are almost as big as the description and even thats too big. o.O


======================================================
    DISCLAIMER, PERMISSIONS AND OTHER LEGAL THINGS
======================================================
(the usual stuff xD)

This mod is provided as is.
I am not responsible for any and all damages that may arise from using this mod. Use at your own risk.

[You are not allowed to:]
[Modify and use any part of the mod or script code in your own mod without explicit permission from me.]
[Upload to any other site without explicit permission from me.]


===========
    LOG
===========
Alpha Build
v0.0
Movement ramping by movement type. (walk,run,sprint,sneak etc) cliff OP xD
v0.0.1
Run emulation when overencumbered.
v0.0.2
Fast walk speed type added.
v0.0.3
fixed run emulation issues and added one more speed on sprint key.
v0.0.4
Super jump added.

Public Alpha Build
v0.1a
RECODED FROM SCRATCH
Base speed sets by Race. [new] (Initial code block)
(Only the base code block was added but than, later down the development route, got help from Arocide and finally finished the code block.)
Movement ramping by movement type. (walk,run,sprint,sneak etc) [copied]
Fast walk speed type. [partially copied/recoded to include weight and base race speed sets]
Sneak speed set with reductions added. [new]
Super jump added. [copied]
Weight calculations added. [new]
Run emulation when overencumbered redone to include base race trait speed sets and weight/stamina. [recoded]
All movement speeds by weight and race. [new]
Stamina drain when running by weight and race. [recoded]
Weight calculations modified multiple times through out development as new movement types were added to the formula. [modified]
(The original code just damaged the stamina but it was regenerating faster than it was damaged. Until lofgren landed a hand.)
(Pesky magic effects -.-)
TGM switch added as debug counter when cheating (using TGM/GodMode). [new]
Slow (casual) movement type speed set added. [new]
Slow (casual) movement type speed set changed to casual/super speed set. [modified]
Jump height by race stamina and weight added. [new]
Stamina drain when jumping by weight and race added. [new]
KnockDown Added. [new]
Swimming speed added to manipulated speeds. [new]
Stamina drain when swimming added. [new]
Base speed sets by Race. [modified] (final finished fully functional code block)
Fall damage by race and weight added. [new]
MCM support added. [new]

v0.2a
RECODED FROM SCRATCH YET AGAIN xD
Made it even more complex. (might fall back to v0.1a and make a hybrid cuz s*it got complicated. xD)
Will try to get the best of both worlds.
Speed Mult and stamina drain calculations for each action properly separated (walk,run,jump,swim).
All speeds and stamina drain are now affected by-
-race, low stamina, low health and carry weight (under/over capacity limit).
And in an even more complex manner. xD
More configuration toggles added in the MCM config menu.
This should help with compatibility and custom feature selection.
Lowerd one of the movement ramp downs. It was my idea! Dont go in posts and DONT READ THE STICKY! xD
v0.3a
Almost all features can be manipulated now from within MCM menu.