[MODDED EXES] Ledge Grabbing / Mantling (UPDATE 4.4) addon

MODDED EXES ARE REQUIRED, GET THEM THERE: Github.com

This mod will allow player to mantle walls and vault over obstacles.

By holding jump and looking at the edge to climb, the actor will proceed to climb the wall. The animation speed will depend on various conditions such as current actor weight and stamina. The full speed will be achieved with less than half of max weight and full stamina.

Climbing the wall will drain stamina and hunger, the more you have weight - the stronger the drain will be.

The system was designed to adapt to most climbing scenarios, such as walls, ledges, platforms, etc. However there might be animation bugs or actor climbing to places he shouldnt do, so you have to cope with that, nothing is perfect. Not every wall will be climbable where the destination is too steep such as rooftops, i'll try to address it in next updates based on a feedback.

MCM options contain settings to adjust the mod to your likings such as jump time, distance, sound volumes, etc.

TROUBLESHOOTING:

• In case of conflicts with other mods, move this mod below any other mods and you will be okay
• If you save while crouching, on the next load the hand position while ledge grabbing will be wrong. Will be fixed in next update

CREDITS:

• Parazit: Great Hands and Camera animations
• Strelok: Outstanding Outfit and Grunting sounds

SUPPORT:

You can support me by donating via Boosty, i will appreciate your help :)
Boosty.to

CHANGELOG:

UPDATE 4.4:

• Added optional unstuck check (enabled by default). If script has found that you became stuck, it will try to push you upwards once to correct place
• Extended time for fixing the damage issue when performing climbing

UPDATE 4.3:

• Fixed the bug when camera blinks for 1 frame in wrong direction at the start of climb animation

UPDATE 4.2:

• Fixed the issue when player was damaged when performing climbing

UPDATE 4.1:

• Fixed crash LUA error: .../bin/..\gamedata\scripts\demonized_ledge_grabbing.script:420: attempt to index local 'health' (a nil value)

UPDATE 4:

• Added simple player bounds check to improve behaviour on small ledges
• Small optimizations of the script to reduce ray casts amount
• Added MCM configurable delay between checks for grabbing to improve performance, default is no delay
• Added Body Health System integration, if one of your arms is broken, the climbing will be disabled, toggleable in MCM
• Added Hardcore Mode, toggleable in MCM, default is disabled:
  • You cannot climb any obstacles if your max weight is greater than 90kg
  • You cannot climb any obstacles if your health is less than 60%
  • Increased stamina consumption

UPDATE 3.2:

• Fix of disabling climbing mod when "S.k.I.n - Skinning Improvement" mod is used by StronGV
• Ledge grabbing accuracy MCM setting can be reduced to 5
• Increased distance for raycast check for player height to address some issues with climbing into tight spaces

UPDATE 3.1:

• Fixed issue when climbing stops working after FDDA skinning animation

UPDATE 3:

• New method of raycast, maximum height will be dependant on players line of sight. In theory this can help increase accuracy in cases where there are multiple platforms above one another, can be toggled in MCM via "alternative climb detection" check.
• Improved collision detection to address issue on climbing inside windows
• New input methods for climbing available. You can now toggle in MCM between holding jump, key press with configurable key or both methods at the same time
• Animation randomization, your climbs will never be the same. each climb will have very slight alterations in speed and camera movement, this can be adjusted in MCM as well
• Stamina consumption very slightly increased
• Wearing heavy armor or exoskeleton will reduce climb speed
• Added material check so now it wont be possible to climb on bushes or other strange materials

UPDATE 2:

• Fine-tuned hands position, now it looks a bit better
  
  
  
  
• Fixed a bug where camera will behave differently depending on a direction player faced before the climb
• Now you won't be able to climb if FDDA animation is being played
• Lowered stamina consumption
• Added stamina drain modifier in MCM menu
• Fixed missing "Enable" text for Russian language in MCM, thanks leevithan

UPDATE 1:

• Fixed the missing cursor issue