FistsFollowLookLethalHands

Compatibility patch for LethalHands + LethalEmotesAPI that restores natural look-follow behavior while squared up.

This mod makes first‑person arms follow your camera pitch (without twist), adds camera‑relative height/forward offsets, and optionally replicates look pitch so other players see a natural upper‑body aim in third person.

✨ Features

First‑person (local player)

• Arms follow camera pitch while squared up
• No arm twisting (parent‑space rotation)
• Camera height follow (arms move up/down with view height)
• Auto forward push when looking up
• Tunable per‑bone weights:
  • Upper arm
  • Forearm
  • Hand / wrist

Third‑person (other players)

• Optional pitch replication over netcode
• Spine / Chest / UpperChest blend for natural upper‑body aiming
• Smooth interpolation (no snapping)
• Only active while the player is squared up

Quality of life

• Config reset hotkey (Input System binding)
• Built‑in safe clamps to avoid broken configs
• Logs when the patch becomes active/inactive

📦 Dependencies

This is a compatibility patch and requires:

• BepInEx (required)
• LethalHands
• LethalEmotesAPI

Note: Some Thunderstore package IDs change over time.
If dependency strings fail validation, keep only BepInEx in manifest.json and install LethalHands + LethalEmotesAPI manually.

⚙️ Default tuning (baked settings)

These are the defaults shipped with the mod (tuned for a natural “hands forward when looking up” feel):

• MaxPitchDegrees = 160
• DefaultArmHeight = 0.10
• DefaultArmForward = 0.05
• AutoForwardMaxOffset = 0.20
• AutoForwardStrength = 2.0
• AutoForwardStartDegrees = 0
• AutoForwardCurvePower = 1.5

You can change everything in:

BepInEx/config/BloodDraco.LethalHandsHandsFollowPatch.cfg

🎮 Controls

Reset config to defaults

Default binding:

<Keyboard>/f8

You can change the binding in the config file:

[Controls]
ResetConfigBinding = <Keyboard>/f8

🧠 How it works (short version)

First‑person

The mod patches EmoteConstraint.ActUponConstraints() and temporarily offsets the emote rig before constraints are applied, then restores it immediately after.

This means:

• animations stay intact
• no permanent rig mutation
• stable with emote updates

Third‑person

Local camera pitch is sent at a throttled rate while squared up.

Remote clients:

• read replicated pitch
• apply additive rotation to:
  • Spine
  • Chest
  • UpperChest

This matches how many FPS games handle upper‑body aiming.

🔧 Recommended settings

If you want a more vanilla feel:

ThirdPersonMaxUpDegrees = 45
ThirdPersonStrength = 1.0
SpineWeight = 0.20
ChestWeight = 0.35
UpperChestWeight = 0.45

If you want stronger “reach forward”:

AutoForwardMaxOffset = 0.20
AutoForwardStrength = 2.0

🧪 Troubleshooting

Arms don’t move

• Make sure LethalHands is installed and working
• Confirm you are squared up
• Check [General] Enabled = true

Other players don’t see it

• Enable:
  • [Replication] EnableThirdPersonReplication = true
  • [ThirdPerson] EnableThirdPersonSpineBlend = true
• Host and clients must all have the mod

Arms look too high or too far forward

Lower:

• DefaultArmHeight
• DefaultArmForward
• AutoForwardMaxOffset

🧾 Changelog

v2.3.0

• Added third‑person pitch replication
• Added spine/chest/upper‑chest blend for remote players
• Added replication settings
• Improved smoothing and stability

v2.2.0

• Baked tuned defaults into config
• Added safe config clamping

v2.1.x

• Auto forward look‑up system
• Camera height follow
• Reset config hotkey

❤️ Credits

• LethalHands by SlapitNow
• LethalEmotesAPI contributors
• Compatibility patch by BloodDraco