Pushing (ESPless)

Pushing (ESPless)

Description:

Push NPCs around in the wasteland! A simple and configurable pushing system that lets you physically move other characters by activating the grab key while targeting them.

By default, 2 failed pushes or 3 successful ones on the same NPC will result in combat! This can be turned off entirely though, and teammates can safely be ignored.

Features:

1. Push NPCs: Use the grab key (default) or configure a custom key to push people around
2. Strength-Based System: Success depends on your Strength vs target's Strength
3. AP Cost System: Pushing costs Action Points based on strength difference (4-40 AP)
4. Combat Awareness: Configurable - NPCs in combat may be too alert to push
5. Pushback Chance: Failed pushes may result in the NPC pushing you back
6. Warning System: NPCs warn you before attacking after repeated failed pushes
7. Camera Shake: Visual feedback when pushes fail due to strength difference
8. Distance Limits: Maximum push distance to prevent abuse
9. Smart Blocking: Cannot push while grabbing items or when insufficient AP
10. Buffout: doubles your push force for extra dramatic effect (value configurable or can be turned off entirely)
11. Power Armor Mechanics: Power armor wearers get configurable strength override for both pushing and resistance
12. Follower Bypass: Option to ignore strength checks when pushing current companions/teammates
13. Unarmed Skill Scaling: Push force can scale with Unarmed skill (1x to 3x multiplier, configurable)
14. Observer Reactions: NPCs in the area react to successful pushes with contextual dialogue

How It Works:

1. Target an NPC and press the grab key (default Z or R3) to attempt a push
2. Success is determined by comparing your Strength to theirs
3. Successful pushes move the target away from you
4. Failed pushes may result in warnings, pushback, or eventually combat
5. All costs AP and respects various safety checks
6. By default enemies in combat cannot be targeted.

Configuration Options:

Edit Config/Pushing.ini to customise:

1. iKey: Key binding (0 = grab key, or specify key code)
2. iForce: Push force strength
3. bAllowCombatPush: Allow pushing NPCs in combat
4. iPushBackChance: Percentage chance failed pushes result in pushback
5. iMaxWarnings: Number of warnings before NPCs attack
6. bAttackAfterWarnings: Whether NPCs attack after max warnings
7. iMaxPushDistance: Maximum distance to attempt pushes
8. bAPDrain: Enable/disable AP costs
9. bBlockPushWithoutAP: Prevent pushing without sufficient AP
10. bCameraShakeOnFailedPush: Camera shake on failed pushes
11. bSneakingBonus: Enable/disable stealth push bypass
12. bBuffoutBonus: Enable/disable Buffout push force bonus
13. fBuffoutMultiplier: Force multiplier when on Buffout (default: 2)
14. bPowerArmorStrengthOverride: Enable power armor strength bonus for pushing
15. iPowerArmorStrength: Effective strength when wearing power armor (default: 10)
16. bIgnoreFollowerStrength: Bypass strength checks when pushing companions
17. bPowerArmorResistance: Power armor wearers get stronger when being pushed
18. bUnarmedScaling: Enable push force scaling with Unarmed skill
19. fUnarmedScalingBase/Max: Unarmed scaling multiplier range (default: 1.0 to 3.0)
20. bObserverReactions: Enable NPC observer reactions to successful pushes

Credits & Inspiration:

This mod was inspired by GetOutTheWay and recreates its functionality as an ESPless alternative with additional features and full configurability. Thanks djhert I endorsed that mod and commented on it ages ago! But we needed MORE!

Compatibility:

ESPless implementation should work with all modded NPCs and locations. Uses event handlers to detect key presses and NVSE functions for all interactions.

NOTE: if you use the Oliver Swanick Companion Mod, then disable its pushing feature via the ini. In the next update I am going to remove it in favour of this mod (Oliver will still comment on pushes of course, just via a different method).

Technical Details:

Uses OnKeyDown/OnControlDown event handlers to detect push attempts, then performs strength calculations, AP costs, and various safety checks before executing pushes via PushActorAway function.